First, express query map track

1.1 Interface Format

Provide HTTP POST or GET call interface in uniform format, and return format support JSON, XML, text, HTML data.

1.2 Requesting an Address

Poll.kuaidi100.com/poll/maptra…

Request parameters:

Parameter names If required type instructions
customer is string Authorization code, pleaseApply for enterprise EditionTo obtain
sign is string The signature is used to authenticate the identity. MD5 encryption is performed in the sequence of Param + key + Customer (the encrypted string must be in 32-bit uppercase letters) and the + sign is not required
param is param Concatenated by other fields

Param data structure:

Parameter names If required type instructions
com is string Query the express company code, all use lowercase letters
num is string The number of the queried Courier order is a maximum of 32 characters
phone no string The telephone number of sender and receiver (mobile phone and fixed phone are acceptable, only one can be filled in. Sf single number is mandatory, and other express companies choose to fill in. If a landline number has an extension number, the extension number does not need to be uploaded.
from is string Source information, for example, Kingdee Software Park, Nanshan District, Shenzhen city, Guangdong Province
to is string Destination information, such as international Finance Building, Chaoyang District, Beijing
show no string Format: 0: JSON (default), 1: XML, 2: HTML, 3: text
order no string Order of returned results :desc descending (default), ASC ascending
orderTime no string The ordering time is in the format of YYYY-MM-DD HH: MM: SS, for example, 2020-12-16 12:59:59

1.3 Request Instance

customer=**
  sign=**
  param={
    "com":"ems"."num":"em263999513jp"."phone":"13868688888"."from":Kingdee Software Park, Nanshan District, Shenzhen City, Guangdong Province."to":International Finance Building, Chaoyang District, Beijing."show":"0"."order":"desc"."orderTime":"The 2020-12-16 12:59:59"
  }
Copy the code

1.4 Result

The field names type Field meaning
message String Message body, please ignore
state Integer The current status of the express bill includes 13 states, including 0 in transit, 1 Receiving, 2 difficult, 3 receiving, 4 signing back, 5 sending, 6 returning, 7 forwarding, 10 waiting for customs clearance, 11 in customs clearance, 12 cleared, 13 abnormal customs clearance, 14 recipient rejection and so on
status Integer Communication status, please ignore
condition String Express order details status mark, not implemented yet, please ignore
ischeck Integer Please ignore whether to sign the label, and refer to the state field for details
com String Express company code, all lowercase letters
nu String Order no.
trailUrl String Track map link
arrivalTime String Estimated time of arrival
totalTime String The average time
remainTime String How long will it take to get there
isLoop Boolean Is there a loop
Θ routeInfo Routing information
└ Θ the from Information about the region of origin
└ number District information coding
└ name District information name
└ Θ cur Current administrative district information
└ number District information coding
└ name District information name
└ Θ to Destination Administrative Region Information
└ number District information coding
└ name District information name
Θ data data Latest query result, array, contains multiple, full, reverse order (that is, the latest in the first), each item is an object, the object contains fields please expand
└ context String content
└ time String Time, raw format
└ ftime String Time after formatting
└ status String The signature status of this data element will appear only after the Resultv2 mark is submitted in the real-time query interface
└ areaCode String The code of the administrative area corresponding to this data element will appear only after the Resultv2 mark is submitted in the real-time query interface
└ areaName String The name of the administrative region corresponding to this data element will appear only after the Resultv2 tag is submitted in the real-time query interface

1.5 Provide data content

{
	"message": "ok"."nu": "YT4781863654577"."ischeck": "1"."com": "yuantong"."status": "200"."data": [{
		"time": "The 2020-11-30 13:19:56"."context": "The express has arrived at The Shang Yi Station, No.3, Fortune Gold Street courtyard, tel: 18744663997"."ftime": "The 2020-11-30 13:19:56"."areaCode": null."areaName": null."status": "In transit"
	}, {
		"time": "The 2020-09-12 17:40:58"."context": "[Pinghu Company, Shenzhen city, Guangdong Province] Received by: Liu Jiezhen (18128837173)"."ftime": "The 2020-09-12 17:40:58"."areaCode": "CN440307003000"."areaName": Pinghu, Longgang District, Shenzhen City, Guangdong Province."status": "LanShou"}]."state": "3"."condition": "00"."routeInfo": {
		"from": {
			"number": "CN4403"."name": "Shenzhen, Guangdong province"
		},
		"cur": {
			"number": "CN6101"."name": "Xi 'an, Shaanxi province"
		},
		"to": {
			"number": "CN6101"."name": "Xi 'an, Shaanxi province"}},"isLoop": false."trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3"."arrivalTime": "The 2020-12-19 12:00"."totalTime": "2 days, 1 hour."."remainTime": "One day, two hours."
}
Copy the code

1.6 Service description of waybill signing status

The status value The name of the meaning
0 In transit The express is in transit
1 LanShou The express has been collected by the express company
2 difficult Express 100 cannot resolve a state, or a state that requires human intervention, such as the recipient’s wrong phone number.
3 Sign after receiving STH Normal sign for it
4 Back to sign The goods are returned to the consignor for signature
5 To send a The goods are being dispatched
6 Back to the The goods are on their way back to the shipper
7 Switch to Transfer the goods to another express company
10 For customs clearance The goods await customs clearance
11 The guanzhong qing The goods are in the process of customs clearance
12 Have customs clearance The goods have completed the customs clearance process
13 Abnormal clearance The goods are abnormal in the customs clearance process
14 A visa The recipient expressly refused to accept

1.7 Application examples of trace Link

1.8 Error Return Example

{
"result":false."returnCode":"400"."message":"Can't find the corresponding company."
}
Copy the code
Information code Information Description Causes and recommended handling methods
200 The query is successful The query is successful
400 Parameter Permission Problem The data is incomplete, the corresponding company can not be found, illegal IP, please apply for authorization, this express company is not supported, the tracking number problem, etc
500 If no result is found, try again It means that the query failed and the express company did not obtain effective data
501 Server error Sometimes, if the request is not submitted according to the standard, for example, the parameters of the express company are not filled in according to the document, etc., this error will also be reported
502 Busy server The server of Express 100 is disconnected or temporarily abnormal. Please contact Express 100 for troubleshooting
503 Failed to verify the signature Check the encryption mode. The sequence of param + key + Customer is encrypted by MD5. After the encryption, the string is uppercase
601 No permission for this function No unit is available or no permissions are enabled

Check out more features like Courier query, order delivery and management, data analysis — > api.kuaidi100.com/home