Отслеживание посылок на Вашем сайте с 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:
Благодарим вас за использование 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
  • Запрещается использовать вымышленные названия доменов, proxy сервера и т.д.

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

В сутки В месяц Стоимость Сумма в месяц
>1 >14 рубот 4 руб
>30 >9003 рубот 2'700 руб
>100 >3'0002 рубот 6'000 руб
>500 >15'0001 рубот 15'000 руб
>1500 >45'0000.95 рубот 42'750 руб
>5'000 >150'0000.90 рубот 135'000 руб
>10'000 >300'0000.85 рубот 255'000 руб
>15'000 >450'0000.80 рубот 360'000 руб
>30'000 >900'0000.75 рубот 675'000 руб
>50'000 >1'500'0000.70 рубот 1'050'000 руб

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


Отказ от любой гарантии.
API TRACK24.RU ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ» И «ПО МЕРЕ ДОСТУПНОСТИ» БЕЗ КАКИХ-ЛИБО ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ ГАРАНТИЙ.
TRACK24.RU ЯВНО НЕ ГАРАНТИРУЕТ КАКИХ-ЛИБО ГАРАНТИЙ И УСЛОВИЙ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, КАКИЕ-ЛИБО ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ ТОВАРНОСТИ, ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ, ДОСТУПНОСТИ, БЕЗОПАСНОСТИ, НАЗВАНИЯ И ГАРАНТИИ ОТСУТСТВИЯ НАРУШЕНИЙ АВТОРСКИХ ПРАВ.
TRACK24.RU НЕ ЗАЯВЛЯЕТ И НЕ ГАРАНТИРУЕТ, ЧТО В API TRACK24.RU ОТСУТСТВУЮТ НЕТОЧНОСТИ, ОШИБКИ ИЛИ ПРЕКРАЩЕНИЯ ИЛИ ЧТО API TRACK24.RU ЯВЛЯЕТСЯ НАДЕЖНЫМ, ТОЧНЫМ, ЗАВЕРШЕННЫМ ИЛИ ДРУГИМ ОБРАЗОМ ПРОВЕРЕННЫМ.

TRACK24.RU НЕ ГАРАНТИРУЕТ, ЧТО
(1) API TRACK24.RU БУДЕТ СООТВЕТСТВОВАТЬ ВАШИМ ТРЕБОВАНИЯМ;
(2) ЧТО СЛУЖБА API TRACK24.RU БУДЕТ РАБОТАТЬ БЕЗ ПЕРЕРЫВОВ;
(3) РЕЗУЛЬТАТЫ, ПОЛУЧЕННЫЕ ПРИ ИСПОЛЬЗОВАНИИ СЛУЖБЫ API TRACK24.RU БУДУТ ТОЧНЫМИ ИЛИ НАДЕЖНЫМИ;
(4) И КАЧЕСТВО ЛЮБЫХ ПРОДУКТОВ, СЛУЖБ, ДАННЫХ И ДРУГИХ МАТЕРИАЛОВ, ПОЛУЧЕННЫХ ЧЕРЕЗ API TRACK24.RU БУДЕТ СООТВЕТСТВОВАТЬ ВАШИМ ОЖИДАНИЯМ;
(5) ЧТО КАКИЕ-ЛИБО ОШИБКИ В API TRACK24.RU БУДУТ ИСПРАВЛЕНЫ.
ВЫ ИСПОЛЬЗУЕТЕ API TRACK24.RU НА СВОЙ СТРАХ И РИСК И НЕСЕТЕ ПОЛНУЮ ОТВЕТСТВЕННОСТЬ ЗА ЛЮБОЙ УЩЕРБ, КОТОРЫЙ ПОЛУЧАЕТСЯ В РЕЗУЛЬТАТЕ ИСПОЛЬЗОВАНИЯ API TRACK24.RU, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, УЩЕРБ, НАНЕСЕННЫЙ ВАШИМ ВЕБ ПРИЛОЖЕНИЯМ СИСТЕМЕ, ИЛИ ПОТЕРЮ ДАННЫХ.

Ограничение ответственности.
TRACK24.RU НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ НЕ НЕСЕТ ПЕРЕД ВАМИ ОТВЕТСТВЕННОСТЬ ЗА КАКИЕ-ЛИБО КОСВЕННЫЕ, НЕПРЕДНАМЕРЕННЫЕ, СЛУЧАЙНЫЕ, СПЕЦИАЛЬНЫЕ ИЛИ ШТРАФНЫЕ УБЫТКИ, А ТАКЖЕ УБЫТКИ В СВЯЗИ С ПОТЕРЕЙ ПРИБЫЛИ, СВЯЗАННЫЕ С ИСПОЛЬЗОВАНИЕМ API TRACK24.RU, НА ОСНОВАНИИ НАРУШЕНИЯ СОГЛАШЕНИЯ, НАРУШЕНИЯ ГАРАНТИИ, ПРАВОНАРУШЕНИЯ (ВКЛЮЧАЯ НЕБРЕЖНОСТЬ, ОТВЕТСТВЕННОСТЬ ЗА КАЧЕСТВО ПРОДУКЦИИ ИЛИ ПОДОБНЫЕ), ИЛИ ЛЮБОЙ ДРУГОЙ МАТЕРИАЛЬНЫЙ УЩЕРБ ВНЕ ЗАВИСИМОСТИ ОТ ТОГО, БЫЛА ЛИ КОМПАНИЯ TRACK24.RU УВЕДОМЛЕНА О ВОЗМОЖНОСТИ ПОДОБНЫХ УБЫТКОВ. TRACK24.RU НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ НЕ НЕСЕТ ОТВЕТСТВЕННОСТЬ ПЕРЕД ВАМИ НА КАКУЮ-ЛИБО СУММУ.

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