跳转至

模型订单转单

接口说明:
  • 支持将一个模型订单的创建人与所属人同时转移至本公司下的另一个账号
  • 转单不改变订单状态,接口返回转单后的订单状态便于贵方核对
  • 订单与目标账号都必须属于当前鉴权身份所属公司,范围外一律返回 10004
  • 已取消、已作废、制作中的订单不可转单
  • 转单完成后,原创建人与原所属人将立即失去该订单的模型上传、编辑权限
请求路径:

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

请求方式:
  • POST
Headers:
{
  "Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM=",
  "Content-Type": "application/json"
}
入参示例
{
    "order_id": 123456,
    "creator_id": 12345
}
字段名 类型 是否必传 含义
order_id int 订单 id,须为整数
creator_id int 转入账号的用户 id,须为整数

creator_id查询账号基本信息返回的 user_id

响应参数示例
{
    "msg": "success",
    "code": 1,
    "data": {
        "order_id": 123456,
        "creator_id": 12345,
        "owner_id": 12345,
        "status": 3
    }
}
响应参数字段及含义:
字段名 类型 是否必传 含义
msg string 响应状态描述
code int 响应状态码
data object 转单结果
data取值及说明:
字段名 类型 是否必传 含义
order_id int 订单 id
creator_id int 转单后的创建人用户 id
owner_id int 转单后的所属人用户 id,与 creator_id 相同
status int 转单后的订单状态,取值见下方说明
注意:
  • 转单会把创建人与所属人一并改为 creator_id,两者不可分别指定
  • 转单不可撤销。如需回退,请再发起一次转单并传入原账号的 user_id
  • 转单完成后,原创建人与原所属人将立即失去该订单的模型上传、编辑权限; 请确认一线人员已完成拍摄与上传后再转单
  • 目标账号被禁用或冻结时,转单会被拒绝并返回 30002
  • 订单状态为已取消、已作废、制作中时,转单会被拒绝并返回 30004
  • 重复将同一订单转给同一账号时返回成功,订单不发生变化
  • 若该订单所属模型下还挂有其它订单,本次转单会同时变更该模型的所属人, 进而影响那些订单的所属人归属,请在转单前确认该模型是否被多个订单共用
  • 订单状态取值以及对应含义,详见模型订单状态变更通知(回调)订单状态值及对应的说明
消息码code取值及说明:
code值 说明
1 成功
10004 订单或目标账号不存在,或不属于当前鉴权身份所属公司
30002 目标账号已被禁用,请联系众趣管理员
30004 当前订单状态不支持转单(已取消、已作废、制作中)
31000 不支持当前请求的版本
32000 签名校验失败
33000 参数校验失败(order_id 或 creator_id 不是整数)
33001 缺少必要的参数(order_id 或 creator_id 未传)
34000 接口调用次数超出限制