什么是小递查查快递查询API?

小递查查快递查询API有哪些核心功能？

小递查查快递查询API的技术原理是什么？

小递查查快递查询API的核心优势是什么？

小递查查快递查询API的能力有哪些？

小递查查API接口文档

Express Tracking API Interface

 

1. 接口概述

小递查查快递查询API接口是一款专注于物流全链路监控的高性能接口服务，与市场同类产品相比，具备以下核心差异化优势：

• 丰富字段信息：提供40+物流信息字段，包含揽收员、派送员、网点电话、转运中心等详细信息
• 完整监控预警：7大超时预警标记字段（揽收/发出/到达/中转/停滞/派件/签收），实时监控物流异常状态
• 精准时效分析：6大时效时长字段（揽收到发出/到达/中转/停滞/派件/签收），精确到分钟级的时效统计

接口采用 IP认证+签名 双重安全机制，支持1000+家物流商实时跟踪，平均响应时长仅200ms，为企业提供稳定、高效、安全的物流数据服务。

1.1 基本信息

项目	说明
报文格式	Json格式
编码格式	utf-8: application/x-www-form-urlencoded;charset=utf-8 ,交互协议上统一用UTF-8，避免传递中文数据出现乱码请求
请求方式	POST请求
支持格式	只支持Json格式、UTF-8编码
接口地址	https://api.xdccy.com/IsvApi/GetXdccTrackInfoV2
平均响应时长	200ms
请求超时时间	8000ms
请求频率限制	无限制
通信协议	小递查查 API 接口通过 HTTPS 进行通信，提供高安全性的通信通道

 

2. 接口安全机制（签名规则）

小递查查与第三方系统对接采用IP认证+签名的安全方案，核心用于防止数据篡改和身份认证，具体规则如下：

2.1 核心目标

• 防止数据在传输过程中被篡改；
• 验证接口调用方的合法身份。

2.2 签名生成规则

2.2.1 POST请求必传参数

参数名	说明
RequestData	业务请求数据（需做URL编码，编码格式：UTF-8）
PlatformID	小递查查分配的平台ID（根据用户行业分类分配）
DataSign	数据签名（核心校验字段，生成规则见2.2.2）

 

2.2.2 DataSign签名生成步骤

1. 拼接原始字符串：请求内容(未URL编码的RequestData) + APIKey（APIKey为小递查查分配的密钥，与PlatformID一一对应）；
2. 对拼接后的字符串进行MD5加密；
3. 将MD5加密结果进行Base64编码；
4. 对Base64编码结果做URL（UTF-8）编码，最终得到DataSign。

2.2.3 签名校验逻辑

接收方（小递查查）收到参数后，按以下步骤校验：

5. 通过PlatformID获取对应的APIKey；
6. 提取未编码的RequestData，拼接APIKey后重复「MD5加密→Base64编码」流程；
7. 将生成的摘要与接收到的DataSign（解码后）对比，一致则数据未篡改且身份合法，不一致则拒绝处理。

2.3 签名生成示例

示例参数

参数	值
原始RequestData（JSON）	{'MemberID':'123','Tel':'8789','No':'118954907573','ReturnFormat':'JSON'}
PlatformID	123（示例，不可实际使用）
APIKey	66da2cf8-c8a2-14b2-b6fa-176cd7d1ba18（示例，不可实际使用）

 

生成步骤

步骤	结果
MD5加密后	42e8b3d72bc5036697443df68362f8ba
MD5加密+Base64编码后	NDJlOGIzZDcyYmM1MDM2Njk3NDQzZGY2ODM2MmY4YmE=
MD5加密+Base64结果URL编码后（最终DataSign）	NDJlOGIzZDcyYmM1MDM2Njk3NDQzZGY2ODM2MmY4YmE%3d

 

拼接签名原始串

{'MemberID':'123','Tel':'8789','No':'118954907573','ReturnFormat':'JSON'}66da2cf8-c8a2-14b2-b6fa-176cd7d1ba18

 

RequestData 原报文URL编码（UTF-8）

%7b%27MemberID%27%3a%27123%27%2c%27Tel%27%3a%278789%27%2c%27No%27%3a%27118954907573%27%2c%27ReturnFormat%27%3a%27JSON%27%7d

 

最终发送的POST参数

PlatformID=123&RequestData=%7b%27MemberID%27%3a%27123%27%2c%27Tel%27%3a%278789%27%2c%27No%27%3a%27118954907573%27%2c%27ReturnFormat%27%3a%27JSON%27%7d&DataSign=NDJlOGIzZDcyYmM1MDM2Njk3NDQzZGY2ODM2MmY4YmE%3d

 

3. 报文格式

3.1 数据格式

采用 JSON 格式，编码为 UTF-8。

3.2 整体报文结构

节点名称	数据类型	是否必填	说明
Code	Integer	是	接口返回状态码，200 为成功
Message	String	是	接口返回状态描述
DebugMsg	String	是	调试信息（与 Message 一致）
Data	Object	是	物流核心数据对象

 

4. 请求参数说明

名称	类型(字符长度)	是否必须	说明
PlatformID	String	是	平台ID，小递查查提供
DataSign	String	是	签名数据（按2.2规则生成）
RequestData	String	是	业务请求数据（URL编码）
MemberID	String(20)	是	会员唯一ID（嵌套在RequestData中）
Tel	String(15)	条件选填（顺丰，中通必填）	发件人或收件人手机号后四位（嵌套在RequestData中）
ReturnFormat	String	否	返回格式，默认返回字符串，传值：JSON 或者 String
No	String	是	运单号

 

5. 核心数据节点（Data）详解

5.1 基础信息字段

字段名称	数据类型	是否必填	说明
Create_Time	String	是	接口请求生成时间，格式：YYYY-MM-DD HH:MM:SS
Pickup_Time	String	是	快递揽收时间，格式：YYYY-MM-DD HH:MM:SS
FirstIssue_Time	String	是	首次发出时间，格式：YYYY-MM-DD HH:MM:SS
FirstArrival_Time	String	是	首次到达转运中心时间，格式：YYYY-MM-DD HH:MM:SS
LeaveDistributionCenter_Time	String	是	离开首个转运中心时间，格式：YYYY-MM-DD HH:MM:SS
Dispatch_Time	String	是	派件开始时间，格式：YYYY-MM-DD HH:MM:SS
SignFor_Time	String	是	签收时间，格式：YYYY-MM-DD HH:MM:SS
LastUpdate_Time	String	是	物流信息最后更新时间，格式：YYYY-MM-DD HH:MM:SS
LastRequest_Time	String	是	本次接口请求时间，格式：YYYY-MM-DD HH:MM:SS
Pickup_Courier	String	是	揽收快递员/网点名称
Pickup_Courier_Phone	String	否	揽收快递员电话（可为空）
Pickup_Network	String	否	揽收网点名称（可为空）
Pickup_City	String	是	揽收城市（如：杭州市）
Delivery_Network	String	否	派送网点名称（可为空）
Delivery_City	String	是	派送城市（如：深圳市）
Delivery_Courier	String	是	派送快递员姓名
Delivery_Courier_Phone	String	是	派送快递员电话
FirstArrival_Name	String	是	首次到达的转运中心名称（如：萧山转运中心）
ShipperCode	String	是	快递公司编码（如：ZTO 代表中通快递）
LogisticCode	String	是	快递单号
ExpressName	String	是	快递公司名称（如：中通快递）
State	Integer	是	物流状态码：3 代表已签收（其他状态码需结合业务定义）
StateDesc	String	是	物流状态描述（如：已签收）
LastTrace	String	是	最后一条物流轨迹描述（精简版）
Count	Integer	是	物流轨迹总条数

 

5.2 时效时长字段（单位：分钟）

字段名称	数据类型	是否必填	说明
FirstIssue_TimeSpan	Float	是	揽收到首次发出时长
FirstArrival_TimeSpan	Float	是	揽收到首次到达转运中心时长
LeaveDistributionCenter_TimeSpan	Float	是	揽收到离开首个转运中心时长
HalfwayStagnation_TimeSpan	Float	是	中途停滞时长
Dispatch_TimeSpan	Float	是	揽收到开始派件时长
SignFor_TimeSpan	Float	是	揽收到完成签收时长

 

5.3 超时标记字段（0=未超时，1=超时）

字段名称	数据类型	是否必填	说明
Pickup_TimeOut	Integer	是	揽收超时标记
FirstIssue_TimeOut	Integer	是	首次发出超时标记
FirstArrival_TimeOut	Integer	是	首次到达转运中心超时标记
LeaveDistributionCenter_TimeOut	Integer	是	离开首个转运中心超时标记
HalfwayStagnation_TimeOut	Integer	是	中途停滞超时标记
Dispatch_TimeOut	Integer	是	派件超时标记
SignFor_TimeOut	Integer	是	签收超时标记

 

5.4 物流轨迹列表（TraceList）

为 JSON 数组，数组元素为轨迹节点对象，每个对象包含以下字段：

字段名称	数据类型	是否必填	说明
time	String	是	轨迹节点时间，格式：YYYY-MM-DD HH:MM:SS
desc	String	是	轨迹节点描述（物流操作详情）

 

6. 报文示例

{

    "Code": 200,

    "Message": "成功",

    "DebugMsg": "成功",

    "Data": {

        "Create_Time": "2025-12-06 13:08:08",

        "Pickup_Time": "2025-09-10 14:24:17",

        "Pickup_TimeOut": 0,

        "FirstIssue_Time": "2025-09-10 14:24:22",

        "FirstIssue_TimeOut": 0,

        "FirstIssue_TimeSpan": 0.0,

        "FirstArrival_Time": "2025-09-10 20:25:26",

        "LeaveDistributionCenter_Time": "2025-09-10 20:27:27",

        "FirstArrival_TimeSpan": 361.0,

        "LeaveDistributionCenter_TimeSpan": 363.0,

        "HalfwayStagnation_TimeSpan": 122258.0,

        "Dispatch_TimeSpan": 466.0,

        "SignFor_TimeSpan": 2946.0,

        "Dispatch_Time": "2025-09-12 07:44:25",

        "SignFor_Time": "2025-09-12 15:30:18",

        "LastUpdate_Time": "2025-09-12 15:30:18",

        "LastRequest_Time": "2025-12-06 13:08:08",

        "Pickup_Courier": "杭州塘栖云仓0",

        "Pickup_Courier_Phone": "",

        "Pickup_Network": "",

        "Pickup_City": "杭州市",

        "Delivery_Network": "",

        "Delivery_City": "深圳市",

        "Delivery_Courier": "",

        "Delivery_Courier_Phone": "",

        "FirstArrival_Name": " 萧山转运中心",

        "ShipperCode": "ZTO",

        "LogisticCode": "76739144533181",

        "ExpressName": "中通快递",

        "State": 3,

        "StateDesc": "已签收",

        "TraceList": [

            {

                "time": "2025-09-12 15:30:18",

                "desc": "您的快件已送货上门，如遇问题请联系快递员，无需找商家/平台。签收人：家门口 ，网点电话：，投诉电话：。关注"中通快递"官方微信公众号反馈问题，处理更快捷！感谢使用中通快递，期待再次为您服务！"

            },

            {

                "time": "2025-09-12 12:40:27",

                "desc": "您的快件正在为您上门派送，如遇问题无需找商家/平台，请联系：、，投诉电话：，或关注"中通快递"官方微信公众号获取实时物流信息"

            },

            {

                "time": "2025-09-12 10:42:30",

                "desc": "快件到达附近街区，即将安排送货上门。如遇问题请联系快递员，无需找商家/平台。网点电话：、，投诉电话：。关注"中通快递"官方微信公众号获取实时物流信息，感谢您的耐心等待！"

            },

            {

                "time": "2025-09-12 07:44:25",

                "desc": "深圳龙华 快递员正在为您派件（大促期间快件较多，我们将尽快送达，请留意接听中通快递员外呼专属号码95720，如遇问题请联系快递员为您解决，无需找商家/平台。网点电话：、，投诉电话：，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-12 04:16:38",

                "desc": "【深圳市】 快件已到达 深圳龙华（如遇问题无需找商家/平台，请致电【：、】更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-12 00:41:19",

                "desc": "【深圳市】 快件已发往 深圳龙华（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-11 19:29:43",

                "desc": "【深圳市】 快件已到达 深圳转运中心（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-10 20:27:27",

                "desc": "【杭州市】 快件已发往 深圳转运中心（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-10 20:25:26",

                "desc": "【杭州市】 快件已到达 萧山转运中心（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-10 14:24:22",

                "desc": "【杭州市】 快件已发往 萧山转运中心（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            },

            {

                "time": "2025-09-10 14:24:17",

                "desc": "【杭州市】 快件已由杭州塘栖云仓0（）揽收（如遇问题无需找商家/平台，请致电更快解决，或关注"中通快递"官方微信公众号获取实时物流信息）"

            }

        ],

        "LastTrace": "您的快件已送货上门，如遇问题请联系快递员，无需找商家平台签收人家门口 ，网点电话，投诉电话关注中通快递官方微信公众号反馈问题，处理更快捷感谢使用中通快递，期待再次为您服务",

        "Count": 11,

        "FirstArrival_TimeOut": 0,

        "LeaveDistributionCenter_TimeOut": 0,

        "HalfwayStagnation_TimeOut": 1,

        "Dispatch_TimeOut": 0,

        "SignFor_TimeOut": 0

    }

}

 

7. 状态码说明

状态码	描述	备注
200	成功	接口调用成功，返回完整物流数据
其他	失败	需结合具体状态码定义（如 400 代表参数错误，500 代表服务器异常，401 代表签名校验失败/身份认证失败等）

 

8. 注意事项

• 所有时间字段均遵循 YYYY-MM-DD HH:MM:SS 格式，时区为东八区（GMT+8）；
• 超时标记字段中，1 代表该节点超时，0 代表未超时，超时判定规则需结合业务场景定义；
• TraceList 数组中轨迹节点按时间倒序排列（最新轨迹在前）；
• 签名生成时需严格遵循「原始RequestData+APIKey→MD5→Base64→URL编码」流程，编码格式统一为UTF-8；
• 部分字段（如 Pickup_Courier_Phone、Pickup_Network）可能为空，需做非空判断处理。