Основные HTTP статусы

Успешный запрос

200 OK

Статус говорит о том что запрос выполнен успешно, все действия выполнены.

201 Created

Этот статус мы возвращаем если запрос был выполнен успешно, необходимые данные получены и записаны в БД.

202 Accepted

Статус возвращается в случае если запрос прошел успешно, но полученные данные требуют время на обработку. В БД они появятся не сразу, а через некоторое время, когда будет завершена их обработка. Узнать о том что данные попали в базу можно несколькими способами, описанными здесь

204 No Content

Запрос прошел успешно, но данные для возврата отсутствуют.

Неуспешный запрос

400 Bad Request

Этот статус сообщает вам о том что в запросе, переданном вами на API, были ошибки. Это может быть ошибка в параметрах запроса или в теле запроса, т.е. неверно сформированном JSON, отсутствии каких-либо обязательных полей и т.д. Как проверить правильность отправлямых данных можно прочитать тут Решение проблем при работе с API

401 Unauthorized

Этот статус сообщает вам о том что вы не авторизованы для выполнения вызова API. Возможно вы не передаете авторизационный токен, либо он не проходит валидацию по каким-либо причинам. Убедитесь что срок жизни токена не истек, для аптек на данный момент его срок жизни составляет 1 час. Более точное время жизни токена вы можете получить при запросе токена на сервере авторизации. Посмотреть содержимое токена можно здесь

403 Forbidden

Данный статус выдается в случае если вы прошли авторизацию при помощи токена, но у вас нет прав на выполнение конкретного вызова API. Обратитесь, пожалуйста, в техподдержку, если вы считаете что такие права у вас должны быть.

404 Not Found

Выдается в случае если в API нет такого URL, который вы пытаетесь вызвать. Проверьте правильность URL, полное соответствие его документации.

405 Method Not Allowed

Этот статус вы можете получить если вызываемый URL существует, но вы используете HTTP метод, который не поддерживается для данного URL. Например, вы пытаетесь выполнить метод POST, когда URL поддерживает только метод GET.

429 Too Many Requests

Статус выдается если вы превысили допустимое число запросов в единицу времени. Сервисы имеют небезграничные ресурсы, кроме того, нет необходимости выполнять какие-то вызовы слишком часто, например, отправку полных остатков досточно произвести раз в сутки.

500 Internal Server Error

Этот статус может придти от сервиса если случился какой-либо сбой в его работе. Сбой может быть вызван ошибкой в сервисе, нагрузкой на компоненты сервиса, некорректными запросами. Как правило, данный статус носит временный характер и при повторе запроса уже не возвращается.