mdm-ordinis

ivan-igorevich/mdm-ordinis

Fork 0

Commit Graph

Author	SHA1	Message	Date
Zimin A.N.	11b6ca9835	docs(api): локализация — только Accept-Language header (не ?locale= query) После testing на staging выявлено: backend парсит локаль ТОЛЬКО из Accept-Language header. ?locale=en-US query param сейчас игнорируется (сервер возвращает default ru-RU вне зависимости от значения). Реальный demo (spacecraft/1999-068A): default (без header): operator: "НАСА" Accept-Language: en-US: operator: "NASA" ?locale=en-US (без header): operator: "НАСА" ← не работает Cheatsheet + quickstart обновлены. Postman collection тоже (используется header). ?locale= query — отдельный backend feature request в roadmap.	2026-05-20 11:40:19 +03:00
Zimin A.N.	ae05e17f96	docs(api): cheatsheet + quickstart sync с реальным API после Postman audit Audit Postman collection выявил расхождения docs ↔ runtime — фикс: Topology clarification: - Records (consumer) — БЕЗ /dictionaries/ префикса: /api/v1/{name}/records - History/cascade-preview/changelog/drafts — С /dictionaries/ (writer audit) - export-selected.csv — POST, не GET Query params (records list, /{name}/records): - ✅ as_scope (required, CSV) — было документировано как ?scope= (неверно) - ✅ at (ISO timestamp) — было ?asOf= (неверно) - ✅ locale + Accept-Language header - ✅ bbox / polygon (geo) - ❌ убраны: ?limit, ?offset (pagination отсутствует), ?status/?country (нет ad-hoc filtering по schema полям) Snapshots params: - ✅ from / to / granularity (hour/day/week) — было ?asOf= (неверно) Base URLs: - prod: ordinis.nstart.cloud (public LE-cert) - staging: ordinis.k8s.265.nstart.cloud (Swagger UI здесь) - было: ordinis.k8s.264.nstart.cloud (устаревший internal, prod переехал) Version: v2.36 → v2.37.x. Refs MR !242 (snapshots backend fix), Postman collection в ~/Desktop/Ordinis-Postman/.	2026-05-19 23:15:40 +03:00
Александр Зимин	04e8251941	docs(api): Quick Start guide + Cheat Sheet для интеграторов	2026-05-17 13:14:33 +00:00

Author

SHA1

Message

Date

Zimin A.N.

11b6ca9835

docs(api): локализация — только Accept-Language header (не ?locale= query)

После testing на staging выявлено: backend парсит локаль ТОЛЬКО из
Accept-Language header. ?locale=en-US query param сейчас игнорируется
(сервер возвращает default ru-RU вне зависимости от значения).

Реальный demo (spacecraft/1999-068A):
  default (без header):           operator: "НАСА"
  Accept-Language: en-US:         operator: "NASA"
  ?locale=en-US (без header):     operator: "НАСА"  ← не работает

Cheatsheet + quickstart обновлены. Postman collection тоже (используется
header). ?locale= query — отдельный backend feature request в roadmap.

2026-05-20 11:40:19 +03:00

Zimin A.N.

ae05e17f96

docs(api): cheatsheet + quickstart sync с реальным API после Postman audit

Audit Postman collection выявил расхождения docs ↔ runtime — фикс:

Topology clarification:
- Records (consumer) — БЕЗ /dictionaries/ префикса: /api/v1/{name}/records
- History/cascade-preview/changelog/drafts — С /dictionaries/ (writer audit)
- export-selected.csv — POST, не GET

Query params (records list, /{name}/records):
- ✅ as_scope (required, CSV) — было документировано как ?scope= (неверно)
- ✅ at (ISO timestamp) — было ?asOf= (неверно)
- ✅ locale + Accept-Language header
- ✅ bbox / polygon (geo)
- ❌ убраны: ?limit, ?offset (pagination отсутствует),
            ?status/?country (нет ad-hoc filtering по schema полям)

Snapshots params:
- ✅ from / to / granularity (hour/day/week) — было ?asOf= (неверно)

Base URLs:
- prod: ordinis.nstart.cloud (public LE-cert)
- staging: ordinis.k8s.265.nstart.cloud (Swagger UI здесь)
- было: ordinis.k8s.264.nstart.cloud (устаревший internal, prod переехал)

Version: v2.36 → v2.37.x.

Refs MR !242 (snapshots backend fix), Postman collection в
~/Desktop/Ordinis-Postman/.

2026-05-19 23:15:40 +03:00

Александр Зимин

04e8251941

docs(api): Quick Start guide + Cheat Sheet для интеграторов

2026-05-17 13:14:33 +00:00

3 Commits