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/localization.md

Browse Source 
Auto commit by GitBook Editor
This commit is contained in:
apidesigner
2017-06-16 13:43:10 +00:00
parent 81110f2dd4
commit 6fbf10fd03
1 changed files with 18 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
execution/localization.md
View File

@@ -1,7 +1,7 @@
# Localization
## Language Variants
If a resource has multiple language variants and the difference between variantsis only in the language of human readable fields then the [`Accept-Language`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language) request HTTP header **SHOULD** be used to communicate the desired language variant.
If a resource has multiple language variants and the difference between variants is only in the language of human readable fields then the [`Accept-Language`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language) request HTTP header **SHOULD** be used to select the desired language variant.
#### Example
@@ -20,3 +20,19 @@ Vary: Accept-Language
```
## Language or Country-specific Data Structure
If the difference between language or country specific variants of a resource is bigger than just in the content of a human readable strings, for example the data structure of the resource representation is different, then a query parameter **SHOULD** be used to communicate the requested variant.
#### Example
```
GET /article?market=en_US HTTP/1.1
```
```
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Language: en
Vary: Accept-Language
...
```