模型订单状态变更
接口id:
3
接口说明:
在某些情况下,接入方拍摄任务状态的变更需要同步到众趣时,调用此接口来更改众趣拍摄订单的状态。
暂时只支持以下状态的变更:
- 订单取消 (仅支持未上传的订单)
- 订单下线 (支持已经制作完成的订单) (模型将不再能展示)
- 订单上线 (仅支持下线的订单)
- 订单作废 (仅支持已上传的订单)
- 复审驳回 (支持制作完成且上线的订单)
- 复审通过 (支持制作完成且上线的订单)
- 订单恢复 (支持取消订单的恢复成带拍摄和作废的订单恢复成待编辑)
请求路径:
{HostName}/api/v2/op/openapi/model_order/status/
请求方式:
{
"Content-Type": "application/json;charset=UTF-8",
"Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM="
}
入参示例
{
"hid": "房源id",
"mid": "模型id",
"order_code": "订单编号",
"status": 6,
"detail": "模型状态的进一步描述"
}
传入参数字段及含义:
字段名 |
类型 |
是否必传 |
含义 |
hid |
string/int |
否 |
房源id |
mid |
string |
否 |
模型id |
order_code |
string |
否 |
订单编号(在众趣后台获得) |
status |
int |
是 |
状态值 |
detail |
string |
否 |
模型状态的进一步描述 |
info |
object |
否 |
复审(通过或者驳回)信息 |
注意:
- info仅当复审时传参
- hid和mid必传其中一个
- order_code (订单恢复时必须使用此参数)
info入参示例
{
"desc": "审核不通过",
"img": [
{
"imgUrl": "<https://modelcdn.3dnest.cn/zq_jdkd_166/2018-09-10-16-34-04/locations/pc/low/location_09_4.jpg>"
}
],
"title": "复审驳回原因"
}
入参数字段及含义:
字段名 |
类型 |
是否必传 |
含义 |
desc |
string |
否 |
审核描述 |
img |
array |
否 |
多张图片列表 |
imgUrl |
url |
否 |
图片连接 |
title |
string |
否 |
审核标题 |
status取值说明
status取值 |
说明 |
5 |
下线订单(模型不再能展示) |
6 |
上线订单 |
7 |
取消订单 |
8 |
作废订单 |
9 |
复审驳回 |
10 |
复审通过 |
11 |
订单恢复 |
注意:
响应参数示例
{
"msg": "success",
"code": 1,
"data": {
"status": 6,
"hid": "房源id"
}
}
响应参数字段及含义:
字段名 |
类型 |
是否必传 |
含义 |
msg |
string |
是 |
响应状态描述 |
code |
int |
是 |
响应状态码 |
hid |
string |
是 |
房源id |
status |
int |
是 |
订单状态 |
消息码code取值及说明:
code值 |
说明 |
1 |
成功 |
31000 |
不支持当前请求的版本 |
33000 |
参数校验失败 |
33001 |
缺少必要的参数 |
32000 |
签名校验失败 |
34121 |
hid重复 |