API Reference

API доступно по адресу https://api.nurcore.kg.

Auth: один заголовок X-API-Key: pk_… | sk_…. Тип ключа (publishable / secret) и client_type (consumer_app / agency / kiosk) определяются автоматически по самому ключу — слать дополнительно X-Client-Id / X-Client-Type не нужно (gateway всё равно их перезапишет). См. Authentication.
Content-Type: application/json (UTF-8) для всех мутирующих запросов
Errors: {detail: string | object} с HTTP status code
Pagination: ?page=1&page_size=50 → {data, total, page, page_size, has_next, has_prev}
Sorting: ?sort_by=created_at&order=desc
Filtering: query params per resource (см. detail pages)
Idempotency: мутирующие запросы (POST/PUT/PATCH) могут идти с Idempotency-Key: <unique-string> — TTL 24h. См. Idempotency.

Стандартные заголовки ответа

Header	Описание
`x-request-id`	UUID запроса (приложите к bug-репорту)
`x-ratelimit-remaining`	Запросов осталось в окне
`x-ratelimit-reset`	Unix timestamp следующего окна
`Sunset`	Если endpoint deprecated — дата отключения

Код	Значение
200, 201, 204	Успех
400	Bad Request — нарушение бизнес-правил
401	Unauthorized — нет или невалидный API Key
403	Forbidden — нет прав на ресурс
404	Not Found
409	Conflict — race condition (например, места заняты)
410	Gone — broня истекла (15 минут на оплату прошли)
422	Unprocessable Entity — валидация payload
429	Too Many Requests — rate limit
5xx	Server error — повторите позже

См. Error handling для подробностей.