Cloud market/ Express efficiency details query
contact number
400-000-0387
Service provider
Express 100
QQ customer service
two billion eight hundred and fifty million five hundred and fifteen thousand seven hundred and forty-four
service time
09:00-18:00
Contact E-mail

Express efficiency details query

Estimated delivery time! New upgrade! The V2 version can be queried for the express efficiency details to predict the arrival time after the express is sent, accurate to the hour level, and return the relevant details.

¥ Original price:¥

Package version

zero Yuan/ twenty second
benefit forty-nine point nine zero Yuan/ ten thousand second
two hundred and sixty Yuan/ twenty-two thousand second
five hundred Yuan/ fifty-five thousand second
one thousand Yuan/ one hundred and ten thousand second
two thousand and four hundred Yuan/ three hundred and fifty thousand second
Effective duration
1 year
contact number
400-000-0387
Service provider
Express 100
QQ customer service
two billion eight hundred and fifty million five hundred and fifteen thousand seven hundred and forty-four
service time
09:00-18:00
Contact E-mail
  • API interface
  • product details
  • Delivery mode
  • Time Effective Details Query V2
Call address: http://cloud.kuaidi100.com/api
Request method: POST
Return type: JSON
Debugging tools: API Debugging>>
Request Parameters (Headers)

No parameters

Query

No parameters

