diff --git a/docs/integration/api-cheatsheet.md b/docs/integration/api-cheatsheet.md
index ccad079..2c6373d 100644
--- a/docs/integration/api-cheatsheet.md
+++ b/docs/integration/api-cheatsheet.md
@@ -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-фильтр
 ```
diff --git a/docs/integration/api-quickstart.md b/docs/integration/api-quickstart.md
index 1b33243..14df136 100644
--- a/docs/integration/api-quickstart.md
+++ b/docs/integration/api-quickstart.md
@@ -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"