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

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

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

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

API Key

Как получить ключ API?

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

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

Ваш API ключ


	

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

Все запросы к API отправляются по зашифрованному https протоколу методом GET.


Запросы к API

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

Замените в настройках подключаемых скриптов apiKey на Ваш ключ.
'apiKey' : 'Ваш API ключ'

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

Результат обработки запроса отдается в формате 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"
			}]
	  }
 }
...

Лимиты

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

'error' : 'TooManyRequests'

В данный момент, стандартный лимит : 10 запросов / сек (600 запросов / мин), 1000 трек-кодов в сутки (на аккаунт / домен).


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

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


Отправка запроса и получение информации о трек-коде в формате JSON

Запрос на получение информации о трек-коде отправляется на:

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

В запросе необходимо отправить apiKey, имя домена с которого делается запрос, и трек-код в формате AZ#########AZ

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

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

https://track24.ru/api/tracking.json.php?apiKey=[apiKey]&domain=example.com&code=RG054395598CN

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

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

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

<script type="text/javascript" language="javascript" src="https://track24.ru/api/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:
Благодарим вас за использование API Track24.ru
Track24.ru оставляет за собой право время от времени обновлять и изменять данные Условия API или любые документы, которые включаются в данный документ путем ссылки.
Вы всегда можете найти самую последнюю версию данных Условий API на странице https://track24.ru/?page=api
Track24.ru может изменять данные Условия API путем публикации новой версии.
Использование API Track24.ru после подобных изменений означает, что вы приняли эти изменения.

Обращаем Ваше внимание:

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

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

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

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

    Пример: Информация об отслеживании предоставлена сервисом track24.ru
  • При подключении к API, запрещается использовать вымышленные названия доменов, proxy сервера и т.д.

Обратите внимание, что мы не предоставляем каких либо гарантий работы бесплатной версии API.

Отказ от использования Copyright, уменьшение времени кэширования на нашем сервере до 1 часа, снятие ограничений на суточные лимиты, а также полный доступ ко всем почтовым службам подключенных к нашему сервису, предоставляется на платной основе.

Цены

В месяц Стоимость Сумма в месяц
>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 руб

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

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

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

Переход на платную версию API

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

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