API лавлах

Бүх REST endpoint нэг хуудсанд. Суурь зам: /api/v1 (OIDC ба relay гадаргуунаас бусад нь). Swagger UI: /swagger/ — production дээр OBSERVABILITY_TOKEN-оор хаагдана.

Хариултын хэлбэр

{ "status": true, "message": "success", "data": { … } }

Алдаа:

{ "status": false, "message": "…", "error": "…" }

Usecase-ууд apperror.* буцаана; түүнийг HTTP статус руу буулгана. Дотоод шалтгаан клиентэд хүрэхгүй.

Танилт — /v1/auth

Метод	Зам	Эрх	Юу
POST	/eid/start	нээлттэй	QR + deep-link session
POST	/eid/start-id	нээлттэй	РД-аар push
POST	/eid/poll	нээлттэй	Long-poll (~60/мин)
GET	/status/{sid}	нээлттэй	Session төлөв
POST	/google	нээлттэй	Google code exchange
DELETE	/google/link	нэвтэрсэн	Google холбоос салгах
POST	/refresh	нээлттэй	Токен сэлгэх
POST	/logout	нэвтэрсэн	Session хаах
POST	/initiate	нээлттэй	Урсгал эхлүүлэх

Rate limit ~5/мин, body cap 4 KiB.

Super admin onboarding — /v1/auth/superadmin

Метод	Зам	Юу
POST	/mfa	MFA шалгах
POST	/onboard/google	Google баталгаажуулалт
POST	/onboard/eid/start · /start-id · /poll	eID баталгаажуулалт
POST	/onboard/email/send · /verify	И-мэйл OTP
POST	/onboard/totp/init · /verify	TOTP + сэргээх код

Хэрэглэгч ба профайл

Метод	Зам	Эрх	Юу
GET	/v1/users/me	нэвтэрсэн	Миний профайл
GET	/v1/rbac/me	нэвтэрсэн	Миний role + эрхүүд

Асет — /v1/me

Метод	Зам	Юу
GET · PUT · DELETE	/signature	Гарын үсгийн зураг
PUT	/latin-name	Латин нэр
GET · PUT · DELETE	/orgstamp/{regNo}	Байгууллагын тамга
PUT	/org-name-latin/{regNo}	Байгууллагын латин нэр

eID профайл — /v1/users/me/eid

Метод	Зам	Юу
GET	/summary · /certificates · /devices · /activity	PKI самбар
GET · POST	/organizations	Холбоотой байгууллага
DELETE	/organizations/{regNo}	Холбоос салгах
GET · POST · DELETE	/organizations/{regNo}/signers	Эрх бүхий зурагчид
POST	/organizations/{regNo}/signers/resend	Урилга дахин илгээх

RBAC — /v1/rbac

Метод	Зам	Эрх
GET	/roles · /permissions	roles.manage
POST	/roles	roles.manage
PUT	/roles/{id} · /roles/{id}/permissions	roles.manage
DELETE	/roles/{id}	roles.manage

Байгууллага — /v1/org

Метод	Зам	Юу
GET · POST	/	Жагсаах / үүсгэх
GET	/lookup/{regNo}	Улсын бүртгэлээс лавлах
GET	/{id}	Дэлгэрэнгүй
GET · POST	/{id}/members	Гишүүд
PUT · DELETE	/{id}/members/{userID}	Эрх / хасах

Төрийн үйлчилгээ — /v1/gov

Метод	Зам	Эрх	Юу
GET	/services · /life-events · /overview	нэвтэрсэн	Каталог, тойм
GET · POST	/applications	нэвтэрсэн	Миний хүсэлтүүд
GET	/applications/{id}/timeline	нэвтэрсэн	Түүх
POST	/applications/{id}/provide-info · /cancel	нэвтэрсэн	Баримт / буцаах
GET · POST	/references	нэвтэрсэн	Лавлагаа
GET	/notifications	нэвтэрсэн	Мэдэгдэл
POST	/notifications/{id}/read · /read-all	нэвтэрсэн	Уншсанд тооцох
GET	/payments	нэвтэрсэн	Төлбөр
POST	/payments/{id}/pay	нэвтэрсэн	Төлөх
GET · POST	/appointments	нэвтэрсэн	Цаг захиалга
POST	/appointments/{id}/cancel	нэвтэрсэн	Цуцлах

Албан хаагч — /v1/gov/officer

Метод	Зам	Эрх
GET	/stats · /queue · /queue/{id}	gov.review
POST	/queue/{id}/assign · /decide · /complete · /request-info	gov.review

Каталог — /v1/catalog

Метод	Зам	Юу
GET	/services · /services/{id}	Нийтлэгдсэн үйлчилгээ
GET	/life-events	Амьдралын үйл явдал

Регистр — /v1/registry

