ParcelTrack API

Получить API ключ

Для того, чтобы воспользоваться данным API, Вам необходимо сгенерировать ключ ParcelTrack API, сделать это можно здесь API Keys.

База данных URL

https://api.parceltrack.ru/v1

Примечание: При работе с API, используется https, а также http соединение

Заголовок

Для проверки и аутентификации вашего приложения (например, вашего сайта) все запросы к API должны включать ваш уникальный Parceltrack API ключ (Api-Key), вы можете сгенерировать ключ авторизации Api-Key.

Content-Type: application/json
Api-Key: YOUR_API_KEY

Список статусов отслеживания отправления

Значение	Описание
pending	Заказ создан в информационной системе.
notfound	Заказ не найден в данный момент.
transit	Заказ отправлен.
pickup	Выдан на доставку.
delivered	Успешно доставлен и вручен адресату (конечный статус).
undelivered	Неудачная попытка доставки, возможно было оставлено уведомление и будет предпринята повторная попытка.
exception	Необычное состояние доставки. Это может быть вызвано рядом причин, такими как, товар был возвращен отправителю, задержка таможней, утерян, поврежден, отсутствие информации и т. д.
expired	Заказ долго находится в периоде транспортировки без обновления статуса.

---

Подстатусы "Не найдено"	Описание
not found001	Имеется лишь информация о том, что заказ готов к перевозке.
not found002	Нет информации об отслеживании данного заказа.

---

Подстатусы "Исключение"	Описание
exception001	Заказ добавлен ** дней без информации отслеживания, помечен как «Исключение».
exception002	Заказ в пути ** дней без информации отслеживания, помечен как «Исключение».
exception003	Трек-номер добавлен ** дней назад, но не доставлен, помечен как «Исключение».
exception004	Невостребованное отправление.
exception005	Посылка была отправлена обратно отправителю.
exception006	Посылка задержана на таможне как запрещённый товар.
exception007	Посылка утеряна или повреждена.
exception008	Доставка отменена до получения.

Список ответов API

Значение	Описание
code	Meta.code
type	Meta.type
message	Meta status description
id	Случайные данные, генерируемые ParcelTrack для идентификации отслеживания.
tracking_number	Трек-номер или номер для отслеживания
carrier_code	Код службы доставки
status	Статус посылки
created_at	Время добавления трек-номера
updated_at	Время последнего обновления статуса посылки
order_create_time	Время создания заказа
title	Название продукта
order_id	Номер заказа
comment	Ваше замечание к заказу
customer_name	Имя покупателя
customer_email	email покупателя
original_country	Название страны происхождения/отправления.
singed_by	Имя получателя
lastEvent	Последнее обновление статуса
lastUpdateTime	Время последнего обновления статуса
destination_country	Название страны назначения
itemTimeLength	Время перевозки заказа
stayTimeLength	Общее количество дней без обновлений с момента появления последнего обновления
origin_info	Информация об отправлении предоставляется службой доставки отправителя.
ItemReceived	Время обновления первого статуса
ItemDispatched	Время отправки с сортировочного центра.
DepartfromAirport	Время прибытия на аэропорт.
ArrivalfromAbroad	Время прибытия в страну назначения.
CustomsClearance	Время передачи посылки таможне.
DestinationArrived	Время прибытия в пункт назначения.
weblink	Ссылка на официальный сайт службы доставки.
phone	Телефон службы доставки
trackinfo	Подробная информация об отслеживании
Date	Дата конкретного статуса
StatusDescription	Основное содержание конкретного статуса
Details	Информация о местоположении отправления
destination_info	Информация об отправлении предоставляется службой доставки получателя.

---

Стандартный ответ сервера

Мы ответим Вам одним из следующих кодов состояния.

Meta.code	Meta.type	Description
200	Success	Запрос был успешно выполнен (некоторые вызовы API могут возвращать вместо этого код 201).
201	Created	Запрос был успешно выполнен и ресурс был создан.
202	Bad Request	Запрос был успешно выполнен, но был превышен лимит.
401	Unauthorized	Ошибка аутентификации или пользователь не имеет достаточно прав для совершения запрашиваемой операции.
4001	Unauthorized	Ошибочный API ключ. Проверьте его правильность. Check
4002	Unauthorized	API ключ был удален. Проверьте его состояние. Check
4012	Bad Request	Запрос не может быть распознан или не содержит ключевых параметров.
4013	Bad Request	Необходимо указать номер для отслеживания Tracking_number.
4014	Bad Request	Некорректное значение поля `tracking_number`.
4015	Bad Request	Некорректное значение поля `carrier_code`. Check Код службы доставки
4016	Bad Request	Данное отслеживание уже существует.
4017	Bad Request	Данное отслеживание не существует.
4018	Bad Request	Из-за рисков перегрузки данная функция требует активации службой поддержки. Свяжитесь по адресу [email protected] для уточнения дополнительной информации.
4019	Bad Request	Баланс израсходован, пожалуйста, пополните счет для продолжения. Бесплатный аккаунт поддерживает до 500 номеров в месяц.
4020	Bad Request	Максимум 200 за один раз.
4021	Bad Request	Остатка на балансе не достаточно для совершения операции с API. Пополнить. Purchase
4031	No Content	Запрос был успешно выполнен, но ответ пуст. Попробуйте POST /trackings/post и затем GET /trackings/get
4032	No Content	Не удается определить службу доставки. Требуется указать службу доставки вручную. Assign your shipment a courier instead of by auto detection. Get courier code
4033	No Content	Значение `status` недопустимо.
402	Payment Required	Требуется оплата.
403	Forbidden	Доступ запрещен.
404	Not Found	Ресурс не найден.
405	Method Not Allowed	Запрашиваемый метод не поддерживается для указанного ресурса.
409	Conflict	Запрос не может быть выполнен из-за конфликта.
429	Too Many Requests	Превышены лимиты API. Подождите две минуты и повторите попытку.
500	Server error
503	Service Unavailable	Услуга временно недоступна (возможно плановое обслуживание системы). Повторите попытку позже.

Лимит запроса

Используется ограничение на количество запросов. Когда количество запросов превысит установленный лимит, будет выдана ошибка 429..