接口路径(新):http://api.okayapi.com/api/App/KuaiDi100/Query
接口路径(旧):http://api.okayapi.com/?s=App.KuaiDi100.Query
接口描述: 客户主动请求接口,根据快递公司编码和快递单号实时请求快递公司单号查询接口,并将获取到的物流轨迹信息封装返回给调用者。依赖于 快递100-实时快递查询接口。使用前请先进行快递100配置。
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
com | String | Required | 查询的快递公司的编码, 一律用小写字母,点击查看全部快递公司编码。常用快递公司编码有,圆通速递:yuantong、韵达快递:yunda、中通快递:zhongtong、申通快递:shentong、邮政快递包裹:youzhengguonei、百世快递:huitongkuaidi、顺丰速运:shunfeng、京东物流:jd、天天快递:tiantian、EMS:ems、邮政标准快递:youzhengbk、极兔速递:jtexpress、宅急送:zhaijisong、德邦:debangwuliu、德邦快递:debangkuaidi、中通快运:zhongtongkuaiyun、优速快递:youshuwuliu、百世快运:baishiwuliu、韵达快运:yundakuaiyun、安能快运:annengwuliu | ||
num | String | Required | MAX: 32 | 查询的快递单号, 单号的最大长度是32个字符 | |
phone | String | Optaion | 收件人或寄件人的手机号或固话(顺丰单号必填,也可以填写后四位,如果是固话,请不要上传分机号)。例如:13800138000 | ||
from | String | Optaion | 出发地城市,省-市-区,例如:广东省广州市黄埔区 | ||
to | String | Optaion | 目的地城市,省-市-区,例如:北京市朝阳区 | ||
resultv2 | Enum | Optaion | 1 | Range: 0/1/2 | 添加此字段表示开通行政区域解析功能。0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息 |
order | Enum | Optaion | Range: asc/desc | 返回结果排序方式。desc:降序(默认),asc:升序 |
请求:
{OKAYAPI_API_HOST}/?s=App.KuaiDi100.Query&com=jd&num=JD0019529000000&app_key={你的app_key}&sign={动态签名}
返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"kuaidi": {
"message": "ok",
"nu": "JD0019529000000",
"ischeck": "1",
"com": "jd",
"status": "200",
"data": [
{
"time": "2020-06-22 19:06:25",
"context": "您的快件已签收,感谢您使用京东物流,期待再次为您服务。",
"ftime": "2020-06-22 19:06:25",
"areaCode": null,
"areaName": null,
"status": "签收"
},
{
"time": "2020-06-22 16:43:27",
"context": "您的快件正在派送中,请您准备签收(快递员:张三,联系电话:13800138000)",
"ftime": "2020-06-22 16:43:27",
"areaCode": null,
"areaName": null,
"status": "派件"
},
{
"time": "2020-06-20 12:08:37",
"context": "货物已交付京东物流",
"ftime": "2020-06-20 12:08:37",
"areaCode": null,
"areaName": null,
"status": "在途"
},
{
"time": "2020-06-20 12:08:37",
"context": "尊敬的客户您好,大促期间购物高峰,您的快递可能会延迟配送,我们将全力为您服务,请您耐心等待;",
"ftime": "2020-06-20 12:08:37",
"areaCode": null,
"areaName": null,
"status": "在途"
}
],
"state": "3",
"condition": "F00"
}
},
"msg": "V2.5.1 YesApi App.KuaiDi100.Query"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作码,0表示成功,正数表示业务失败场景,负数表示系统失败场景 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
kuaidi | Object | 快递查询结果,失败时为null |
kuaidi.state | Int | 快递单当前状态,包括0在途,1揽收,2疑难,3签收,4退签,5派件,6退回,7转投,10待清关,11清关中,12已清关,13清关异常,14拒签 等13个状态 |
kuaidi.ischeck | Int | 是否签收标记 |
kuaidi.com | String | 快递公司编码,一律用小写字母,点击查看快递公司编码 |
kuaidi.nu | String | 快递单号 |
kuaidi.data | Array | 数组,包含多个对象,每个对象字段如展开所示 |
kuaidi.data[].context | String | 物流轨迹节点内容 |
kuaidi.data[].time | String | 时间,原始格式,如:2012-08-28 16:33:19 |
kuaidi.data[].ftime | String | 格式化后时间,如:2012-08-28 16:33:19 |
kuaidi.data[].status | String | 本数据元对应的签收状态。 |
kuaidi.data[].areaName | String | 本数据元对应的行政区域的名称 |
Power by OkayAPI.com Contact us (WA: okayapi OR Email: chanzonghuang@gmail.com).
Timezone: America/New_York Mar/28/2024 21:33:54