跳转至

Base URLs:https://用户中心域名/prod-api/

(不清楚请联系我们)

POST 更新已开通服务的订单

POST /acdn/volc/hostAcceleratePackRest/modifyHostAcceleratePackOrder

更新已开通服务且服务未过期的主播加速服务订单。

说明: 仅支持更新订单所绑定的 Uid 及其对应的 NewDouyinId 和 NewNickname。

注意事项: 请求频率:单用户请求频率最高为 10 次/秒。

Body 请求参数

{
  "modifyOrders": [
    {
      "newUid": "76304453594",
      "executeTime": "2023-11-5",
      "orderId": "17872308245801546",
      "oldUid": "72589073778",
      "newDouyinId": "yan158hi5380",
      "newNickname": "新昵称"
    }
  ]
}

请求参数

名称 位置 类型 必选 中文名 说明
Authorization header string none
body body ModifyHostAcceleratePackOrder ModifyHostAcceleratePackOrder none

返回示例

OK

{
  "msg": "更新成功",
  "code": 200,
  "data": {
    "modifyOrders": [
      {
        "status": 1
      }
    ]
  }
}

201 Response

{}

返回结果

状态码 状态码含义 说明 数据模型
200 OK OK Inline
201 Created Created Inline
401 Unauthorized Unauthorized Inline
403 Forbidden Forbidden Inline
404 Not Found Not Found Inline

返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» additionalProperties object false none none
» status string true none 更新订单状态 1:更新成功
2:OrderId 和 Uid 不匹配
3:NewUid 和 NewDouyinId 不匹配
4:新抖音昵称不规范,如超出长度限制等
5:订单不存在
6:存在未执行的更新订单,无法再次更新
7:订单不在生效时间范围,无法更新
8:更新订单的时间错误
9:更新次数已达上限
10:内部服务错误

数据模型

ModifyHostAcceleratePackOrder

{
  "modifyOrders": [
    {
      "executeTime": "string",
      "newDouyinId": "string",
      "newNickname": string,
      "newUid": "string",
      "oldUid": "string",
      "orderId": "string"
    }
  ]
}

ModifyHostAcceleratePackOrder

属性

名称 类型 必选 约束 中文名 说明
modifyOrders [ModifyPackOrder] false none none

ModifyPackOrder

{
  "executeTime": "string",
  "newDouyinId": "string",
  "newNickname": true,
  "newUid": "string",
  "oldUid": "string",
  "orderId": "string"
}

ModifyPackOrder

属性

名称 类型 必选 约束 中文名 说明
executeTime string true none 更新执行时间 更新执行时间。 更新成功后次日 0 时生效。格式为 yyyy-mm-dd。例如在 2023 年 11 月 1 日通过本接口更新订单 A 并设置更新执行时间为 2023 年 11 月 5 日(即 ExecuteTime 取值为 2023-11-5),则该更新将在 2023 年 11 月 6 日 0 时生效。
newDouyinId string true none 新抖音号 新抖音号,与 新用户 ID 一一对应
newNickname boolean false none 昵称 新的抖音昵称。未传该参数时,系统将根据 新 Uid 和 新抖音号 查找对应昵称,如查找不到,则默认为 Uid+新抖音号
newUid string true none 新 uid 新 uid,与 新抖音号 一一对应
oldUid string true none 原 uid none
orderId string true none 订单 ID 更新执行时间。更新成功后次日 0 时生效。格式为 yyyy-mm-dd。例如在 2023 年 11 月 1 日通过本接口更新订单 A 并设置更新执行时间为 2023 年 11 月 5 日(即 ExecuteTime 取值为 2023-11-5),则该更新将在 2023 年 11 月 6 日 0 时生效。