创建模型订单

接口id

2

接口说明：

通过此接口创建一条模型拍摄的订单。摄影师可以在拍摄端获取待拍摄的订单列表完成拍摄。

订单必需指定一个众趣的账号为订单的摄影师。

暂不支持批量创建。

请求路径：

{HostName}/api/v2/op/openapi/model_order/

请求方式：

• POST

Headers：

{
  "Content-Type": "application/json;charset=UTF-8",
  "Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM="
}

入参示例

{
  "hid": "房源id",
  "name": "拍摄的模型名称",
  "insta": 1,
  "creator": {
    "username": "摄影师账号"
  },
  "house_info": [
    {
      "title": "截止时间",
      "value": "20210821"
    },
    {
      "title": "拍摄要求",
      "value": ""
    }
  ]
}

传入参数字段及含义：

字段名	类型	是否必传	含义
hid	string/int	是	房源id
name	string	是	房源名称
insta	bool	否	是否开启insta机内合成(默认不开启)
creator	object	是	摄影师信息
丨--username	string	是	摄影人账号
丨--name	string	否	摄影人昵称
house_info	array	否	对于拍摄订单的补充信息
丨--title	string	是	信息显示在ipad上时的标题
丨--value	string	是	信息显示在ipad上时的内容

注意：

hid * hid是接入方与众趣模型一一对应的资源的唯一id。可能是接入方拍摄任务的id，接入方房源id等等，不一而足。 * hid这个值与接入方现有的拍摄订单hid重复时，会创建失败。

house_info * 按照格式传入这个信息，就可以将信息展示在拍摄端。 * 最多传入10组信息，总字符数不要超出200，否则会导致拍摄端无法正常展示。 * 众趣仅仅展示这个信息。即使传入截止时间这样的信息，众趣这边不会控制拍摄时间。 * house info中可以传入 某些预置的title，实现某些功能。如下

title	value取值示例	value取值说明	功能
deadline	1683267931	必须是时间戳，单位为秒	在草稿列表可以显示此截止时间，提醒摄影师。 仅仅提示，众趣不会限制拍摄时间

响应参数

{
  "msg": "success",
  "code": 1,
  "data": {
    "hid": "房源id",
    "order_id": "订单id",
    "name": "拍摄的模型名称",
    "order_code": "订单编号",
    "creator": {
      "username": "摄影师账号"
    }
  }
}

响应参数字段及含义:

字段名	类型	是否必传	含义
msg	string	是	响应状态描述
code	int	是	响应状态码
hid	string	是	房源id
order_id	int	是	订单id
order_code	string	是	订单编号
name	string	是	房源名称
creator	string	是	摄影师信息
username	string	是	摄影师账号

消息码code取值及说明:

code值	说明
1	成功
31000	不支持当前请求的版本
31001	账户不存在, 请先注册
33000	参数校验失败
33001	缺少必要的参数
32000	签名校验失败
34111	hid重复
34112	请求失败，参数异常，公司信息不匹配，无法创建
34114	账号已停用，无法创建订单，请先解冻