增加服务类目V2
收藏接口说明
使用限制
- 每个小程序最多设置 5 个服务类目。
- 一定要注意服务类目之间的层级关系，不然接口会报错。
- 在想要设置的服务类目允许的范围内，资质可以多传，但不能少传。
- 不需要资质的服务类目，因为不需要审核，所以不要填写 category_cert 字段，不然接口会报错。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v1/category/add_categories/ |
| HTTP Method | POST |
| Scope | ma.category.add |
| 权限要求 | 授权小程序授予基本信息设置权限 |
请求参数
请求头
access-token必填String
示例：isvact.0801121846735352506a356a6
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
category_info必填List
展开子属性
请求示例
curl --location 'https://open.douyin.com/api/apps/v1/category/add_categories/' \ --header 'access-token: isvact.15e1dcc18xxxxxxhu3UEynUKzvi0b2Kugshu83cqR7' \ --header 'Content-Type: application/json' \ --data '{ "category_info": [ { "category": "xxx,xxx,xxx", "category_cert":[ {"id":"x", "name":"《信息网络传播视听节目许可证》", "path_list":{"xxxx/xxxx"}} ] }, { "category": "xx,xxxx,xx" } ] } '
响应参数
Body
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：20240117110730826954559C1E4E505341
标识请求的唯一id
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0, "log_id": "20240117110730826954559C1E4E505341" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 21300 | App 服务类目不符合规范 | |
| 200 | 21301 | 无效的服务类目 | |
| 200 | 21302 | 无效的服务类目资质 | |
| 200 | 21303 | 本月没有剩余足够的修改次数，每个月只有 3 次 | |
| 200 | 21304 | 超过 5 个服务类目的设置 | |
| 200 | 21306 | 添加的小程序服务类目存在重复 | |
| 200 | 21315 | 此服务类目不需要上传资质 | |
| 200 | 21320 | 添加的小程序服务类目包含失效类目 | |
| 200 | 40033 | 获取不到上传的材料，请确认文件路径正确 | |
| 200 | 40052 | 添加的小程序类目包含定向邀约类目，仅向试点主体开放 |
