Интерфейс API экспресс-запроса заключается в использовании логистического номера для запроса логистической информации. В основном используется в торговых центрах электронной коммерции, ERP-системах, системах WMS, экспресс-кабинетах, банках и других предприятиях. Несколько компаний экспресс-логистики имеют единый интерфейс доступа. Предполагается, что поставщики интерфейсов стыковки могут одновременно получать доступ к нескольким службам экспресс-доставки, что позволит сэкономить много времени на более позднем этапе технического обслуживания.
В настоящее время существует два способа реализации API-интерфейса экспресс-запроса: один-активный запрос, другой-интерфейс подписки, отправляющий данные. Возьмем в качестве примера интерфейс express bird (для стыковки интерфейса необходим секретный ключ интерфейса, который тестируется здесь и не может быть использован формально, вы можете подать заявку на http://www.kdniao.com/, который является бесплатным приложением с секретным ключом на веб-сайте express bird). По крайней мере, прилагаются два метода демонстрации.
Активный запрос (API мгновенных запросов)
1) Правила интерфейса A. Интерфейс запроса поддерживает запросы в соответствии с номером заказа на доставку (один запрос, одновременный не более 10/С).
B. Указанный номер счета за логистику выбирает соответствующий код экспресс-компании, если формат неверен или ошибка кодирования вернет информацию об ошибке. Если номер логистики EMS должен выбрать экспресс-код компании (EMS)
C. Возвращенная информация о логистическом отслеживании упорядочена в порядке возрастания в зависимости от времени возникновения.
D. Инструкция по интерфейсу 1002.
E. Адрес запроса: Войдите в систему и получите
2) Входные параметры на уровне системы и приложения
3) Возвращаемые параметры результата
4) Примеры запросов JSON
{
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118650888018"
}
// "SF" is the code of Shunfeng Express Company. Other codes can be downloaded from the official website of Express Bird.
5) JSON return example
// No logistics trajectory
{
"EBusinessID": "1109259",
"Traces":[],
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"Reason": null
}
// Logistics trajectory
{
"EBusinessID": "1109259",
"OrderCode":"",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"CallBack":"",
"State": 3,
"Reason": null,
"Traces":[
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "Delivery under way. (Deliverer: Deng Yufu, tel: 18718866310) [Shenzhen]"
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"AcceptStation": "Express in Shenzhen Distribution Center, ready to send to the next stop in Shenzhen [Shenzhen]."
"Remark": null
},
{
"AcceptTime": "2014/06/2501:41:06",
"AcceptStation": "Express in Shenzhen Distribution Center [Shenzhen]".
"Remark": null
},
{
"AcceptTime": "2014/06/24 20:18:58",
"AcceptStation": "Received [Shenzhen]".
"Remark": null
},
{
"AcceptTime": "2014/06/24 20:55:28",
"AcceptStation": "Express in Shenzhen, ready to send to the next stop of Shenzhen Distribution Center [Shenzhen]."
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"AcceptStation": "The dispatch has been signed [Shenzhen]".
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"AcceptStation": "The signatory is: has signed [Shenzhen]".
"Remark": null
}
]
}Интерфейс подписки Push-данные (API отслеживания логистики)
Интерфейс запроса подписки – это настраиваемая служба. Пользователи могут подписаться на информацию о заказе для экспресс-компаний. После того, как экспресс-компании обновят свои траектории, они преобразуют данные в режиме реального времени в стандартную форму интерфейса и передадут ее пользователям, что сыграет роль в режиме реального времени и повысит эффективность. В то же время данные, подписанные пользователями, также могут выбирать, уведомлять ли курьера о том, чтобы он подошел к двери, чтобы реализовать функцию размещения заказов онлайн. Кроме того, Express bird также имеет мониторинг в пути, электронный лицевой лист и другие схемы интерфейса, которые могут быть выбраны в соответствии с потребностями компании.
1) Правила интерфейса A. Информация, полученная заказом (информация, распространяемая в сети и продавцу), будет передана клиенту через push-интерфейс (подписка и параллелизм не более 30 раз/с). Клиенту необходимо реализовать интерфейс по мере необходимости.
B. Поддержка только формата Json.
С. Запросить инструкцию 1008.
D. Адрес тестового интерфейса: http://test api .kdniao.cc:8081/api/dist
E. Пожалуйста, измените официальный адрес после прохождения отладки: http://api.kdniao.cc/api/dist
F, Интерфейсы распространения и подписки требуют, чтобы клиент реализовал интерфейс обратного вызова и тип запроса обратного вызова (1008)
2) Параметры системного уровня и уровня приложения Входные параметры системного уровня
3) Примеры запросов JSON
{
"ShipperCode":"SF",
"OrderCode":"SF201608081055208281",
"LogisticCode":"3100707578976",
"PayType":"1",
"ExpType":"1",
"CustomerName":"",
"CustomerPwd":"",
"MonthCode":"",
"IsNotice":"0",
"Sender":{
"Name":"1255760",
"Tel":"",
"Mobile":"13700000000",
"ProvinceName": "Guangdong Province".
"City Name": "Shenzhen City".
"ExpArea Name": "Fukuda District".
"Address": "Test Address"
},
"Receiver":{
"Name":"1255760",
"Tel":"",
"Mobile":"13800000000",
"ProvinceName": "Guangdong Province".
"City Name": "Shenzhen City".
ExpArea Name: "Longhua New Area".
"Address": "Test Address 2"
},
"Commodity":[
{
"Goods Name": "Books"
}
]
}
5) JSON return example
{
"EBusinessID":"1151847",
"UpdateTime": "2016-08-0916:42:38",
"Success": true,
"Reason": ""
"EstimatedDeliveryTime":"2016-8-12"
}
Instant Query APIdemo
Logistics Tracking APIdemo
