云市场 / 快递时效明细查询
联系电话
400-000-0387
服务商
快递100
QQ客服
2850515744
服务时间
09:00-18:00
联系邮箱

快递时效明细查询

预估快递到达时间!全新升级!快递时效明细查询V2版本,可预测快递寄出后的到达时间,精确到小时级,并返回相关明细。

¥ 原价:¥

套餐版本

0.00元/20
49.90元/10000
260.00元/22000
500.00元/55000
1000.00元/110000
2400.00元/350000
有效时长
1年
联系电话
400-000-0387
服务商
快递100
QQ客服
2850515744
服务时间
09:00-18:00
联系邮箱
  • API接口
  • 产品详情
  • 交付方式
  • 时效明细查询
  • 时效明细查询V2
调用地址: http://cloud.kuaidi100.com/api
请求方式: POST
返回类型: JSON
API 调用: API调用说明>>
调试工具: API调试>>
请求参数(Headers)

无参数

请求参数(Query)

无参数

请求参数(Body)
名称 类型 是否必须 描述
secret_key string true 用户授权key
secret_code string true 接口编号
secret_sign string true 加密签名:md5(secret_key+secret_secret)转大写
param string true param示例为:{"from":"北京","to":"深圳", "com":"shunfeng","type":"10", "orderTime":"2017-05-31 08:09:22"}
请求示例
  • curl
  • Java
  • C#
  • PHP
  • Python

curl http://cloud.kuaidi100.com/api -X POST -d "secret_key=***&secret_code=60d6fa8809134c40879e5f0a7228183e&secret_sign=md5(***)¶m="

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<String, String> params = new HashMap<String, String>();

        params.put("secret_key", "***");

        params.put("secret_code", "60d6fa8809134c40879e5f0a7228183e");

        params.put("secret_sign", "md5(***)");

        params.put("param", "");

        cloudDemo.post(params);

    }

    public String post(Map<String, String> params) {

        StringBuilder response = new StringBuilder("");

        BufferedReader reader = null;

        try {

            StringBuilder builder = new StringBuilder();

            for (Map.Entry<String, String> 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(3000);

            conn.setReadTimeout(3000);

            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();

            }

        }

        returnresponse.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();

            }

        }

        returnmdigest;

    }

    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;

        }

    }

}

<?php

    $params = "";

    $params .= 'secret_key=***'.'&'

    $params .= 'secret_code=60d6fa8809134c40879e5f0a7228183e'.'&'

    $params .= 'secret_sign=md5(***)'.'&'

    $params .= 'param='.'&'

    $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'] = '60d6fa8809134c40879e5f0a7228183e'

params['secret_sign'] = 'md5(***)'

params['param'] = ''

result = requests.post('http://cloud.kuaidi100.com/api', params)

print(result.text)

