快递查询

授权正常

#接口说明

接口地址：cha_kuaidi/getData
请求方法：post
响应格式：json
格式说明：API响应为标准接口格式：{"code":200, "message":"success", "data":[]}，响应参数仅为data中的参数。

#业务参数

业务参数为请求参数的一部分。

名称	类型	必填	说明
number	string	是	快递单号

#响应参数

响应参数为data字段中的变量。

名称	说明
time	更新时间
ftime
context	快递更新信息
location	定位

#响应示例

此示例为业务响应参数data的示例。

[{"time": "2024-11-29 18:34:47", "ftime": "2024-11-29 18:34:47", "context": "【驿站】包裹已签收！如有问题请联系：代收点13237356608，您的快递已经妥投，投诉电话：0205171394。起早贪黑不停忙，如有不妥您见谅，好评激励我向上，求个五星暖心房。", "location": "T驿站"}, {"time": "2024-11-29 09:11:23", "ftime": "2024-11-29 09:11:23", "context": "【广州市】广东广州开二营业部 的快递员(何云阳/17836228813)正在为您派送(有事呼叫我，勿找平台，少一次投诉，多一份感恩)", "location": "T广州市"}, {"time": "2024-11-28 22:31:40", "ftime": "2024-11-28 22:31:40", "context": "【广州市】快件已到达 广州良田中心分公司 咨询电话：95543", "location": "T广州市"}, {"time": "2024-11-28 21:02:53", "ftime": "2024-11-28 21:02:53", "context": "【广州市】广东广州天河区龙洞公司已揽收", "location": "T广州市"}]

#公共响应

仅响应格式为json时参考。

名称	说明
code	业务响应状态码 200:成功其他:失败
message	业务响应说明
data	业务响应参数，只有code=200时才有此参数。具体参数请看对应API的“响应参数”

#公共请求

名称	类型	必填	说明
timestamp	string	是	请求时间戳
appkey	string	是	开放平台分配的appkey
sign	string	是	签名，具体签名方法请下方查看

#请求说明

appkey

为确保API不被滥用，保证使用用户的友好体验和权益，API采用`appKey + appSecret`的方式鉴权。

请求地址

完整的请求地址为：接口网关+接口地址
接口网关请移步到右侧“用户中心”查看

签名

如已申请appKey，例如分配的appKey为123，appSecret为456。
1、按照API文档，组装完整的请求参数（公共请求 + 业务参数）。
2、剔除sign参数，并剔除参数中非字符串（如：数组、对象、文件），以及value为空的参数，并按照ASCII递增排序。
3、将参数以“keyValue”的形式拼接字符串，如参数是：appkey=123&qq=123456& timestamp=1733811622，则生成的字符串应为：appkey123qq123456timestamp1733811622。
4、在字符串最后拼接上appSecret，进行MD5加密，并转成大写。
以上述为例，最后签名的字符串应为：appkey123qq123456timestamp1733811622456；
将此字符串进行MD5加密，并转换成大写。

#SDK

SDK中有 PHP、 Python、 Java、 Nodejs 语言的DEMO示例。

SDK下载地址：https://share.weiyun.com/hslYHztV