能力列表
接口说明
开发者可通过该 OpenAPI查看小程序能力列表。
使用限制
接口频次限制:10 QPS
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/apps/v1/capacity/query_capacity_list/ |
HTTP Method | GET |
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
请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v1/capacity/query_capacity_list/' \ --header 'access-token: isvact.e5ba86fadf731d6a64012ec11e2b4e3d5dq5zKxwG1XO651zQPdb7ebqpZLq' \
响应参数
Body展开全部子属性
err_msg必填String
示例:success
成功为"success", 错误为具体 message
err_no必填Int32
示例:0
错误码,0 是成功,其它为异常
log_id必填String
示例:202401031934474D5D10CE50349328441E
日志logid
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "AppCapacityInfoList": [ { "capacity_name": "能力的中文名称", "is_can_apply": false, "apply_condition": [ [ { "satisfied": false, "condition_name": "是否上线小程序", "condition_description": "仅支持已上线的小程序" } ] ], "description": "能力的简单描述", "capacity_key": "xx.xx.xx", "status": 1, "host_app": "抖音", "apply_field_list": [ { "apply_field_key": "scene_desc", "apply_field_is_required": true, "apply_field_value_type": 10, "apply_field_name": "使用场景", "apply_field_desc": "使用场景描述" } ], "lab_description": "实验室能力描述信息", "is_auth_permission": false, "is_lab": 1, "permission_list": [ 1, 3 ] } ] }, "err_no": 0, "err_msg": "success", "log_id": "202401031934474D5D10CE50349328441E" }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | -1 | 系统错误 | 建议重试 |
200 | 11001 | appid无法解析 | 建议重试 |
200 | 11009 | 参数不合法或缺少参数 | 检查参数合法性 |
200 | 11016 | access_token不正确或者已过期 | 检查access_token合法性 |
200 | 40006 | 非法请求,请求 IP 不在第三方小程序应用 IP 地址白名单内 | 添加IP地址到白名单内或者配置白名单为空 |
200 | 40036 | 授权小程序未授予该接口对应的权限 | 引导商家授予相关权限集 |