正常返回示例
{ "result": true, //结果是否成功 "returnCode": "200", //编码 "message": "成功", //描述 "fromName": "北京", //出发地 "fromNum": "CN110000000000", //编码 "toName": "广东,深圳市", //目的地 "toNum": "CN440300000000", //编码 "com": "huitongkuaidi", //快递公司编码 "totalAvg": "2.6", //平均耗时 "type": "10", //业务类型,10:普通,20:快,30:特快 "orderTime": "2017-05-31 19:51", //下单时间 "arrivalTime": "2017-06-03 PM", //预测下单后到达时间 "proportionList": [ //天数占比 { "day": "1.0", //天数 "proportion": "70.8%" //百分比 }, { "day": "6.0", "proportion": "29.2%" } ], "maxRouteList": [ //路由轨迹 { "id": "CN110000000000", //节点ID "name": "北京", //节点名称(行政区名称) "indexLevel": 1, //节点层级 "cid": "CN440300000000", //子节点ID "type": 2, //节点类型(0.揽收,1.干线,2普通路径,3.派件,4.签收) "hourAvge": "46" //节点耗时 }, { "id": "CN440300000000", "name": "广东,深圳市", "indexLevel": 2, "cid": "CN440304000000", "type": 1, "hourAvge": "8" }, { "id": "CN440304000000", "name": "广东,深圳市,福田区", "indexLevel": 3, "cid": "000001", "type": 2, "hourAvge": "2" }, { "id": "000001", "name": "派件", "indexLevel": 4, "cid": "000002", "type": 3, "hourAvge": "4" }, { "id": "000002", "name": "签收", "indexLevel": 5, "cid": null, "type": 4, "hourAvge": "0" } ] }
失败返回示例
{ "returnCode": "400", "message": "参数错误", }
状态码定义
状态码 状态码信息 描述
200 成功
201 无结果
400 参数错误
500 服务器错误
502 服务器繁忙
20001 接口超时 接口超时
调用地址: http://cloud.kuaidi100.com/api
请求方式: POST
返回类型: JSON
API 调用: API调用说明>>
调试工具: API调试>>
请求参数(Headers)

无参数

请求参数(Query)

无参数

请求参数(Body)
名称 类型 是否必须 描述
secret_key string true 用户授权key
secret_code string true 接口编号
secret_sign string true 加密签名:md5(secret_key+secret_secret)转大写
from string true 出发地。例如:广东深圳
to string true 目的地。例如:北京
com string true 快递公司编码,对应表格可在产品详情中下载
orderTime string false 下单时间。默认为当前时间,格式为:2020-09-12 16:45:13
请求示例
  • 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<String, String> params = new HashMap<String, String>();

        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<String, String> params) {

        StringBuilder response = new StringBuilder("");

        BufferedReader reader = null;

        try {

            StringBuilder builder = new StringBuilder();

            for (Map.Entry<String, String> 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(3000);

            conn.setReadTimeout(3000);

            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();

            }

        }

        returnresponse.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();

            }

        }

        returnmdigest;

    }

    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;

        }

    }

}

<?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)

