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

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

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

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

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

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

  • На сегодняшний день мы подключили и успешно отслеживаем трек-коды 450+ международных почтовых компаний и курьерских служб, это больше чем у любого аналогичного сервиса, как Российского так и зарубежного.
  • Наши цены самые низкие как на Российском так и на зарубежном рынке, без ущерба качеству.
  • Мы предоставляем бесплатный тестовый период, для того чтобы Вы могли оценить качество работы.
  • Наши сервера работают 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&code=RF606161824SG

Ответы сервера

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

Пример ответа:

...
 {"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"
    }]
       }
   ...
 }
 

Лимиты

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

'error' : 'Too Many Requests'

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


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

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

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

Для установки виджета необходимо сделать 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, снятие ограничений на суточные лимиты, а также полный доступ ко всем 450 почтовым службам подключенных к нашему сервису, предоставляется на платной основе.

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


По всем возникшим вопросам по работе с API, пишите на support@track24.ru.