Отслеживание посылок на Вашем сайте с API от Track24.ru

У Вас есть сайт связанный с покупками в интернет-магазинах или Вы владелец интернет-магазина?
Хотите повысить лояльность Ваших посетителей или клиентов Вашего магазина?

Подключите трекинг посылок от Track24.ru и это поможет Вам уменьшить количество возвращенных посылок, а также улучшить информированность, а следовательно и лояльность ваших пользователей.

С помощью нашего API, Вы и Ваши клиенты сможете бесплатно отслеживать почтовые отправления почты России.

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

Наши преимущества

  • На сегодняшний день мы подключили и успешно отслеживаем трек-коды 510+ международных почтовых компаний и курьерских служб, это больше чем у любого аналогичного сервиса, как Российского так и зарубежного.
  • Наши цены самые низкие как на Российском так и на зарубежном рынке, без ущерба качеству.
  • Мы автоматически определяем какими службами доставки мог бы доставляться отслеживаемый трек-код.
  • Мы предоставляем бесплатный тестовый период, для того чтобы Вы могли оценить качество работы.
  • Наши сервера работают 24/7, 365 дней в году, с практически 100% uptime.
  • У нас бесплатная и оперативная техническая поддержка.

Переход на расширенную версию API

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

Использование API

API (интерфейс программирования приложений) - это набор инструментов для автоматизированной работы с «Track24.ru». Функциональность API позволяет быстро интегрировать отслеживание почтовых отправлений в любое приложение / web сайт и является единственной точкой входа для всех клиентов и сервисов.

Все запросы к API отправляются по защищенному HTTPS протоколу методом GET с Вашим API ключом, полученным после авторизации в разделе API.

Получение ключа API

Прежде чем начать пользоваться нашими API службами, Вам необходимо зарегистрироваться и получить API ключ.

  1. Войдите в свой аккаунт Track24  или зарегистрируйтесь, если это необходимо.
  2. Перейдите на страницу API и Api ключ будет сгенерирован автоматически.
  3. После быстрой регистрации, и получения API ключа, Вы можете приступить к использованию API

Ваш API ключ


         

Точка входа JSON

https://api.track24.ru/tracking.json.php

Отправка запросов

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

apiKey: Ваш API ключ
domain: example.com
code: RF606161824SG

Пример формирования строки отправки запроса:

https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&pretty=true&code=RF606161824SG
В ответе на сформированный запрос, API отдаст всю доступную информацию по указанному трек-коду.

Ответы API

Результат обработки запроса отдается в формате JSON.

Пример ответа API в случае успеха выглядит следующим образом:

...
 {"status":"ok",
 "source":"cache",
   "data":{
   "events":[
      {"id":"544",
              "operationDateTime":"02.07.2014 19:16:00",
              "operationAttribute":"Прибыло в место вручения",
              "operationPlacePostalCode":"101100",
              "operationPlaceName":"Москва 100",
              "operationType":"Прибыло в место вручения",
              "itemWeight":"45",
              "source":"RU"
    }]
       }
   ...
 }
 

Формат ответа

Объект содержит следующий набор полей:
  • status - статус ответа API;
  • data - массив объектов с доступной информацией по указанному трек-коду;

Возможные ошибки:

В случае ошибки, ответ выглядит так:
  {
  status":"error",
   "message":"Invalid API key!"
   }
  • Invalid API key - Некорректный ключ API;
  • Non-existent API key! - Несуществующий ключ API;
  • Server too busy. Please try again later - Сервер перегружен, попробуйте позже;
  • Selected services not found - Выбрана несуществующая служба;
  • apiKey [apiKey] is blocked - Доступ с ключем [apiKey] заблокирован;
  • Domain ... is blocked - Домен заблокирован;
  • IP is blocked - IP Заблокирован;
  • Bad request - некорректный запрос;
  • Too Many Requests - Превышено количество запросов;
  • Track code not valid - Некорректный трек-код;
  • Domain is NULL - Не указан домен;