Метод	Зам	Эрх
GET	/overview · /catalog · /once-only	registry.view
GET	/services · /services/{id} · /{id}/versions · /{id}/once-only	registry.view
GET	/evidences · /life-events	registry.view
POST · PUT · DELETE	/services[/{id}]	registry.manage
POST	/services/{id}/publish · /archive	registry.manage
PUT	/services/{id}/evidences	registry.manage
POST · PUT · DELETE	/evidences[/{id}]	registry.manage
POST · DELETE	/life-events[/{id}]	registry.manage

Relay — /v1/relay

Метод	Зам	Эрх
GET	/overview · /requests · /requests/{id}	relay.view
POST	/requests · /requests/{id}/forward	relay.manage
POST	/assignments/{id}/respond	relay.manage
GET · POST · DELETE	/platforms[/{id}]	relay.manage
GET · POST · DELETE	/routes[/{id}]	relay.manage
POST	/v1/relay/webhook	webhook гарын үсэг

API Gateway — /v1/gateway

Метод	Зам	Эрх
GET	/overview · /logs	gateway.manage
GET · POST	/services	gateway.manage
PUT · DELETE	/services/{id}	gateway.manage

Applications — /v1/applications

Метод	Зам	Эрх
GET · POST	/	gateway.manage
GET · PUT · DELETE	/{id}	gateway.manage
POST	/{id}/rotate-secret	gateway.manage
PUT	/{id}/secret · /{id}/services	gateway.manage

eID proxy — /v1/eid, /v1/eid-org

Метод	Зам	Шалгалт
GET	/v1/eid/summary · /certificates · /devices · /activity	svc:eid-proxy scope
GET	/v1/eid-org/organizations · /organizations/{regNo}/signers	svc:eid-org-proxy scope

Гарын үсэг — /v1/sign

Метод	Зам	Юу
POST	/init	PDF-ээс session
POST	/initiate	Digest-ээс session
GET	/status/{sid}	Төлөв
GET	/{id} · /{id}/download	Мэдээлэл / татах

Интеграц ба хадгалалт

Метод	Зам	Юу
GET · POST	/v1/integrations	Холболтууд
GET	/v1/integrations/{provider}/token	Токен
DELETE	/v1/integrations/{provider}	Салгах
GET	/v1/gspace/ · /download	Файл жагсаах / татах
POST	/v1/gspace/upload	Байршуулах
DELETE	/v1/gspace/	Устгах

AI — /v1/ai, /v1/public/ai

Метод	Зам	Эрх
POST	/v1/ai/chat · /stt · /tts · /translate	нэвтэрсэн (~20/мин)
POST	/v1/public/ai/chat · /chat/stream · /tts	нээлттэй (~6/мин)

Админ — /v1/admin

Метод	Зам	Эрх
GET · POST	/users	users.manage
PUT	/users/{id}/role · /users/{id}/active	users.manage
DELETE	/users/{id}	users.manage
GET	/ai/prompts	settings.manage
PUT	/ai/prompts/{key}	settings.manage
POST	/ai/knowledge/reindex	settings.manage

Super admin — /v1/superadmin

Метод	Зам
GET · POST	/admins · /admins/by-register
PUT	/admins/{id}/grant
DELETE	/admins/{id}
GET · POST	/invites
DELETE	/invites/{email}
GET · PUT	/access-mode

Аудит, security, харагдац

Метод	Зам	Эрх
GET	/v1/audit/ · /verify	admin
GET	/v1/security/events	admin
POST	/v1/security/events	нэвтэрсэн
GET	/v1/site/appearance	нээлттэй
PUT	/v1/site/appearance	settings.manage
GET	/v1/themes/active · / · /{id}	нээлттэй / нэвтэрсэн
POST · PUT · DELETE	/v1/themes[/{id}]	settings.manage
PUT	/v1/themes/{id}/active	settings.manage
GET	/v1/core/users · /organizations	admin

SSO client — /v1/sso

Метод	Зам	Юу
POST	/start · /callback	Authorize → токен
POST	/native	Мобайл PKCE
POST	/logout	RP-initiated logout

OIDC provider (үндэс дээр)

Метод	Зам
GET	/.well-known/openid-configuration · /.well-known/jwks.json
GET	/oauth2/auth · /oauth2/sessions/logout
POST	/oauth2/token · /oauth2/introspect · /oauth2/revoke
GET · POST	/userinfo

Provider challenge — /v1/provider

Метод	Зам
GET	/login · /consent
POST	/login/accept · /login/reject
POST	/consent/accept · /consent/reject
POST	/logout/accept

Оператор ба relay гадаргуу

Зам	Баталгаажуулалт
/admin/api/v1/*	Admin API key (gsk_…) — loopback
/rp/sign/*	SIGN_RELAY_TOKEN

Ops

Зам	Юу	Production
/health	Liveness	нээлттэй
/metrics	Prometheus	bearer token
/swagger/*	Swagger UI + JSON	bearer token