Request parameters (Body)
name type Must describe
secret_key string true User authorization key
secret_code string true Interface No
secret_sign string true Encryption signature: md5 (secret_key+secret_secret) to uppercase
from string true place of departure. For example: Shenzhen, Guangdong
to string true destination. For example: Beijing
com string true Express company code, corresponding form can be downloaded in product details
orderTime string false Order placement time. The default is the current time. The format is: 2020-09-12 16:45:13
Request Example
  • curl
  • Java
  • C#
  • PHP
  • Python
                         curl  http://cloud.kuaidi100.com/api  -X POST -d \ "secret_key=***&secret_code=81bb0620fbaf460db4e6dab84a05ec00&secret_sign=md5(***)&from=&to=&com=&orderTime="
                        
                      
                         import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.net. HttpURLConnection; import java.net. URL; import java.net. URLEncoder; import java.security. MessageDigest; import java.security. NoSuchAlgorithmException; import java.util. HashMap; import java.util. Map; public class CloudDemo { public static void main (String[] args) { CloudDemo cloudDemo = new CloudDemo(); Map  params = new HashMap (); params.put("secret_key", "***"); params.put("secret_code", "81bb0620fbaf460db4e6dab84a05ec00"); params.put("secret_sign", "md5(***)"); params.put("from", ""); params.put("to", ""); params.put("com", ""); params.put("orderTime", ""); cloudDemo.post(params); } public String post(Map  params) { StringBuilder response = new StringBuilder(""); BufferedReader reader = null; try { StringBuilder builder = new StringBuilder(); for (Map.Entry  param : params.entrySet()) { if (builder.length() > 0) { builder.append('&'); } builder.append(URLEncoder.encode(param.getKey(), "UTF-8")); builder.append('='); builder.append(URLEncoder.encode(String.valueOf(param.getValue()), "UTF-8")); } byte[] bytes = builder.toString().getBytes("UTF-8"); URL url = new URL(" http://cloud.kuaidi100.com/api "); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setConnectTimeout(5000); conn.setReadTimeout(5000); conn.setRequestMethod("POST"); conn.setRequestProperty("accept", "*/*"); conn.setRequestProperty("connection", "Keep-Alive"); conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); conn.setRequestProperty("Content-Length", String.valueOf(bytes.length)); conn.setDoOutput(true); conn.getOutputStream().write(bytes); reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8")); String line = ""; while ((line = reader.readLine()) !=  null) { response.append(line); } } catch (Exception e) { e.printStackTrace(); } finally { try { if (null != reader) { reader.close(); } } catch (IOException e) { e.printStackTrace(); } } return response.toString(); } } class MD5Utils {    private static MessageDigest mdigest = null; private static char digits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'}; private static MessageDigest getMdInst() { if (null == mdigest) { try { mdigest = MessageDigest.getInstance("MD5"); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } } return mdigest; } public static String encode(String s) { if(null == s) { return ""; } try {            byte[] bytes = s.getBytes(); getMdInst().update(bytes); byte[] md = getMdInst().digest(); int j = md.length; char str[] = new char[j * 2]; int k = 0; for(int i = 0; i < j; i++) { byte byte0 = md[i]; str[k++] = digits[byte0 >>> 4 & 0xf]; str[k++] = digits[byte0 & 0xf]; } return new String(str); } catch (Exception e) { e.printStackTrace(); return null; } } }
                        
                      
                        
                         No example
                      
                         <? php $params = ""; $params .=  'secret_key=***'.'&'; $params .=  'secret_code=81bb0620fbaf460db4e6dab84a05ec00'.'&'; $params .=  'secret_sign=md5(***)'.'&'; $params .=  'from='.'&'; $params .=  'to='.'&'; $params .=  'com='.'&'; $params .=  'orderTime='.'&'; $params .=  substr($params, 0, -1); $ch = curl_init(); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_URL, ' http://cloud.kuaidi100.com/api '); curl_setopt($ch, CURLOPT_POSTFIELDS, $params); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $result = curl_exec($ch); echo $result; ?>
                        
                      
                         # coding = utf-8 import sys,os import requests,json,hashlib params = {} params['secret_key'] = '***' params['secret_code'] = '81bb0620fbaf460db4e6dab84a05ec00' params['secret_sign'] = 'md5(***)' params['from'] = '' params['to'] = '' params['com'] = '' params['orderTime'] = '' result = requests.post(' http://cloud.kuaidi100.com/api ', params) print(result.text)
                        
                      
Return parameters

No parameters

Normal return example
                     { "FromName": "Guangzhou", "fromNum": "CN440100000000", "ToName": "Kashi", "toNum": "CN653101000000", "orderTime": "2020-10-15 14:03:39", "returnCode": "200", "result": true, "Message": "Success", "TotalAvg": "6 days and 23 hours", "MayExpendTime": "7 days and 1 hour", "type": "10", "arrivalTime": "2020-10-22 15:00:00", "startTime": "2020-10-15 16:00:00", "proportionList": [ { "Day": "6 days and 23 hours", "proportion": "78.26%" } ], "maxRouteList": [ { "id": null, "Name": "Collect", "indexLevel": null, "mayStartTime": "16", "type": 0, "hourAvge": "0", "cid": "CN440112000000" }, { "id": "CN440112000000", "Name": "Huangpu District, Guangzhou City, Guangdong Province", "indexLevel": "3", "mayStartTime": "18", "type": 2, "hourAvge": "1", "cid": "CN650100000000" }, { "id": "CN650100000000", "Name": "Urumqi, Xinjiang", "indexLevel": "2", "mayStartTime": "4", "type": 1, "hourAvge": "77", "cid": "CN650107000000" }, { "id": "CN650107000000", "Name": "Aksu Township, Dabancheng District, Urumqi, Xinjiang", "indexLevel": "3", "mayStartTime": "6", "type": 1, "hourAvge": "0", "cid": "CN652900000000" }, { "id": "CN652900000000", "Name": "Xinjiang, Aksu Region", "indexLevel": "2", "mayStartTime": "2", "type": 2, "hourAvge": "34", "cid": "CN653101000000" }, { "id": "CN653101000000", "Name": "Xinjiang, Kashi Prefecture, Kashi City, Seman Township", "indexLevel": "3", "mayStartTime": "9", "type": 2, "hourAvge": "39", "cid": null }, { "id": null, "Name": "Dispatch", "indexLevel": null, "mayStartTime": "11", "type": 3, "hourAvge": "14", "cid": null }, { "id": null, "Name": "Sign in", "indexLevel": null, "mayStartTime": "11", "type": 4, "hourAvge": "2", "cid": null } ], "IsRecommendation": true,//whether it is a recommended route "RecommendFromCode": "CN440309020000",//The departure code of the recommended route "RecommendToCode": "CN653101000000",//The name of the departure place of the recommended route "RecommendFromName": "Guangdong, Shenzhen, Longhua District",//the destination code of the recommended route "RecommendToName": "Xinjiang, Kashi Prefecture, Kashi City, Seman Township"//The name of the destination of the recommended route }
                
Failure return example
                     { "returnCode": "400", "Message": "The system is busy", }
                
Status code definition
Status code Status code information describe
two hundred success

1. Time effectiveness details query V2: new upgrade, recommended! Predictable arrival time after express delivery, accurate to hour level

Tips: Since some express companies only provide domestic business or international business, some lines may have no time effective data.

 

Return Parameter Description

attribute type describe
returnCode String Corresponding code
message String describe
com String Express company code
fromName String place of departure
fromNum String code
toName String destination
toNum String code
orderTime String Order placing time (yyyy MM dd HH: mm: ss)
totalAvg String Average time consumption
type String Business type 10: ordinary, 20: fast, 30: express
arrivalTime String Predicted arrival time (example: 2020-06-27 04:00:00)
startTime String Forecast departure time (example: 2020-06-27 04:00:00)
proportionList list Proportion of days
day String day
proportion String percentage
maxRouteList list Route track
id String Node ID
name String Node name (name of administrative region)
indexLevel String Node level
mayStartTime String Predict the departure time of the current node (for example, 8 - means 8 o'clock)
type String Node type (0. Collect, 1. Trunk, 2 common paths, 3. Dispatch, 4. Sign in)
hourAvge String Node time consuming
cid String Next node code

 

2. Time effectiveness details query:

Predict the arrival time after the order is placed through the departure place, destination, order placing time and the express company, and return relevant details.

Return parameter description:

 

attribute type describe
result Boolean Judge whether the result is successful
returnCode String Corresponding code
message String describe
com String Express company code
fromName String place of departure
fromNum String code
toName String destination
toNum String code
orderTime String Order placing time (yyyy MM dd HH: mm: ss)
totalAvg String Average time consumption
type String Business type 10: ordinary, 20: fast, 30: express
arrivalTime String Forecast arrival time after order placement (yyyy MM dd a)
proportionList list Proportion of days
day String day
proportion String percentage
maxRouteList list Route track
id String Node ID
name String Node name (name of administrative region)
indexLevel String Node level
cid String Child node ID
type String Node type (0. Collect, 1. Trunk, 2 common paths, 3. Dispatch, 4. Sign in)
hourAvge String Node time consuming

 

Proportion of days

Day: refers to the transportation days.

Percentage: the percentage of this day.

 

For the express company in the parameter, please use the code corresponding to the table

Express company code table:

Express company code Name of express company
shunfeng Shunfeng Express
tiantian Daily Express
zhongtong Zhongtong Express
shentong Shentong Express
ems EMS
yunda Yunda Express
yuantong Yuantong Express
huitongkuaidi Baishi Express
zhaijisong House express
youshuwuliu Yousu Express
debangkuaidi Deppon
suer Sule Express
youzhengguonei Postal express package
ewe EWE Global Express
quanyikuaidi All One Express
minghangkuaidi Air Express
pjbest Pinjun Express
zhimakaimen Sesame Open the door
ztky China Railway Express
lianbangkuaidi FedEx
yuanchengwuliu Yuancheng Logistics
tiandihuayu Tiandi Huayu
rufengda Like wind
longbanwuliu Longbang Express
youzhengguoji International Parcel
quanfengkuaidi All Peak Express
jd Jingdong Logistics
guotongkuaidi Guotong Express
kuaijiesudi Express delivery
annengwuliu Anneng Express
dhlen DHL Global Parts
ups UPS
usps USPS
fedex FedEx international parts
dhl DHL China parts
wanxiangwuliu Vientiane Logistics
jinguangsudikuaijian Jingguang Express
yuxinwuliu Yuxin Logistics
tnt TNT
emsguoji EMS international parts
cnpex CNPEX China Post Express
zengyisudi Gain express
zyzoom Growth cross-border
bcwelt BCWELT
jiayunmeiwuliu Canada Yunmei
auexpress Australia Post China Express
euasia Eurasian special line
rrs RRS Logistics
aolau AOL Aotong Express
flyway Chengguang Express
yuanchengwuliu Yuancheng Logistics
xlobo Xlobo Beihai International
shipgce Feiyang Express
gdkd Port Express
hengluwuliu Henglu Logistics
one Click to buy now > two Confirm and pay the order > three Enter the cloud market console > four Start using API