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:
@@ -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-фильтр
|
||||
```
|
||||
|
||||
@@ -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"
|
||||
|
||||
Reference in New Issue
Block a user