同城配送查询订单

POST

https://order.kuaidi100.com/sameCity/order

param数据结构：

参数名	是否必填	类型	说明
taskId	是	string	任务ID
orderId	是	string	订单ID

1.4 提供数据内容

param例子

{
    "taskId": "2B389A891A2C4AF8AB29927050DA52CC",
    "orderId": "1000086"
}

说明：

部分状态指的是，下单成功、签收以及取消状态下某些参数是不存在的

1.5 信息代码含义

信息代码	信息内容描述	原因及建议处理方式
200	成功	成功
400	参数错误等	提交数据不完整，检查提交的格式是否为x-www-form-urlencoded的post格式
500	服务器错误	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数没有按照文档规定填写等，也会报此错误
501	重复提交	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数没有按照文档规定填写等，也会报此错误
503	验证签名失败	请检查加密方式，param + t + key+ secret 的顺序进行MD5加密，加密后字符串转大写
601	key已过期	没有可用单量，账号需要充值使用

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://order.kuaidi100.com/sameCity/order' \
--data-urlencode 'method=' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 't=' \
--data-urlencode 'param='

响应示例

{
    "returnCode": "200",
    "result": true,
    "message": "提交成功",
    "data": {
        "courierName": "G师傅",
        "courierPhone": "15010033036",
        "predictDeliveryTime": "2021-03-10 11:00:37",
        "lat": "29.24303",
        "lng": "91.77957",
        "status": 1
    }
}

请求参数

Body 参数application/x-www-form-urlencoded

method

string

必需

业务类型（默认：query）

key

string

必需

授权码，请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register

示例值:

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号secret在授权邮件里面有

示例值:

string

必需

时间戳如：1576123932000

param

string

由其他字段拼接

必需

返回响应

🟢200成功

application/json

Body

returnCode

string

返回编码

必需

result

boolean

必需

提交结果。true提交成功，false失败

message

string

返回报文描述

必需

data

object

必需

courierName

string

必需

骑手名称。部分状态下为空

courierPhone

string

必需

骑手电话。部分状态下为空

predictDeliveryTime

string

必需

预计到达时间。闪送、快服务支持、部分状态下为空

lat

string

必需

当前骑手位置（纬度）。部分状态下为空

lng

string

必需

当前骑手位置（经度）。部分状态下为空

status

integer

必需

订单状态0-下单成功 1-已接单 10-已取货 13-已签收 9-用户主动取消 99-订单已取消

com

string

快递公司编码

必需

num

string

快递公司订单号

必需

traiUrl

string

必需

地图链接。顺丰支持部分状态下为空

同城配送下单

同城配送取消下单接口

同城配送查询订单

1.4 提供数据内容#

1.5 信息代码含义#

请求参数

返回响应

1.4 提供数据内容

1.5 信息代码含义