Express delivery inquiry
How to use the interface provided by express bird to query the logistics track of express delivery.
First of all, we have the resources we need,
Test merchant ID:
test1617571
Test API key:
554343b2-7252-439b-b4eb-1af42c8f2175 (this key is only used in test environment)
API test address:
http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
Next, let’s talk about request parameters
1、 Interface description / description
Description of request system level parameters:
remarks:R-required, o-optional, and the parameter in c-message is optional under certain conditions
The system level parameters mentioned here are equivalent to public parameters. These parameters must be passed to each interface when calling.
Interface parameters:
Interface parameters, also known as business parameters, request business interfaces are different, parameter fields, content is also different, is with the business change, here we implement the instant query interface, request instruction type: 1002, express bird official website requires that the express company code and logistics order number must be passed, and the code of homestay express is ZJS
To view the codes of other express companies, click this link:
http://www.kdniao.com/documents
We use the real order number (zjs00527102251
)To complete the trace interface call,
Request JSON
{‘OrderCode’:”,’ShipperCode’:zjs’,LogisticCode’:’ ZJS005271002251
‘}
The complete message of a request (after the URL code): request data% 0d% 0A% 0A + + + + + + + + + + + +% 7b% 27ordercode% 27% 3A% 27% 27% 2C% 27shipper code% 27% 3A% 27zjs% 27% 2C% 27logisticcode% 27% 3A% 27zjs0055271002251% 27% 7d% 0d% 0A + + & ebusinessiid = 1264783 & requesttype = 1002 & datasign = zdhaodvkmjwowq5zzzzjjjjzzzjjjzzzzjq3zzzzzjq3zzjjjjjzzzzzzjjjjjjjjzzzzzjjjjjjjjjjjjjjjjjjjjjjlmywe% 3D & datatype = 2
Uncoded request message:
RequestData= {‘OrderCode’:”,’ShipperCode’:’ZJS’,’LogisticCode’:’ZJS005271002251′} &EBusinessID=1264783&RequestType=1002&DataSign=ZDhiODVkMjAwOWQ5YzdjMjY1MzFiZjQ3ZWE3NzlmYWE=&DataType=2
Return message information
{
"LogisticCode": "ZJS005271002251",
"ShipperCode": "ZJS",
"Traces": [{
"Acceptstation": "picked up, left [Shanghai]_ Huaxin warehouse distribution center_ Financial project group 1 to [Shanghai base] ",
"AcceptTime": "2020-02-20 15:17:07"
}, {
"Acceptstation": "arrive at [Shanghai base]",
"AcceptTime": "2020-02-21 09:05:42"
}, {
"Acceptstation": leave [Shanghai base] and send to [Shandong]_ Weifang operation center] ",
"AcceptTime": "2020-02-22 16:56:18"
}, {
"Acceptstation": arrival in Shandong_ Weifang operation center] ",
"AcceptTime": "2020-02-23 14:48:34"
}, {
"Acceptstation": leaving Shandong_ Weifang operation center to Shandong_ Zibo distribution station] ",
"AcceptTime": "2020-02-25 00:11:46"
}, {
"Acceptstation": arrival in Shandong_ Zibo distribution station] ",
"AcceptTime": "2020-02-25 06:44:43"
}, {
"Acceptstation": leaving Shandong_ Zibo distribution station] to Shandong_ Zibo distribution station_ Point a in Zhoucun District] ",
"AcceptTime": "2020-02-26 18:42:51"
}, {
"Acceptstation": leaving Shandong_ Zibo distribution station_ Zhoucun District point a] delivery, delivery clerk [Fangjin], telephone [15065853111]. Please contact the courier for "non contact delivery service",
"AcceptTime": "2020-02-27 10:14:07"
}, {
"Acceptstation": "the customer has signed and received by: Zheng Yujie",
"AcceptTime": "2020-02-27 20:22:46"
}],
"State": "3",
"EBusinessID": "1264783",
"Success": true
}
Here according to our actual business needs to choose free package or charge package.
The detailed interface document is attached to you:
http://www.kdniao.com/documents