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

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
2 changed files with 9 additions and 5 deletions
+2 -1
View File
@@ -47,7 +47,8 @@ Scopes: `PUBLIC` (anon ok) · `INTERNAL` (auth) · `RESTRICTED` (admin).
```
?as_scope=PUBLIC,INTERNAL (required) CSV scope filter
?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)
?polygon=<GeoJSON> geo: polygon-фильтр
```
+7 -4
View File
@@ -197,10 +197,13 @@ curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC"
### 4.3 Фильтры
```bash
# Locale — для x-localized полей сервер вернёт только указанную локаль
curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC&locale=en-US"
# или через стандартный header:
curl -H "Accept-Language: en-US" "$ORDINIS/api/v1/spacecraft/records?as_scope=PUBLIC"
# Locale — для x-localized полей (name, mission, operator etc).
# ⚠️ Сейчас работает ТОЛЬКО через Accept-Language header. ?locale= query
# param backend игнорирует — TODO в roadmap.
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)
curl "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC&at=2026-01-01T00:00:00Z"