Express order number query API – homestay Express


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:


Test API key:

554343b2-7252-439b-b4eb-1af42c8f2175 (this key is only used in test environment)

API test address:

Next, let’s talk about request parameters

1、 Interface description / description

Description of request system level parameters:
Express order number query API - homestay Express
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:
Express order number query API - homestay Express

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:

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: