- API
- 物流轨迹查询
GET/query
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://chawuliu.market.alicloudapi.com/query
GET
JSON
接口参数
无参数
字段名称 | 必填 | 字段详情 |
---|---|---|
kddh string | Y | 快递单号 实例值: JT3084671970540 |
code string | N | 快递代码(非必传) |
tel string | N | 例如顺丰快递,需传入4位收/发件人手机尾号(非必传) |
无参数
商品介绍
产品亮点
产品说明
产品概述:
支持网络图片或base图像信息,精准识别出图片中的文字,支持手写文字识别。
本软件已取得软件著作权登记号:2023SR0934849《基于云市场API交付的物流快递查询软件》。软著列表还有2022SR0292875《快递物流API智能管理系统》,2022SR0292988《拇指云物流快递API智能管理系统》等。拇指云软件深耕快递查询已有十年历史之久,早期2014年首次与申通快递达成微电商系统的查询API,持续与头部企业合作,演变成今日支持全国各大物流快递类型的轨迹查询。
Aliyun零代码调用平台URL: https://www.zpzzq.com/ali/cmapi00066985.do
使用说明: Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利,使你们能快速、直观地了解API的功能、性能等指标,掌握其核心功能,无需深入技术细节。促进产品团队与技术团队之间的沟通与协作,使双方能更高效地交流想法与需求,共同推动产品快速迭代与优化。降低部门沟通成本,提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台,我们不会保存您AppCode的重要凭证,请注意您浏览器Cookie的安全性,方可放心使用。
请求参数(Query):
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
快递代码 | code | 否 | String(20) | zhongtong | 快递代码 |
快递单号 | kddh | 是 | String(20) | JT3084743373888 | 快递单号 |
4位手机尾号 | tel | 否 | String(14) | 8888 | 例如顺丰快递,需传入4位收/发件人手机尾号(非必传) |
成功响应(Json):
{ "ok": 1, "msg": "查询成功", "status": 2, "kdmc": "中通快递", "kddh": "78627****758", "data": [{ "time": "2022-10-27 19:18:40", "content": "【泉州市】 快件离开 【福建营销部】 已发往 【泉州中转部】" }, { "time": "2022-10-27 19:13:12", "content": "【泉州市】 【福建营销部】(189*****0) 的 舒宝(189*****0) 已揽收" }] } |
成功响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 1 | 成功标识:1成功,0失败 |
msg | string | 查询成功 | 报文成败描述 |
status | number | 2 | 状态码 |
kdmc | string | 中通快递 | 快递名称 |
kddh | string | 78627****758 | 快递单号 |
data | array | [...] | 查询结果数据包 |
time | string | 2022-10-27 19:18:40 | 跟踪时间 |
content | string | 【泉州市】 快件离开 【福建营销部】 已发往 【泉州中转部】 | 跟踪内容 |
失败响应(Json):
{ "ok": 0, "msg": "请传入快递单号【kddh字段】", "status": 0, "kdmc": "", "kddh": "", "data": [] } |
失败响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 0 | 成功标识:1查询成功,0失败(不计费) |
msg | string | 请传入快递单号【kddh字段】 | 报文成败描述 |
常见的失败类型:
ok | msg | 解决方式 |
---|---|---|
0 | 未传入快递单号kddh | 请传入kddh快递单号 |
0 | 请传入快递单号【kddh字段】 | 请传入kddh快递单号 |
0 | 传入快递单号kddh字符串长度超限 | 不得超过20个字符 |
0 | 传入快递代码code字符串长度超限 | 不得超过20个字符 |
0 | 传入4位手机尾号tel字符串长度超限 | 不得超过14个字符 |
0 | 手机尾号非法格式 | 请检查手机尾号是否符合要求 |
0 | 接口已升级,电话号码请传入另一个字段【tel】 | 请注意传入参数,请检查 |
1 | 查询失败:快递单号错误 | 传入kddh不符合标准,请检查 |
1 | 单号格式不正确 | 传入kddh不符合标准,请检查 |
1 | 查询成功,暂无记录 | 当前无轨迹信息,稍后再查 |
1 | 查询成功,无法匹配物流类型 | 请检查code类型 |
1 | 查询失败:无效单 | 请检查kddh是否符合标准 |
0 | 未传入开发者账号appid | 对接拇指云自研平台才出现:请传入appid开发者账号。 |
0 | 传入开发者账号appid字符串长度超限 | 对接拇指云自研平台才出现:appid字符串长度不得超过32个字符。 |
0 | 未传入查询时间sendtime | 对接拇指云自研平台才出现:请传入sendtime时间戳。 |
0 | 传入查询时间sendtime字符串长度超限 | 对接拇指云自研平台才出现:请检查传入sendtime时间戳的长度。 |
0 | 时间戳超时,请重新请求 | 对接拇指云自研平台才出现:传入sendtime时间戳误差不得超过5分钟。 |
0 | 未传入签名sign | 对接拇指云自研平台才出现:请传入sign签名结果。 |
0 | 传入签名sign字符串长度超限 | 对接拇指云自研平台才出现:请检查传入sign签名的长度。 |
0 | 签名校验失败 | 对接拇指云自研平台才出现:请参照平台签名校验流程进行对比调试。 |
0 | 存在*字符,视为调试数据。止于当前结果。 | 对接拇指云自研平台才出现:传入的参数值包含*字符,都将视为测试数据,仅用于调试。 |
0 | 非法来源 | 禁止将API用于任何形式的攻击行为,请注意。 |
0 | appid:XXXXXXX接口已停用 | 对接拇指云自研平台才出现:XXXXXXX开发者已被拇指云停止调用。 |
1、次数扣减规则
阿里云的次数扣减规则基于http响应状态码执行,只有当http响应状态码为200~300范围内时,才会扣减调用次数。对于非200系列的响应状态码,您需要自行处理响应,并获取响应中的JSON数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
若调用成功,返回的JSON数据包中的“OK”字段值为1,且http响应状态码为200。在这种情况下,阿里云会进行计费。
若调用失败,返回的JSON数据包中的“OK”字段值可能为0或其他非1的值,失败的具体原因会在“msg”字段中描述。此时http响应状态码被设置为666,阿里云不会对此次调用进行计费。
当调用次数用尽时,返回http响应状态码403,并附带消息“Quota Exhausted”。此时您只需续费即可恢复正常使用。
2、请求参数合法和准确性
① 开发者在使用API进行数据处理时,保证数据的准确性和完整性,不得进行任何篡改或伪造数据的行为。
② 在使用API的过程中,开发者应采取必要的安全措施,确保数据不被未授权访问或泄露,保障数据安全。
③ 开发者使用该接口时,确保遵守所有相关法律法规,不得将其用于任何非法或侵犯他人隐私的行为。
④ 开发者应定期对API的使用情况进行审计,确保使用行为始终符合规定要求,并进行必要的调整和改进。
⑤ 开发者不得将API用于任何形式的攻击行为,包括但不限于网络攻击、数据洪峰等。
⑥ 本接口适用于市场调研、商业合作、风险评估等多种场景,开发者可以根据实际需求合理使用。
⑦ 如发现API存在安全漏洞或潜在风险,开发者应立即停止使用并通知我们进行处理。
⑧ 开发者在使用API时,应尊重并保护我们的知识产权,不进行任何侵犯版权、商标等合法权益的行为。
1、消息提醒设置
您可以通过【消息中心·基本接收管理】https://notifications.console.aliyun.com/#/subscribeMsg进行相应设置,以避免因次数耗尽而影响业务运行。
2、发票开具与申请
您可以通过【费用与成本·发票管理】https://usercenter2.aliyun.com/invoice/create-by-detail/aliyun进行发票申请。我们将为您提供数电发票,支持普通电子发票和电子专票的开具。
3、开发密钥查看
您可以通过【已购买的服务】https://market.console.aliyun.com/imageconsole/index.htm 中对应我们的产品,查看AppKey/AppSecret或appCode。该界面您还可以查阅调用量、到期时间等概要信息。
4、服务热线
有任何疑问或建议,欢迎拨打服务热线:4009030002 转16250,我们的服务时间为:工作日09:00-18:00。
产品参数
交付方式 | API |
开票主体 | 拇指云(厦门)软件有限公司 |
所属类目 | 车辆交通与物流 |
上架日期 | 2024-08-02 |
售后支持范围
产品资质
商品价格(此处价格仅供参考,实际价格以选配后的价格为准)
版本名称 | 计费项 | 新购 |
2元尝鲜 | 版本基础价格 | 2元 |
76元2万次 / 3厘8 | 版本基础价格 | 76元 |
360元10万次 / 3厘6 | 版本基础价格 | 360元 |
1980元60万次 / 3厘3 | 版本基础价格 | 1980元 |
6000元200万次 / 3厘 | 版本基础价格 | 6000元 |
28000元1000万次 / 2厘8【2年】 | 版本基础价格 | 28000元 |
使用指南
立即下载服务商
拇指云(厦门)软件有限公司
- 数据与API
- 专业服务
用户评论
暂无评价