From ee4f4959732272cba310421924d96705b87b62c1 Mon Sep 17 00:00:00 2001 From: "Zimin A.N." Date: Wed, 20 May 2026 11:46:41 +0300 Subject: [PATCH] =?UTF-8?q?docs(api):=20=D1=83=D1=82=D0=BE=D1=87=D0=BD?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B5=20=E2=80=94=20locale=20=D1=80=D0=B0?= =?UTF-8?q?=D0=B1=D0=BE=D1=82=D0=B0=D0=B5=D1=82=20=D1=82=D0=BE=D0=BB=D1=8C?= =?UTF-8?q?=D0=BA=D0=BE=20=D0=BD=D0=B0=20records,=20=D0=BD=D0=B5=20=D0=BD?= =?UTF-8?q?=D0=B0=20schema?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Tested: GET /dictionaries/spacecraft с Accept-Language: en-US возвращает schemaJson с descriptions на ru (defaultLocale). Header игнорируется на этом endpoint. Локализация (Accept-Language header) работает только на records-side (read-api DictionaryReadController). DictionaryDefinitionController (writer/ordinis-app) возвращает schema без locale negotiation. Cheatsheet обновлён, добавлен warning в query-params секцию. --- docs/integration/api-cheatsheet.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/integration/api-cheatsheet.md b/docs/integration/api-cheatsheet.md index 2c6373d..c019b10 100644 --- a/docs/integration/api-cheatsheet.md +++ b/docs/integration/api-cheatsheet.md @@ -49,6 +49,9 @@ Scopes: `PUBLIC` (anon ok) · `INTERNAL` (auth) · `RESTRICTED` (admin). ?at=2026-03-15T00:00:00Z bitemporal: запись на конкретный момент (validFrom <= at < validTo) Accept-Language: en-US (header) локаль — единственный рабочий путь ⚠️ ?locale= query param backend сейчас игнорирует + ⚠️ Работает ТОЛЬКО на records endpoints. + Schema endpoint (`/dictionaries/{name}`) всегда + возвращает schemaJson на defaultLocale. ?bbox=lon1,lat1,lon2,lat2 geo: bounding box (для geo-dicts) ?polygon= geo: polygon-фильтр ```