TrackingMore API

TrackingMore API

Get API key

Для использования данного API вам необходимо создать API-ключ для TrackingMore в API Keys.

The base URL

https://api.trackingmore.com/v2

Note : "http" is also supported.

Header

In order to verify and authenticate your application (e.g. your site), all of the requests that you make to the API must include your unique TrackingMore API Key header (Trackingmore-Api-Key), which you can generate and/or find in the API Keys.

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

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

Статус Description
pendingНовые отправления, которые ожидают отслеживания
notfoundВ настоящее время элементы не найдены.
transitОтправление покинуло почтовое отделение и находится в пути к месту назначения
pickupОтправление выдано для доставки или прибыло в ваше отделение связи (вы можете планировать получение отправления)
deliveredОтправление успешно доставлено.
undeliveredПеревозчик осуществил неудачную попытку вручения отправления. Обычно перевозчики оставляют уведомление и производят повторную доставку.
exceptionВаше отправление оказалось в нестандартной ситуации. Скорее всего, оно было возвращено отправителю, не прошло таможенное оформление или было повреждено.
expiredОтправление находится в пути в течение длительного периода. Доставка не осуществлена.
NotFound подсостояния Description
not found001Информация получена/информация о полученных. Пакет должен быть взял.
not found002Нет информации отслеживания для этого пакета.
Исключение подсостояния Description
exception001Отслеживания добавлен номер более чем ** без отслеживания информации, помечена как «Исключение».
exception002Пакет в транзита ** с no, помеченные как «Исключение».
exception003Отслеживания добавлен номер более чем ** но не доставлено, помеченные как «Исключение».
exception004Пакет невостребованным.
exception005Пакет был отправлен обратно к отправителю.
exception006Пакет сохраняется таможней, потому что он запрещенных товаров.
exception007Пакет поврежден, потеряли или удалены.
exception008Пакет отменяется до доставки.

Возвращаемый список параметров API

ПараметрDescription
codeMeta.Code
typeMeta.Type
messageМета описание состояния
idСлучайные данные, созданные Trackingmore для идентификации отслеживания
tracking_numberНомер отслеживания посылки
carrier_codeКурьера код
statusСостояние пакета
created_atВремя, когда был добавлен номер для отслеживания
updated_atПоследний раз был обновлен идентификационный номер
order_create_timeВремя создания заказа
titleНазвание продукта
order_idКОД заказа
commentВаше замечание к отгрузке
customer_nameИмя клиента
customer_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.codeMeta.typeСообщение
200SuccessУспешная обработка запроса (некоторые API могут вернуть ответ 201).
201CreatedЗапрос успешно обработан. Указанный ресурс был создан.
202Bad RequestЗапрос был успешно обработан, но вы превысили лимит.
401UnauthorizedОшибка авторизации или у пользователя отсутствуют права на выполнение указанной операции.
4001 Unauthorized Неправильный API-ключ. Проверить API调用说明
4002 Unauthorized API-ключ был удален. Проверить API调用说明
4012Bad RequestЗапрос не может быть распознан или не содержит ключевых параметров.
4013Bad RequestНеобходимо указать номер для отслеживания Tracking_number.
4014Bad RequestНекорректное значение поля `tracking_number`.
4015 Bad Request Некорректное значение поля `carrier_code`. Проверить Курьера код
4016Bad RequestТакой номер уже существует.
4017Bad RequestТакого номера не существует.
4018Bad RequestДанная функция активируется в индивидуальном порядке из-за риска перегрузки системы. Пожалуйста, напишите на [email protected] для получения более подробной информации.
4019Bad RequestВаш баланс не достаточно, пожалуйста, зарядите время, бесплатный аккаунт можно добавить до 500 одного номера в месяц.
4020Bad RequestНе более 200 отправлений за один раз
4021 Bad Request Недостаточно средств. Вы не можете получить данные из API. Покупка Здесь
4031 No Content Запрос успешно обработан, однако сервер прислал пустой ответ. Пожалуйста, попробуйте POST /trackings/post И потом GET /trackings/get
4032 No Content Не удалось определить перевозчика. Назначьте ваш груз у курьера, автоматического обнаружения. Получить код курьер
4033No ContentНедопустимое значение «статус».
402Payment RequiredТребуется оплата.
403ForbiddenДоступ запрещен.
404Not FoundРесурс не найден.
405Method Not AllowedВыбранный метод не поддерживается данным ресурсом.
409ConflictЗапрос не может быть выполнен из-за возникновения конфликта.
429Too Many RequestsПревышение лимита API. Пожалуйста, подождите две минуты и повторите ваш запрос.
500Server error
503Service UnavailableСервис временно недоступен (например, производится плановое обслуживание системы). Попробуйте повторить запрос позднее.

Ограничение частоты запросов

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

  • POST /trackings/realtime        Отслеживание в реальном времени: не более 3 запросов в секунду с одного IP-адреса.
  • GET /trackings/get                    Показать все отправления. Не более 1 запроса, содержащего не более 2000 номеров, в секунду
  • Facebook Twitter Android App Store
  • ©2014-2019 TrackingMore.All Rights Reserved.