更新绑定二维码状态
接口说明
更新绑定二维码状态
使用限制
- 每个月最多发布20次
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/apps/v2/capacity/update_simple_qr_bind_status/ |
HTTP Method | POST |
权限要求 | 服务商代调用场景下,需商家授予运营管理权限集 |
请求参数
请求头
access-token必填String
当非服务商时,调用https://open.douyin.com/oauth/client_token/生成的token
当服务商时,调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
当服务商时,调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token
content-type必填String
示例:application/json
固定值"application/json"
Body
qr_url必填String
需要更新状态的链接地址
该字段通过 /api/apps/v2/capacity/query_simple_qr_bind_list/ 接口返回的 data.qr_list.0.qr_url 字段获取
status必填Int32
需要更新的状态
1:发布
2:下线
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v2/capacity/update_simple_qr_bind_status/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"qr_url":"https://xxx","status":1}'
响应参数
Body
err_msg必填String
错误信息
err_no必填Int32
错误码
log_id必填String
排查错误的logId
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "log_id": "9yka2QuGbR", "err_no": 0 }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | -1 | 系统错误 | 建议重试,若多次重试失败,可向平台反馈该问题 |
200 | 11009 | 参数不合法或缺少参数 | 检查参数合法性,注意参数类型以及是否缺少必要参数 |
200 | 28001003 | access_token无效 | 请检查access_token |
200 | 28001007 | 必填字段缺失 | 请检查必填字段 |
200 | 28001008 | access_token过期 | 请刷新或重新授权access_token |