文档中心
一、快递预估价格查询接口文档 二、支持的快递公司列表 API调试工具

一、快递预估价格查询接口文档

该接口提供通过收寄件地址和重量查询预估快递公司运费的功能。

1.1 接口格式

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

1.2 请求地址

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

请求参数:

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

param数据结构:

参数名是否必填类型说明
kuaidicomstring快递公司的编码,一律用小写字母,请查看参数字典
recAddrstring收件地址,如”广东深圳南山区”
sendAddrstring寄件地址,如”北京海淀区”
weightdouble重量,默认单位为kg,参数无需带单位,如1.0

1.3 返回结果

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

data数据结构

字段类型说明备注
kuaidicomstring快递公司的编码,一律用小写字母,请查看参数字典
combosarray价格详情

combos 中数据项的数据结构

字段类型说明备注
pricestring预估运费价格,单位:元
expTypelist业务或产品类型

1.4 请求参数示例

param: { "sendAddr": "深圳南山区", "recAddr": "北京海淀区", "kuaidicom": "jd", "weight": "12" }
method: price
key: 123
sign: 3B8153C7258758B5FDAD0E4AFB9A1284
t: 1724725439371


1.5 返回结果示例

成功示例:

{
    "code": 200,
    "data": {
        "kuaidicom": "jd",
        "combos": [
            {
                "price": 83.0,
                "productName": "京东标快"
            }
        ]
    },
    "message": "success",
    "time": 0,
    "success": true
}


错误示例:

{
    "code": 30001,
    "message": "weight不能为空",
    "time": 0,
    "success": false
}

 

1.6 返回信息代码含义:

信息代码信息内容描述原因及建议处理方式
-1服务器错误快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
200提交成功提交成功
30001参数错误检查参数传参是否正确
30002验证签名失败检查加密方式,param +t+key+ secret的顺序进行MD5加密,加密后字符串转32位大写,不用加上“+”号
30004账号单量不足需要充值账号单量不足需要充值
30005无快递产品或该地未开通查询业务查询价格没有结果,或者请求快递公司异常都可能返回该异常

二、支持的快递公司列表

快递公司名称编码
顺丰shunfeng
京东jd
德邦快递debangkuaidi
圆通yuantong
中通zhongtong
申通shentong
韵达yunda
EMSems