Skip to content

获取模型订单状态

接口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 签名校验失败