Формат заголовка ответа
Пример заголовка ответа 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 следует повторить попытку позже.