Формат заголовка ответа

Формат заголовка ответа

Пример заголовка ответа 1:

State: 200 OK
request-id:20011220103455.12345@nic.ru

 

Пример заголовка ответа 2:

State: 401 Authorization failed
request-id:20011220103455.12345@nic.ru

Заголовок ответа содержит следующие поля:

  • State
    Статус ответа. Через пробел следует код ошибки и расшифровка кода ошибки на английском языке.
     
  • request-id
    Уникальный идентификатор запроса, заданный пользователем в заголовке запроса. Это поле может быть использовано для учета направленных запросов и полученных ответов в вашей собственной базе данных.

Коды ошибок:

Тип ошибки

Код ошибки

Описание

2XX — успешное выполнение

200

Выполнение запроса успешно

4XX — ошибка в запросе

400

Неправильный заголовок запроса

401

Ошибка авторизации: неверный или отсутствующий пароль

402

Ошибки в теле запроса

403

Запрос такого типа не может быть выполнен

404

Запрашиваемый объект не найден

405

Превышение допустимого количества запросов

5XX — ошибка сервера

500

Внутренняя ошибка модуля, обслуживающего запросы

501

База данных временно недоступна

502

Сервер обработки запросов временно не доступен

Далее после заголовка может следовать тело ответа. В случае кода ответа 200 оно содержит блоки с данными, в случае кода 402 — блок errors с подробным описанием ошибок в теле запроса и рекомендациями по их исправлению на указанном в запросе языке.

Заголовок ответа отделяется от тела ответа пустой строкой.

При возврате ошибок 4ХХ и 5ХХ в заголовке ответа запрос не будет обработан.

В случае ошибок 4ХХ необходимо исправить ошибки и повторить запрос.

В случае ошибок 5ХХ и 405 следует повторить попытку позже.

Всё ещё остались вопросы?