Коды ответов

HTTP-коды ответов Statsnet API.

API возвращает соответствующий HTTP-код, указывающий, был ли запрос успешным (например, 200 OK) или завершился ошибкой (например, 403 Forbidden). Если запрос не удался, проверьте ответ API для получения дополнительной информации.

Коды успешных ответов

Код	Статус	Описание
`200`	OK	Запрос выполнен успешно.
`201`	Created	Ресурс успешно создан.
`204`	No Content	Запрос выполнен успешно, но данные для возврата отсутствуют.

Коды ошибок клиента

Код	Статус	Описание
`400`	Bad Request	Запрос некорректен или содержит недопустимые параметры.
`401`	Unauthorized	Сессия или учётные данные истекли, либо API-ключ недействителен/отозван.
`402`	Payment Required	У аккаунта ключа нет активной подписки (отменена или истекла).
`403`	Forbidden	Нет доступа: анонимный запрос к защищённому эндпоинту или недостаточный тариф.
`404`	Not Found	Запрашиваемый ресурс не существует.
`409`	Conflict	Запрос конфликтует с текущим состоянием ресурса.
`422`	Unprocessable Entity	Тело запроса содержит семантические ошибки.
`429`	Too Many Requests	Исчерпан месячный лимит API-вызовов или превышена частота запросов. Смотрите заголовки `X-API-Calls-Used` и `X-API-Calls-Limit`. На тарифах с отчётами этот код также означает исчерпанную квоту отчётов периода.

Коды ошибок сервера

Код	Статус	Описание
`500`	Internal Server Error	На сервере произошла непредвиденная ошибка.
`502`	Bad Gateway	Сервер получил некорректный ответ от вышестоящего сервера.
`503`	Service Unavailable	Сервер временно недоступен. Повторите запрос позже.

Формат ответа с ошибкой

При неудачном запросе API возвращает JSON-объект с деталями ошибки:

Пример ответа с ошибкой

{
  "status": 403,
  "message": "access denied"
}