文档
测试

8.获取可选取消原因

POST
https://openapi-pre.huolala.cn/api/e-order-cancelReason

接口应用场景

√订单不同状态,可供用户选择的取消原因及对应的枚举也不同; √用户可选择直接通过订单号获取到此订单可取消的原因项;也可以直接通过type根据订单状态去获取到对应状态下的取消原因有哪些

服务入口

测试环境:https://openapi-pre.huolala.cn/api/e-order-cancelReason 正式环境:https://openapi.huolala.cn/api/e-order-cancelReason

编码

数据编码: Accept:application/json Content-type: application/json 字符编码: utf-8

前端UI参考:

![image.png](https://cos.easydoc.net/48578360/files/ka20deco)

公共请求参数

参数名
类型
描述
必填
app_key
string
开发者应用唯一标识.
必填
access_token
string
货拉拉用户授权给开发者应用访问账户的访问令牌码
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,仅用于保证签名不可预测;示例:474
必填
timestamp
string
Unix时间戳(单位:秒),60s内有效,超过60s则超时;示例:1565225482
必填

应用级请求参数

参数名
类型
描述
必填
type
int
配置分类(0. 配对中取消订单 1. 袋装货取消订单 2.更换司机); type与order_display_id二者必传其一
可选
order_display_id
string
货拉拉对外订单号;type与order_display_id二者必传其一
可选

响应参数

参数名
类型
描述
必填
ret
int
结果码,示例:0
可选
msg
string
结果描述,示例:Success
可选
data
array
数据列表
可选
id
int
分类id;示例:1000
可选
category
string
分类名称;示例:自己原因
可选
sub_cat
array
子分类列表;数据列表
可选
sub_id
int
子分类原因id;示例:1000001
可选
sub_name
string
子分类原因名称;示例:计划有变,暂时不需要用车
可选
ep_model
int
跳转模式(暂未使用);示例:1
可选

request Body请求示例

```json { "app_key":"*****************", "access_token":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "type":0 } ```

response响应示例

```json { "ret": 0, "msg": "Success", "data": [ { "id": 1000, "category": "自己原因", "sub_cat": [ { "sub_id": 1000001, "sub_name": "计划有变,暂时不需要用车", "ep_model": 1 } ] } ] } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |1000|传输参数异常|