接口说明

1. 小程序已添加且资质审核通过的类目,才可预设为主营类目。可先通过「获取已设置的服务类目API」查询小程序的类目信息

2. 通过本API预设主营类目后,有以下两种方式使主营类目生效:

(1)通过「发布服务类目API」提交审核

(2)通过「提审代码API」提交版本审核

3. 主营类目审核结果,可通过「查询主营类目API」查询是否通过生效

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/apps/v1/category/pre_set_main_category/
HTTP Method
POST
Scope
ma.main.category

请求参数

请求头
access-token必填String
示例:isvact.0801121846735352506a356a6
content-type必填String
示例:application/json
固定值"application/json"
Body
main_category必填String
预设主营类目的完整三级类目id
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/category/pre_set_main_category/' \ --header 'content-type: application/json' \ --header 'access-token: xxxxxxx' \ --data '{"main_category":"xxx,xxx,xxx"}'

响应参数

Body
err_msg必填String
示例:0
错误码
err_no必填Int32
错误描述
log_id必填String
示例:20240117110730826954559C1E4E505341
标识请求的唯一id
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0, "log_id": "20240117110730826954559C1E4E505341" }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001006
网络调用错误,请重试
重试即可
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常