 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 |
|