设置小程序搜索标签
收藏接口说明
小程序搜索标签是小程序功能、特点等方面的延伸词汇，了解详情。（另外页面添加方式可通过“小程序控制台-运营-流量配置-搜索”的页面添加。）
例如：小程序名称是【AB 电影社】，功能是线上购票，搜索标签可设置为【电影票】【电影购票】【特价电影】等。
使用限制
暂无
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v1/capacity/set_search_tag/ |
| HTTP Method | POST |
| Scope | ma.search.tag |
| 权限要求 | 服务商代调用场景下，需商家授予运营管理权限集 小程序搜索标签 |
请求参数
请求头
access-token必填String
当非服务商时，调用https://developer.toutiao.com/api/apps/v2/token生成的token
当服务商时，调用https://open.microapp.bytedance.com/openapi/v1/oauth/token生成的token
当服务商时，调用https://open.microapp.bytedance.com/openapi/v1/oauth/token生成的token
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
add_tag_listArray<String>
新增的搜索标签
delete_tag_listArray<String>
删除的搜索标签
modify_tag_listList
修改的搜索标签
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/capacity/set_search_tag/' \ --header 'content-type: application/json' \ --header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******' \ --data '{"modify_tag_list":[{"search_tag":"NewTag","before_tag":"tag_to_modify"}],"add_tag_list":["tag_to_add"],"delete_tag_list":["tag_to_delete"]}'
响应参数
Body
err_msg必填String
示例：access_token过期,请刷新或重新授权
成功时为空，失败时为具体错误信息
err_no必填Int32
示例：28005041
错误码，0是成功，其他是异常
log_id必填String
示例：202312201107018A51A88B7380FA4xxxxx
用于调用链路追踪排查的日志ID
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "log_id": "20231227200943747 D70A7004FA2D6xxxx", "err_msg": "" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005007 | 参数校验异常 | 检查参数合法性 |
| 200 | 28001005 | 系统内部错误，请重试 | 建议重试 |
| 200 | 28005041 | 标签不合发 | 参考Error Msg |
| 200 | 28001018 | 应用未获得该能力 | 引导商家授予相关权限集 |
| 200 | 28001008 | access_token过期 | 刷新或重新授权 |
| 200 | 28001006 | 网络调用错误 | 建议重试 |
| 200 | 28001003 | access_token过期 | 检查access_token合法性 |
