ivan-igorevich/mdm-ordinis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'docs/locale-header-only' into 'main'

Browse Source 
docs(api): локализация — только Accept-Language header

See merge request 2-6/2-6-4/terravault/ordinis!244
This commit is contained in:
Александр Зимин
2026-05-20 08:41:05 +00:00
parent c1f87d638e 11b6ca9835
commit b13b11eaae
2 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/integration/api-cheatsheet.md
+2 -1
View File
@@ -47,7 +47,8 @@ Scopes: `PUBLIC` (anon ok) · `INTERNAL` (auth) · `RESTRICTED` (admin).
``` ```
?as_scope=PUBLIC,INTERNAL (required) CSV scope filter ?as_scope=PUBLIC,INTERNAL (required) CSV scope filter
?at=2026-03-15T00:00:00Z bitemporal: запись на конкретный момент (validFrom <= at < validTo) ?at=2026-03-15T00:00:00Z bitemporal: запись на конкретный момент (validFrom <= at < validTo)
?locale=en-US локаль (или Accept-Language header) Accept-Language: en-US (header) локаль — единственный рабочий путь
⚠️ ?locale= query param backend сейчас игнорирует
?bbox=lon1,lat1,lon2,lat2 geo: bounding box (для geo-dicts) ?bbox=lon1,lat1,lon2,lat2 geo: bounding box (для geo-dicts)
?polygon=<GeoJSON> geo: polygon-фильтр ?polygon=<GeoJSON> geo: polygon-фильтр
``` ```
docs/integration/api-quickstart.md
+7 -4
View File
@@ -197,10 +197,13 @@ curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC"
### 4.3 Фильтры ### 4.3 Фильтры
```bash ```bash
# Locale — для x-localized полей сервер вернёт только указанную локаль # Locale — для x-localized полей (name, mission, operator etc).
curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC&locale=en-US" # ⚠️ Сейчас работает ТОЛЬКО через Accept-Language header. ?locale= query
# или через стандартный header: # param backend игнорирует — TODO в roadmap.
curl -H "Accept-Language: en-US" "$ORDINIS/api/v1/spacecraft/records?as_scope=PUBLIC" curl -H "Accept-Language: en-US" \
"$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC"
# default ru-RU: "mission": "Глобальный мониторинг суши и атмосферы"
# с Accept-Language en-US: "mission": "Global land and atmosphere monitoring"
# Time-travel: состояние на конкретный момент (validFrom <= at < validTo) # Time-travel: состояние на конкретный момент (validFrom <= at < validTo)
curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC&at=2026-01-01T00:00:00Z" curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC&at=2026-01-01T00:00:00Z"