文档中心
一、快递预估时效查询接口 二、支持的快递公司列表及业务/产品类型 API调试工具

一、快递预估时效查询接口

通过收寄件地址、下单时间和业务/产品类型来预估快递可送达的时间,以及过程需要花费的时间。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://api.kuaidi100.com/label/order

1.3 请求参数

请求参数(header)

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求参数(body)

参数名称数据类型是否必填参数描述
methodstring业务类型(默认:time)
keystring授权码,请申请企业版获取
signstring32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret可在企业管理后台中企业信息查看
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名称数据类型是否必填参数描述
kuaidicomstring快递公司编码
fromstring出发地(地址需包含3级及以上),例如:广东深圳南山区
tostring目的地(地址需包含3级及以上),例如:北京海淀区
orderTimestring下单时间,格式要求yyyy-MM-dd HH:mm:ss, 例如:2023-08-08 08:08:08
expTypestring业务或产品类型

1.4 请求参数示例

method = time
key = kytRsteof
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
	 "from": "深圳南山区金蝶软件园",
	 "to": "北京海淀区",
	 "orderTime": "2023-09-14 08:08:08",
	 "kuaidicom": "shunfeng",
	 "expType": "标准快递" 
        }

1.5 返回结果

字段类型说明备注
successboolean提交结果true提交成功,false失败
codeInt返回编码
messagestring返回报文描述
dataObject响应数据

data数据结构:

字段类型说明备注
fromNamestring出发地名称(快递100实际解析的地址)
fromNumstring出发地编码
toNamestring目的地名称(快递100实际解析的地址)
toNumstring目的地编码
arrivalTimstring预计到达时间,格式yyyy-MM-dd HH:mm:ss, 例如:2023-08-08 08:08:08
deliveryExpendTimestring到达需要花费的时间,单位天
taskIdstring任务id,建议记录用于后期排查问题
expTypestring业务或产品类型

1.6 返回结果示例

成功返回示例:

{
    "code": 200,
    "data": {
        "fromName": "广东,深圳市,南山区,金蝶软件园",
        "fromNum": "440305000000",
        "toName": "北京,北京,海淀区,",
        "toNum": "110108000000",
        "arrivalTime": "2023-09-15 18:00:00",
        "deliveryExpendTime": "2",
        "taskId": "D9F5EBF5EA114794B681C812304E5CDD"
    },
    "message": "success",
    "time": 0,
    "success": true
}

错误示例:

{
    "code": 30001,
    "message": "不支持该快递公司",
    "time": 0,
    "success": false
}

1.7 信息代码含义

信息代码信息内容描述原因及建议处理方式
-1服务器错误快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
200成功成功
30001参数错误请根据技术文档请求,注意参数类型及是否必填。
30002验证签名失败检查加密方式,param +t+key+ secret的顺序进行MD5加密,加密后字符串转32位大写,不用加上“+”号
30003账号信息不正确检查key是否正确
30005快递公司返回异常按照描述可以自行检查参数的数据类型是否正确

二、支持的快递公司列表及业务/产品类型

快递公司名称 业务/产品类型
京东快递(jd) 特快送
特惠送
跨越(kuayue) 当天达
次日达
隔日达
陆运件
同城次日
同城即日
省内次日
省内即日
空运
专运