能力申请
收藏接口说明
开发者可通过该 OpenAPI 申请小程序能力。
使用限制
接口频率限制：10 QPS
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v1/capacity/apply_capacity/ |
| HTTP Method | POST |
| Scope | app.capacity.admin |
| 权限要求 | 服务商代调用场景下，需商家授予开发管理权限集 小程序能力管理 满足任一能力即可 小程序能力管理 满足任一能力即可 |
请求参数
请求头
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展开全部子属性
apply_info必填Map
申请能力填写的字段
展开子属性
apply_reason必填String
示例：使用场景
申请能力原因
capacity_key 必填String
示例：xx.xx.xx
能力key
该字段通过 /api/apps/v1/capacity/query_capacity_list/ 接口返回的 data.app_capacity_info_list[].capacity_key 字段获取
请求示例
curl --location --request POST '/api/apps/v1/capacity/apply_capacity/' \ --header 'access-token: isvact.e5ba86fadf731d6a64012ec11e2b4e3d5dq5zKxwG1XO651zQPdb7ebqpZLq' \ --header 'content-type: application/json' \ --data '{"capacity_key":"xx.xx.xx","apply_reason":"使用场景描述","apply_info":{"scene_desc":["使用场景描述"]}}'
响应参数
Body
err_msg必填String
示例：success
成功为"success", 错误为具体 message
err_no必填Int32
示例：0
错误码，0 是成功，其它为异常
log_id必填String
示例：202401031934474D5D10CE50349328441E
日志logid
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "202401031934474D5D10CE50349328441E" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | -1 | 系统错误 | 建议重试 |
| 200 | 11001 | appid无法解析 | 建议重试 |
| 200 | 11009 | 参数不合法或缺少参数 | 检查参数合法性 |
| 200 | 11016 | access_token不正确或者已过期 | 检查access_token合法性 |
| 200 | 40006 | 非法请求，请求 IP 不在第三方小程序应用 IP 地址白名单内 | 添加IP地址到白名单内或者配置白名单为空 |
| 200 | 40036 | 授权小程序未授予该接口对应的权限 | 引导商家授予相关权限集 |
