Cloud market/ Express efficiency 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 query

Estimated delivery time! New upgrade! Time effective query of V2 version can predict the arrival time of express delivery, accurate to the hour level.

¥ Original price:¥

Package version

zero Yuan/ twenty second
benefit twenty-nine point nine zero Yuan/ ten thousand second
two hundred Yuan/ twenty-two thousand second
four hundred Yuan/ fifty-five thousand second
eight hundred Yuan/ one hundred and ten thousand second
one thousand nine hundred and fifty 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 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
orderTime string true Order placement time. The default is the current time. The format is: 2020-09-12 16:45:13
companyList string false List of courier companies. Optional. After this parameter is passed in, only the time effectiveness of the corresponding express company will be returned. For example: huitongkuaidi, tiantian, zhangjison, zhongtong, shentong, yunda, jd, yuantong
Request Example
  • curl
  • Java
  • C#
  • PHP
  • Python
                         curl  http://cloud.kuaidi100.com/api  -X POST -d \ "secret_key=***&secret_code=4cdfccdf64ea4088a94eb2ea1ef40c97&secret_sign=md5(***)&from=&to=&orderTime=&companyList="
                        
                      
                         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", "4cdfccdf64ea4088a94eb2ea1ef40c97"); params.put("secret_sign", "md5(***)"); params.put("from", ""); params.put("to", ""); params.put("orderTime", ""); params.put("companyList", ""); 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=4cdfccdf64ea4088a94eb2ea1ef40c97'.'&'; $params .=  'secret_sign=md5(***)'.'&'; $params .=  'from='.'&'; $params .=  'to='.'&'; $params .=  'orderTime='.'&'; $params .=  'companyList='.'&'; $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'] = '4cdfccdf64ea4088a94eb2ea1ef40c97' params['secret_sign'] = 'md5(***)' params['from'] = '' params['to'] = '' params['orderTime'] = '' params['companyList'] = '' result = requests.post(' http://cloud.kuaidi100.com/api ', params) print(result.text)
                        
                      
Return parameters
field type explain remarks
fromName String Departure, e.g. Shenzhen, Guangdong
fromNum String Address Country Code
toName String Destination, e.g. Shenzhen, Guangdong
toNum String Address Country Code
orderTime String Query time
data.com String Express company code
data.totalAvg String Average time
data.type String Express delivery type
data.arrivalTime String Estimated time of arrival
data.startTime String Estimated time of receiving parts
data.mayExpendTime String Estimated time
Normal return example
                     { "returnCode": "200", "Message": "Success", "data": [ { "com": "shunfeng", "TotalAvg": "4 hours a day", "type": "10", "arrivalTime": "2020-07-05 06:00:00", "startTime": "2020-07-04 2:00:00", "MayExpendTime": "13 hours a day" }, { "com": "yunda", "TotalAvg": "23 hours a day", "type": "10", "arrivalTime": "2020-07-05 21:00:00", "startTime": "2020-07-03 22:00:00", "MayExpendTime": "2 days and 4 hours" } ], "FromName": "Nanshan District", "fromNum": "CN440305000000", "ToName": "Nanning", "toNum": "CN450100000000", "orderTime": "2020-07-03 17:24:05" }
                
Failure return example
                     { "returnCode": "400", "Message": "The system is busy", }
                
Status code definition
Status code Status code information describe
two hundred success
ten thousand and three Missing required parameter
ten thousand and four The line has no time effective data/address resolution exception temporarily Please confirm that the address is correct
-1 The system is busy, please try again later

The arrival time after express delivery can be predicted by the departure place, destination and order time, accurate to the hour level.

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

Upgrade description:

Time effective query V2 is recommended, accurate to the hour;

Users who have accessed the old version can query the V2 version by modifying the parameter usage time effect, without repeated purchase.

 

Return parameter description:

name

type

Required

Default

returnCode

string

true

Status code

message

string

true

detailed information

data

array[object]

true

 

  com

string

true

Courier Services Company

  weigth

string

true

Average time consumption

  type

string

true

Express delivery type

  arrivalTime

string

true

Predicted arrival time

  startTime

string

true

Predicted departure time

  mayExpendTime

string

true

Forecast time

fromName

string

true

starting point

fromNum

string

true

Starting point code

toName

string

true

destination

toNum

string

true

Destination code

orderTime

string

true

Order time

 

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
jtexpress Jitu Express
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