Mirrors/api-guidelines
1
0
Fork 0
mirror of https://github.com/adidas/api-guidelines.git synced 2025-10-25 15:19:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updates execution/query-requests-with-large-inputs.md

Browse Source 
Auto commit by GitBook Editor
This commit is contained in:
apidesigner
2017-02-24 07:56:51 +00:00
parent 2d8d5630a1
commit 869ab8c06a
2 changed files with 20 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
execution/query-requests-with-large-inputs.md Normal file
View File

@@ -0,0 +1,19 @@
# Query Requests with Large Inputs
While HTTP doesn't impose any limit on the length of an URI some implementation of server or client might have difficulties handling long URIs (usually URIs with many or large query parameters).
Every endpoint with such an URI **MUST** use the HTTP **POST** Request Method and send the query string in HTTP Request Message body using the `application/x-www-form-urlencoded` media type.
_NOTE: Since this operation is safe and idempotent, using the POST method is a misuse of HTTP’s uniform interface. A consequence of this implementation is a loss of cache-ability.
#### Example
```
POST /orders HTTP/1.1
Content-Type: application/x-www-form-urlencoded
search=attributes&color=white&size=56&...
```
> _NOTE: Since this operation is safe and idempotent, using the POST method violates the HTTP Protocol semantics and results in loss of cache-ability._