Лимиты

Если Вы будете отправлять большое количество запросов, то получите ошибку информирующую Вас о превышении количества запросов (Too Many Requests).

'error' : 'Too Many Requests'

В данный момент, стандартный лимит : 10 запросов / сек, 60 запросов / мин, 1000 запросов / в сутки, 5000 запросов / в месяц.


Кэш и период обновления трек-кодов (актуально для интернет-магазинов)

Почтовые системы очень редко обновляют статусы почтовых отправлений, в среднем это происходит 1 раз в 1 - 3 дня.
Мы рекомендуем запрашивать информацию о трек-коде не чаще, чем один раз в сутки.


Отслеживания трек-кодов по выбранным компаниям

Для отслеживания только по одной компании (для уменьшения времени отслеживания) используйте параметр

selectedService
Примеры:
 https://api.track24.ru/tracking.json.php?...&selectedService=rupost
 https://api.track24.ru/tracking.json.php?...&selectedService=uapost
 https://api.track24.ru/tracking.json.php?...&selectedService=hkpost
 https://api.track24.ru/tracking.json.php?...&selectedService=nlpost
 https://api.track24.ru/tracking.json.php?...&selectedService=lcmexp
Примеры запросов:
 https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&code=RF606161824SG&selectedService=rupost
 https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&code=RF606161824SG&selectedService=sgpost
Также Вы можете передавать список служб через запятую:
selectedService=rupost,uapost
Пример запроса:
https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&code=RF606161824SG&selectedService=rupost,sgpost
Получить список подключенных служб (код службы / название службы) можно получить сделав запрос с параметром
getServices=true
Пример запроса:
https://api.track24.ru/tracking.json.php?getServices=true

Выбор страны назначения

Если страна назначения не определилась в автоматическом режиме, Вы можете указать страну назначения принудительно.
Код страны назначения необходимо передавать параметром destinationCountryCode в соответствии со стандартом ISO 3166 - Alpha 2

Примеры запросов:

 destinationCountryCode=RU
 destinationCountryCode=UA
 destinationCountryCode=KZ
 destinationCountryCode=CN
Получение списка подключенных стран
getCountries=true
Пример запроса:
https://api.track24.ru/tracking.json.php?getCountries=true

Выбор языка статусов

По умолчанию результаты статусов отдаются на языке почтовых компаний (значения "operationAttributeOriginal", "operationTypeOriginal", "operationPlaceNameOriginal"), для получения результатов отслеживания с переводом необходимо указывать язык.
Поддерживаемые языки в данный момент: русский, английский, украинский, португальский, итальянский, испанский, французский, немецкий, польский и нидерландский. Обращем Ваше внимание, согласно ISO 639-1, для украинского необходимо указывать код uk, а не ua.

 lng=ru
 lng=en
 lng=uk
 lng=pt
 lng=it
 lng=es
 lng=fr
 lng=de 
 lng=pl
 lng=nl
 
Примеры запросов:
 https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&pretty=true&code=RF606161824SG&lng=ru
 https://api.track24.ru/tracking.json.php?apiKey=[apiKey]&domain=demo.track24.ru&pretty=true&code=RF606161824SG&lng=en

Выбор языка статусов

Установка виджета на свой сайт

Для установки виджета необходимо сделать 3 простых шага:

1. Подключить js скрипт:

<script type="text/javascript" language="javascript" src="https://api.track24.ru/track24widget.js"></script>

2. Настроить виджет:

<script type="text/javascript">
var track24Options = {
'apiKey' : '[apiKey]',
'widgetId' : 'track24widget',
'domain' : 'you-domain-name.com',
'inputId' : 'track24Input',
'buttonId' : 'track24Button',
'resultId' : 'track24Result',
'useCss' : true,
'codePage': 'UTF-8' /* windows-1251 or UTF-8 */
};
</script>

