Коды ответов

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

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

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

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

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

Код	Статус	Описание
`400`	Bad Request	Запрос некорректен или содержит недопустимые параметры.
`401`	Unauthorized	Требуется аутентификация. API-ключ отсутствует.
`403`	Forbidden	API-ключ недействителен или не имеет прав доступа к ресурсу.
`404`	Not Found	Запрашиваемый ресурс не существует.
`409`	Conflict	Запрос конфликтует с текущим состоянием ресурса.
`422`	Unprocessable Entity	Тело запроса содержит семантические ошибки.
`429`	Too Many Requests	Превышен лимит запросов. Замедлите отправку и повторите попытку после периода, указанного в заголовке `Retry-After`.

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

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

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

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

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

{
  "ok": false,
  "error": {
    "code": 403,
    "message": "Forbidden"
  }
}