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
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 时生效。 |