获取模型订单状态
接口id:
4
接口说明:
调用此接口获取订单状态
可以批量获取,但最多一次获取十个
请求路径:
{HostName}/api/v2/op/openapi/model_order/status/?hids={hids}&nest_ids={nest_ids}&order_ids={order_ids}
请求方式:
- GET
Headers:
{
"Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM="
}
传入参数字段及含义
可根据 hids 或者 nest_ids 或者 order_ids 进行查询,三者必传其一
查询优先级: hids > nest_ids > order_ids
建议只传其中1个查询参数进行查询,3个参数同时传入时,只有1个参数生效
若传入 hids,则根据 hids 进行查询;否则:若传入 nest_ids, 则根据nest_ids 进行查询;否则:根据order_ids进行查询
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
hids | string | 联合必传 | 房源id,多个用逗号分隔,例如“hid1,hid2,hid3” |
nest_ids | string | 联合必传 | 模型id,多个用逗号分隔,例如“nest_id1,nest_id2,nest_id3” |
order_ids | string | 联合必传 | 订单id,多个用逗号分隔,例如“order_id1,order_id2,order_id3” |
响应参数示例
{
"msg": "success",
"code": 1,
"data": [
{
"status": 3,
"build_status": 1,
"hid": "He",
"nest_id": "f945182c_1gdX_b6f9",
"order_id": 123
},
{
"status": 3,
"build_status": 1,
"hid": "384",
"nest_id": "f6ba76e2_xIpq_b6f9",
"order_id": 124
},
{
"status": 3,
"build_status": 1,
"hid": "173",
"nest_id": "eed0384a_Ytg7_b6f9",
"order_id": 125
}
]
}
注意:
- 未能匹配上拍摄订单的hid或nest_id或order_id,将不会包含在结果中
- 取消,作废的订单将不会包含在结果中
- 订单状态取值以及对应含义,详见中的模型订单功能-模型状态状态变更-文档中
订单状态值及对应的说明
段 - 订单模型的构建状态取值及对应的含义如下:
- -1 : 构建失败
- 1 : 构建成功
- 2: 构建中
- 3: 未构建
响应参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
msg | string | 是 | 响应状态描述 |
code | int | 是 | 响应状态码 |
hid | string | 是 | 房源id |
status | int | 是 | 订单状态 |
nest_id | string | 是 | 订单模型id,可能为null |
order_id | int | 是 | 订单id |
build_status | int | 是 | 订单模型的构建状态 |
消息码code取值及说明:
code值 | 说明 |
---|---|
1 | 成功 |
31000 | 不支持当前请求的版本 |
33000 | 参数校验失败 |
33001 | 缺少必要的参数 |
32000 | 签名校验失败 |