快递可用性接口

通过收寄件地址判断该线路是否可寄送，返回内容包括寄件地址可达性，收件地址可达性，以及可提供寄件服务的快递公司。

param数据结构

参数名称	数据类型	是否必填	参数描述
recManName	string	是	收件人姓名
recManMobile	string	是	收件人的手机号
recManPrintAddr	string	是	收件人所在完整地址（至少到四级地址，即省-市-区-街道），如广东深圳市深圳市南山区粤海街道科技南十二路2号金蝶软件园
sendManName	string	是	寄件人姓名
sendManMobile	string	是	寄件人的手机号
sendManPrintAddr	string	是	寄件人所在完整地址（至少到四级地址，即省-市-区-街道），如广东深圳市深圳市南山区粤海街道科技南十二路2号金蝶软件园
kuaidicom	string	是	快递公司编码，如yuantong，shunfeng，一次仅支持传入一家快递公司，支持的快递公司及编码见本文档1.8 支持快递公司列表

1.7 信息代码含义

信息代码	信息内容描述	原因及建议处理方式
200	成功	成功
201	参数异常	检查地址行政区相关参数
400	行政区解析失败	检查地址中行政区域信息是否正确、完整
503	验证签名失败	检查加密方式，param +t+key+ secret的顺序进行MD5加密，加密后字符串转32位大写,不用加上“+”号
601	key已过期	没有可用单量，账号不存在或者没有该接口权限
600	您不是合法的用户	授权key出错或账户无可用单量

二、支持快递公司列表

快递公司名称	编码
圆通	yuantong
顺丰速运	shunfeng
京东快递	jd
中通快递	zhongtong
中通快运	zhongtongkuaiyun
申通快递	shentong
韵达快递	yunda
EMS	ems
极兔速递	jtexpress
德邦快递	debangkuaidi
邮政快递包裹	youzhengguonei
丰网速运	fengwang

curl --location --request POST 'http://api.kuaidi100.com/reachable.do' \ --data-urlencode 'method=' \ --data-urlencode 'key=' \ --data-urlencode 'sign=' \ --data-urlencode 't=' \ --data-urlencode 'param='

{ "message": "成功", "returnCode": "200", "result": true, "data": { "taskId": "E9E0AA920791542C8D491968DC5601E3", "toReachable": [ { "reachable": 1, "expressCode": "yuantong" } ] } }

请求参数

Body 参数application/x-www-form-urlencoded

method

string

必需

业务类型（默认：reachable）

key

string

必需

授权码，请申请企业版获取

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号，secret可在企业管理后台中企业信息查看

string

必需

时间戳如：1576123932000

param

string

由其他字段拼接

必需

返回响应

🟢200成功

application/json

Body

message

string

返回报文描述

必需

returnCode

string

返回编码

必需

result

boolean

提交结果

必需

true提交成功，false失败

data

object

必需

taskId

string

任务ID

必需

toReachable

array [object {3}]

地址可达性校验

必需

1.7 信息代码含义#

二、支持快递公司列表#

请求参数

返回响应

1.7 信息代码含义

二、支持快递公司列表