Автор оригинала: David Wong.
Интерфейс API экспресс-запросов предназначен для запроса логистической информации с использованием номера логистического документа. Он в основном используется в торговом центре электронной коммерции, поставщике ERP – систем, поставщике систем WMS, экспресс-кабинете, банке и других предприятиях. Несколько компаний экспресс-логистики имеют единый доступ к интерфейсам. Рекомендуется подключаться к поставщикам интерфейсов, которые могут одновременно получать доступ к нескольким экспресс-доставкам и экономить много работы при последующем техническом обслуживании.
В настоящее время существует два способа реализации API экспресс-запросов: один-активный запрос, другой-интерфейс подписки для отправки данных. Возьмем в качестве примера интерфейс express bird (для стыковки интерфейса требуется секретный ключ интерфейса, который здесь тестируется и не может быть использован формально. Вы можете подать заявку на секретный ключ на официальном сайте express bird по адресу http://www.kdniao.com/, который предоставляется бесплатно). Наконец, есть два демонстрационных метода
1. Активный запрос (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 SF express company, and other codes can be downloaded on the official website of express bird
5) JSON return example
//Without logistics track
{
"EBusinessID": "1109259",
"Traces":[],
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"Reason": null
}
//With logistics track
{
"EBusinessID": "1109259",
"OrderCode":"",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"CallBack":"",
"State": 3,
"Reason": null,
"Traces":[
{
"AcceptTime": "2014/06/25 08:05:37",
"Acceptstation": "sending a message... (sender: Deng Yufu, Tel: 18718866310) [Shenzhen]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"Acceptstation": "the express is in Shenzhen distribution center, ready to be sent to the next station, 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": "the express is in Shenzhen, ready to be sent to the next station, Shenzhen distribution center [Shenzhen]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"Acceptstation": "dispatch has been signed in [Shenzhen]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"Acceptstation": "signed by [Shenzhen]",
"Remark": null
}
]
}2. Интерфейс подписки для отправки данных (API отслеживания логистики)
Интерфейс запроса подписки – это настраиваемая служба. Пользователи могут подписаться на информацию о заказе для экспресс-компаний. После того, как экспресс-компании обновят свои треки, они преобразуют информацию в реальном времени в стандартную форму интерфейса и передадут ее пользователям, что играет роль толчка в реальном времени и повышает эффективность. В то же время пользователи также могут выбрать, следует ли уведомлять курьера о посещении сайта для реализации функции онлайн-заказа. Кроме того, express bird имеет другие схемы интерфейса, такие как мониторинг в пути и электронный список лиц, которые могут быть выбраны в соответствии с потребностями компании.
1) Правила интерфейса a. Информация, полученная по заказу (информация, распространяемая среди торговых точек и операторов), будет передана клиенту через push-интерфейс (одновременная подписка не должна превышать 30 раз/с). Заказчику необходимо реализовать интерфейс по мере необходимости.
б. Поддерживается только формат JSON.
c. Запросить инструкцию 1008.
d. Адрес тестового интерфейса: http://test api .kdniao.cc: 8081/api/dist/код: 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",
"Cityname": "Shenzhen City",
"Expandame": "Futian District",
"Address": "test address"
},
"Receiver":{
"Name":"1255760",
"Tel":"",
"Mobile":"13800000000",
"Provincename": "Guangdong Province",
"Cityname": "Shenzhen City",
"Expandame": "Longhua New Area",
"Address": "test address 2"
},
"Commodity":[
{
"Goodsname": "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
Оригинал: “https://developpaper.com/free-logistics-express-query-api-interface-quick-docking-strategy-zhongtong-shentong-shunfeng-yunda/”