文档中心 > API类目 > 淘宝小时达履约

qimen.alibaba.xsd.logistics.subscribe.track.query (订阅单骑手经纬度查询)

订阅单骑手经纬度查询

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
deliveryOrderNo	String	必须	80002024101009		淘宝近场运力单号

响应参数

名称	类型	示例值	描述
success	String	true	查询调用是否成功
code	String	SUCCESS	错误码，成功时非必填
message	String	调用成功	错误说明，成功时非必填
data	DeliverySubscribeTrackQueryResp		返回对象
└ channelDeliveryNo String DF00013 配送商运力单号 └ deliveryPersonName String 李四骑手姓名 └ deliveryPersonPhone String 13711112222 骑手电话 └ deliveryPersonLat String 120.13 骑手纬度（高德坐标数据） └ deliveryPersonLng String 120.13 骑手经度（高德坐标数据） └ businessTime Number 1728454087000 骑手位置所处的当前时间（毫秒级时间戳） └ isDeliveryArrival Boolean true 骑手是否到店 └ remindDistance Number 2500 距离, 单位:米骑手未到店, 表示骑手到店剩余距离骑手已到店, 表示骑手到用户剩余距离 └ remindTime Number 300 剩余时长, 单位: 秒骑手未到店, 表示骑手到店剩余时间骑手已到店, 表示骑手到用户剩余时间

请求示例

{"deliveryOrderNo":"80002024101009"}

响应示例

{
    "success":"true",
    "code":"SUCCESS",
    "message":"调用成功",
    "data":{
        "channelDeliveryNo":"DF00013",
        "deliveryPersonName":"李四",
        "deliveryPersonPhone":"13711112222",
        "deliveryPersonLat":"120.13",
        "deliveryPersonLng":"120.13",
        "businessTime":1728454087000,
        "isDeliveryArrival":true,
        "remindDistance":2500,
        "remindTime":300
    }
}

验签示例

{"code":"sign-check-failure","success":"false","message":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

淘宝小时达履约

qimen.alibaba.xsd.logistics.subscribe.track.query (订阅单骑手经纬度查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