Создание запроса на получение статусов почтового отправления в режиме реального времени
Описание
Для того, чтобы получить статусы почтового отправления в режиме реального времени (т.е. с прямым обращением к почтовым службам) сначала необходимо создать запрос. Метод позволяет создать этот запрос. После создания запроса через некоторый промежуток времени статусы по отправлению можно получить, вызвав соответствующий метод.
Количество запросов в сутки ограничено. Нужен безлимит? Напишите нам.
URL
POST https://moyaposylka.ru/api/v1/trackers/{carrier}/{barcode}/realtime
Параметры подстановки
| Параметр | Описание |
|---|---|
| carrier | Код почтовой службы. |
| barcode | Трек-номер отслеживания, минимум 7 символов. |
Тело запроса
Передаётся в виде json строки с необходимыми параметрами. В заголовках запроса необходимо указывать тип Content-Type: application/json.
| Параметр | Описание |
|---|---|
| countryCode | Код страны назначения. Рекомендуется указывать страну назначения для международных почтовых отправлений или EMS (код почтовых служб upu или ems). |
| pin | Пин-код при отслеживании почтового отправления службой ЖелДорЭкспедиция (jde). |
Возможные ошибки
| Статус | Код ошибки | Описание |
|---|---|---|
| 404 | UnknownCarrier | Неизввестный код почтовой службы. |
| 400 | InvalidBarcode | Некорректный трек-номер. |
| 400 | InvalidTrackerParam | Переданы не все требуемые параметры запроса. |