НОРМОСКАН Документация
API v1Посмотреть состояние доступа

Посмотреть состояние доступа

Обновлено 8 октября 2026
GET/subscription

Сервер определяет даты и остаток проверок. null означает, что значение не определено.

Передайте ключ организации в заголовке Authorization: Bearer <ключ>.

Пример запроса

Используйте NK_BASE и NK_KEY из быстрого старта. Переменные в пути, например RUN_ID, замените значениями из ваших ответов API.

GET /subscription
curl --fail-with-body "$NK_BASE/subscription" \
  -H "Authorization: Bearer $NK_KEY"

Ответы и ошибки

200

Успешный ответ.

application/json

Поля ответа
plan_typeстрока · необязательное
Вид доступа. Значения: "abonement", "single", "none".
statusстрока · необязательное
Состояние доступа. Значения: "active", "expired", "unset".
checks_leftцелое число · необязательное
Остаток проверок.
days_leftцелое число / null · необязательное
Число оставшихся полных дней. null означает, что значение не определено.
ends_atстрока / null · необязательное
Окончание периода.
started_atстрока / null · необязательное
Начало периода.

401

Ключ не передан, неверен или отозван.

application/json

Поля ответа
detailобъект / массив: объект / строка · обязательное
Обычно объект с error. При ошибке проверки параметров возможен список нарушений.
Вложенные поля
errorстрока · обязательное
Машинный код ошибки. Используйте его в обработчике.
messageстрока · необязательное
Пояснение для человека. Текст может меняться.
fileстрока · необязательное
Проблемный файл, если ошибка относится к нему.

Массив элементов:

locмассив: строка / целое число · необязательное
Путь до неверного поля.
msgстрока · необязательное
Причина нарушения.
typeстрока · необязательное
Код нарушения.
inputобъект · необязательное
Переданное значение.

Текст ошибки, если сервер не вернул объект.

403

Доступ закрыт или действие не разрешено.

application/json

Поля ответа
detailобъект / массив: объект / строка · обязательное
Обычно объект с error. При ошибке проверки параметров возможен список нарушений.
Вложенные поля
errorстрока · обязательное
Машинный код ошибки. Используйте его в обработчике.
messageстрока · необязательное
Пояснение для человека. Текст может меняться.
fileстрока · необязательное
Проблемный файл, если ошибка относится к нему.

Массив элементов:

locмассив: строка / целое число · необязательное
Путь до неверного поля.
msgстрока · необязательное
Причина нарушения.
typeстрока · необязательное
Код нарушения.
inputобъект · необязательное
Переданное значение.

Текст ошибки, если сервер не вернул объект.

Другой ответ

Ошибка входного сервера или сети может иметь текстовое/HTML-тело. Проверяйте HTTP-статус и Content-Type.