版本:202506
创建订单风险记录
POST/openapi/2025-06/orders/:order_id/risks
为指定订单添加一条自定义风险记录,包含风险等级(low/medium/high)、详情 原因和可选的自定义属性,通常在商家完成人工风险审核后调用。
请求
Path参数
order_id string必填
订单 ID
- application/json
- 请求体
- 示例
请求体必填
low: 低medium: 中high: 高
risk object必填
包含风险等级和详情信息的订单风险对象
levelstring必填
订单风险等级:
detailsstring[]
说明风险原因的风险详情列表
properties object
订单风险的自定义属性,以键值对形式存储
property name*string
{
"risk": {
"level": "string",
"details": [
"string"
],
"properties": {}
}
}
响应
- 200
OK
- application/json
- 数据结构
- 示例
数据结构
low: 低medium: 中high: 高
codestring
错误码
messagestring
错误信息
data object
risk object
订单风险记录
idstring
订单风险记录 ID
order_idstring
该风险记录关联的订单 ID
levelstring
订单风险等级:
detailsstring[]
说明风险标记原因的详情列表
properties object
订单风险的自定义属性,以键值对形式存储
property name*string
created_atstring
风险记录创建时间(如 2018-11-02T12:30:10Z)
updated_atstring
风险记录最后更新时间(如 2018-11-02T12:30:10Z)
{
"code": "string",
"message": "string",
"data": {
"risk": {
"id": "string",
"order_id": "string",
"level": "string",
"details": [
"string"
],
"properties": {},
"created_at": "string",
"updated_at": "string"
}
}
}