场景描述
拖车单详情
调用方式
HTTP Post
功能
Open NSC 将使用统一的参数,向供应商系统查询供应商订单详情。
接入流程
- 供应商根据自身系统需求,明确需要下单需要的信息,如无疑问,则按此文档信息进行对接
- Open NSC 增加相关供应商的接入配置
- Open NSC 和接入方进行联调测试,确认下单成功后上线。
接口签名规范
为保证通讯安全,Open NSC 侧会用和验签相同的加签方式(见 签名规范),对发送的请求进行签名。
接口返回值要求
接口返回值请尽量参照 Response 结构 实现。 如果不能完全根据上述标准返回,必须返回 result_code 字段,并以 "success" 作为回调成功的标识。Open NSC 将以此作为回调成功与否的判断。
下单信息
Post body 格式
application/json
参数示例
{
"order_id":"826127771471626630"
}
参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
order_id | yes | string | 订单 ID |
接口返回信息
返回示例
{
"result_code": "success",
"request_id": "0a6f981aj9xvewih_23",
"server_time": 1510558306,
"data": {
"order_id": "826127771471626630",
"service_type": 1,
"order_status": "1000",
"resource_info": [
{
"plate_number": "京x123456",
"resource_type": "trailer",
"status": "1000",
"staff_info": {
"name": "cc",
"phone": "12312345678"
},
"location": {
"latitude": 36.443333,
"longitude": 115.969948
}
}
],
"order_status_logs": [
{
"time": 1562148667,
"description": "已派单",
"status": "1000"
},
{
"time": 1562148667,
"description": "已接单",
"status": "1100"
}
]
}
}
返回参数说明
键 | 是否必须 | 类型 | 说明 |
---|---|---|---|
request_id | 是 | string | 见api规范 |
result_code | 是 | string | 见api规范 |
message | 是 | string | 见api规范 |
data | 是 | object | 见api规范 |
- order_id | 是 | string | 订单 ID |
- service_type | 是 | integer | 服务单类型,参见 拖车服务单类型 |
- order_status | 是 | string | 拖车单状态,参见 拖车单状态 |
- resource_info | 是 | list | 资源信息 |
-- plate_number | 是 | string | 调派车辆的车牌 |
-- resource_type | 是 | string | 调派车辆类型 |
-- status | 否 | string | 资源当前状态,参见 拖车单状态 |
-- staff_info | 是 | object | 司机信息 |
--- name | 是 | string | 姓名 |
--- phone | 是 | string | 联系方式 |
-- location | 是 | object 资源实时信息 | |
--- longitude | 是 | double | 经度 |
--- latitude | 是 | double | 纬度 |
- order_status_logs | 否 | list | 状态节点信息 |
-- order_status | 是 | string | 拖车单状态,参见 拖车单状态 |
-- time | 是 | timestamp | 发生时间 |
-- description | 否 | string | 描述 |