Изменения

Перейти к: навигация, поиск

API

2089 байт добавлено, 10:20, 29 мая 2017
Нет описания правки
Кодировка - UTF-8. Разделитель целой и дробной частей чисел - используется символ точки. Даты представляются в виде YYYY-MM-DD, время - HH:MM.
В силу [https://ru.wikipedia.org/wiki/XML#.D0.A0.D0.B5.D1.88.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B1.D0.BB.D0.B5.D0.BC.D1.8B_.D0.BD.D0.B5.D0.BE.D0.B4.D0.BD.D0.BE.D0.B7.D0.BD.D0.B0.D1.87.D0.BD.D0.BE.D1.81.D1.82.D0.B8_.D1.80.D0.B0.D0.B7.D0.BC.D0.B5.D1.82.D0.BA.D0.B8 особенностей языка XML], некоторые символы в тексте должны быть заменены: & на &amp;amp; < на &amp;lt; > на &amp;gt; " на &amp;quot;
 
== Ограничения ==
С целью защиты от нецелевого использования сервисов, с 29.05.2017 ведено ограничение на запросы - 1500 запросов с одного IP-адреса за 20 минут. В случае превышения IP-адрес блокируется, разблокировка возможна путем обращения в техническую поддержку, с последующим обсуждением ваших алгоритмов и их коррекцией.
 
Для проверки статусов заказов лучше всего использовать запросы "statusreq" с параметром changes=ONLY_LAST. Не нужно пытаться "бомбить" наше API запросами с номерами всех ваших заказов, особенно - запросами "tracking", они предназначены не для этого (смотрите описание).
== Оформление заказа ==
# При данном способе передачи (<changes>ONLY_LAST</changes>) система просматривает заказы, оформленные за последние 3 месяца. Если заказ сделан ранее - изменение статуса по нему не попадет в результат выполнения данного запроса.
# Система всегда выдает текущий статус. Т.е. Вы можете одним запросом получить статус "NEW", а следующим - "COMPLETE". В помежутке промежутке между запросами отправление могло пройти через несколько промежуточных статусов.
# Система никогда не гарантирует последовательность прохождения заказом набора статусов. Т.е. Вы можете получить статус "COMPLETE", а следующим запросом - "NEW" - такое может произойти, например, если оператор ошибочно отметил заказ выполненным, а затем исправил ошибку.
</div>
== Трекинг заказа по номеру ==
 
Запрос трекинга по номеру предназначен для выдачи минимальной обезличенной информации о конкретном заказе не авторизованному пользователю. Наша система имеет для этого интерфейс по адресу "home.courierexe.ru/{код экстра}/tracking". Вы можете либо сделать ссылку на такую страницу на своем сайте, либо разместить ее iframe'ом у себя, либо сделать свою и пользоваться нашим API. Этот интерфейс создан специально для выдачи информации живому пользователю сайта. Для получения статусов заказов в свою информационную систему нужно использовать запрос "statusreq", желательно с параметром changes=ONLY_LAST!
'''Пример запроса:'''

Навигация