3. Добавить HTML код элемента, в который будет встраиваться виджет:

<div id="track24widget"></div>

Пример работы установленного виджета


Виджет сохраняет последний запрос в cookies.

Пример работы установленного виджета на отдельной странице: http://track24.net/demo.widget/


Модификация виджета

Если Вы хотите изменить расположение формы и выдачи результата трекинга, Вам необходимо вместо элемента с id="track24widget" самостоятельно вставить форму ввода трек-кода, и элемент выдачи результата трекинга в любое удобное место, на Вашей странице.

Пример:

<!-- Форма ввода трек-кода, устанавливается в любое, удобное место на вашей странице -->
 <form id="track24Form">
   <input id="track24Input" type="text" value="" placeholder="Пример: 17010075171291">
   <button id="track24Button" type="submit">Отследить</button>
 </form>
 
 <!-- Элемент выдачи результата трекинга, устанавливается в любое, удобное место на вашей странице -->
 <div id="track24Result" class="track24Result"></div>

Если Вы не хотите подключать наш css, укажите значение false в настройках подключения виджета.

'useCss' : false

И настройте css на свой вкус и цвет.

 #track24Input { } 
 #track24Button { } 
 .track24Result { } 
 .track24Result-Title { }
 .track24Result-Events { }
 .track24Result-Row { }
 .track24Result-Status { }
 .track24Result-DateTime { }
 .track24Result-Date { } 
 .track24Result-Time { } 
 .track24Result-Operations { }
 .track24Result-OperationAttribute { }
 .track24Result-OperationType { }
 .track24Result-Place { }
 .track24Result-OperationPlacePostalCode { }
 .track24Result-operationPlaceName { }
 .track24Result-copyright { }
 .track24Result-copyright-link { }   
 

Пример работы API в Excel + VBA

Скачать пример api-track24-excel-vba-demo.xlsm

Условия использования API

  • При использовании виджета, не допускается удаление строк кода отвечающих за вывод блока с копирайтом.
    Мы рекомендуем подгружать track24widget.js, с ресурса https://api.track24.ru.

  • На странице с установленным виджетом или при использовании API, необходимо установить активную и видимую без прокрутки посетителям сайта (или приложения) гиперссылку на track24.ru

    Ссылка не должна быть закрыта тегами noindex, параметром nofollow, без использования JavaScript и т.д.

    Пример: Информация об отслеживании предоставлена сервисом track24.ru
  • Строка "Информация предоставлена сервисом Track24.ru" должна быть видна пользователям.

  • При подключении к API, запрещается указывать вымышленные (не пренадлежащие Вам) имена доменов, использовать несколько аккаунтов, proxy серверов и других технологий для обхода лимитов.

Благодарим вас за использование API Track24.ru

Track24.ru оставляет за собой право обновлять и изменять данные Условия API или любые документы, которые включаются в данный документ путем ссылки.

Вы всегда можете найти самую последнюю версию данных Условий API на странице https://track24.ru/?page=api#apiRules

Track24.ru может изменять данные Условия API путем публикации новой версии.

Использование API Track24.ru после подобных изменений означает, что вы приняли эти изменения.

Цены

В месяц Стоимость Сумма в месяц
>14 рубот 4 руб
>9003 рубот 2'700 руб
>3'0002 рубот 6'000 руб
>15'0001 рубот 15'000 руб
>45'0000.95 рубот 42'750 руб
>150'0000.90 рубот 135'000 руб
>300'0000.85 рубот 255'000 руб
>450'0000.80 рубот 360'000 руб
>900'0000.75 рубот 675'000 руб
>1'500'0000.70 рубот 1'050'000 руб
Отказ от использования Copyright, снятие ограничений на суточные лимиты, а также полный доступ ко всем 510 почтовым службам подключенных к нашему сервису, предоставляется на платной основе.

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


По всем возникшим вопросам по работе с API, пишите на support@track24.ru, или звоните 8 (495) 155-47-24