正常返回示例
{ "fromName": "广州", "fromNum": "CN440100000000", "toName": "喀什", "toNum": "CN653101000000", "orderTime": "2020-10-15 14:03:39", "returnCode": "200", "result": true, "message": "成功", "totalAvg": "6天23小时", "mayExpendTime": "7天1小时", "type": "10", "arrivalTime": "2020-10-22 15:00:00", "startTime": "2020-10-15 16:00:00", "proportionList": [ { "day": "6天23小时", "proportion": "78.26%" } ], "maxRouteList": [ { "id": null, "name": "揽收", "indexLevel": null, "mayStartTime": "16", "type": 0, "hourAvge": "0", "cid": "CN440112000000" }, { "id": "CN440112000000", "name": "广东,广州市,黄埔区", "indexLevel": "3", "mayStartTime": "18", "type": 2, "hourAvge": "1", "cid": "CN650100000000" }, { "id": "CN650100000000", "name": "新疆,乌鲁木齐市", "indexLevel": "2", "mayStartTime": "4", "type": 1, "hourAvge": "77", "cid": "CN650107000000" }, { "id": "CN650107000000", "name": "新疆,乌鲁木齐市,达坂城区,阿克苏乡", "indexLevel": "3", "mayStartTime": "6", "type": 1, "hourAvge": "0", "cid": "CN652900000000" }, { "id": "CN652900000000", "name": "新疆,阿克苏地区", "indexLevel": "2", "mayStartTime": "2", "type": 2, "hourAvge": "34", "cid": "CN653101000000" }, { "id": "CN653101000000", "name": "新疆,喀什地区,喀什市,色满乡", "indexLevel": "3", "mayStartTime": "9", "type": 2, "hourAvge": "39", "cid": null }, { "id": null, "name": "派件", "indexLevel": null, "mayStartTime": "11", "type": 3, "hourAvge": "14", "cid": null }, { "id": null, "name": "签收", "indexLevel": null, "mayStartTime": "11", "type": 4, "hourAvge": "2", "cid": null } ], "isRecommend": true, //是否是推荐路线 "recommendFromCode": "CN440309020000", //推荐路线的出发地编码 "recommendToCode": "CN653101000000", //推荐路线的出发地名称 "recommendFromName": "广东,深圳市,龙华区", //推荐路线的目的地编码 "recommendToName": "新疆,喀什地区,喀什市,色满乡" //推荐路线的目的地名称 }
失败返回示例
{ "returnCode": "400", "message": "系统繁忙", }
状态码定义
状态码 状态码信息 描述
200 成功

1、时效明细查询V2:全新升级,推荐使用!可预测快递寄出后的到达时间,精确到小时级

温馨提示:因部分快递公司只提供国内业务或只提供国际业务,部分线路会出现无时效数据的情况。

 

返回参数说明

 

属性

类型

描述

returnCode

String

对应编码

message

String

描述

com

String

快递公司编码

fromName

String

出发地

fromNum

String

编码

toName

String

目的地

toNum

String

编码

orderTime

String

下单时间(yyyy-MM-dd HH:mm:ss

totalAvg

String

平均耗时

type

String

业务类型10:普通,20:快,30:特快

arrivalTime

String

预测到达时间(示例:2020-06-27 04:00:00

startTime

String

预测出发时间示例:2020-06-27 04:00:00

proportionList

list

天数占比

    day

String

    proportion

String

百分比

maxRouteList

list

路由轨迹

    id

String

节点ID

name

String

节点名称(行政区名称)

indexLevel

String

节点层级

mayStartTime

String

预测当前节点出发时间(比如:8-代表8点出发)

type

String

节点类型(0.揽收,1.干线,2普通路径,3.派件,4.签收)

hourAvge

String

节点耗时

cid

String

下一节点编码

 

 

2、时效明细查询:

通过出发地、目的地、下单时间和快递公司,预测下单后到达时间,并返回相关明细。

返回参数说明:

属性

类型

描述

result

Boolean

判断结果是否成功

returnCode

String

对应编码

message

String

描述

com

String

快递公司编码

fromName

String

出发地

fromNum

String

编码

toName

String

目的地

toNum

String

编码

orderTime

String

下单时间(yyyy-MM-dd HH:mm:ss

totalAvg

String

平均耗时

type

String

业务类型10:普通,20:快,30:特快

arrivalTime

String

预测下单后到达时间(yyyy-MM-dd a

proportionList

list

天数占比

    day

String

    proportion

String

百分比

maxRouteList

list

路由轨迹

    id

String

节点ID

name

String

节点名称(行政区名称)

indexLevel

String

节点层级

cid

String

子节点ID

type

String

节点类型(0.揽收,1.干线,2普通路径,3.派件,4.签收)

hourAvge

String

节点耗时

 

 天数占比

天:指运输的天数。

百分比:该天数所占的百分比。


参数中的快递公司请使用该表对应的编码

快递公司编码表:

快递公司编码 快递公司名称
shunfeng 顺丰速运
tiantian 天天快递
zhongtong 中通快递
shentong 申通快递
ems EMS
yunda 韵达快递
yuantong 圆通速递
huitongkuaidi 百世快递
zhaijisong 宅急送
youshuwuliu 优速快递
debangkuaidi 德邦
suer 速尔快递
youzhengguonei 邮政快递包裹
ewe EWE全球快递
quanyikuaidi 全一快递
minghangkuaidi 民航快递
pjbest 品骏快递
zhimakaimen 芝麻开门
ztky 中铁快运
lianbangkuaidi 联邦快递
yuanchengwuliu 远成物流
tiandihuayu 天地华宇
rufengda 如风达
longbanwuliu 龙邦速递
youzhengguoji 国际包裹
quanfengkuaidi 全峰快递
jd 京东物流
guotongkuaidi 国通快递
kuaijiesudi 快捷速递
annengwuliu 安能快运
dhlen DHL-全球件
ups UPS
usps USPS
fedex FedEx-国际件
dhl DHL-中国件
wanxiangwuliu 万象物流
jinguangsudikuaijian 京广速递
yuxinwuliu 宇鑫物流
tnt TNT
emsguoji EMS-国际件
cnpex CNPEX中邮快递
zengyisudi 增益速递
zyzoom 增速跨境
bcwelt BCWELT
jiayunmeiwuliu 加运美
auexpress 澳邮中国快运
euasia 欧亚专线
rrs 日日顺物流
aolau AOL澳通速递
flyway 程光快递
yuanchengwuliu 远成物流
xlobo Xlobo贝海国际
shipgce 飞洋快递
gdkd 港快速递
hengluwuliu 恒路物流
1 点击立即购买 > 2 确认并支付订单 > 3 进入云市场控制台 > 4 开始使用API