接口说明

该接口用于第三方小程序应用为授权小程序，增加服务类目并通过资质审核or删除已发布类目后，调用本接口使类目变动发布生效。

注意：修改类目可能影响挂载、交易等能力权限，详情可看「类目-能力开放状态」

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/category/publish_category/
HTTP Method	POST
Scope	ma.category.publish
权限要求	授权小程序授予基本信息设置权限

请求参数

请求头

access-token必填String

示例：isvact.0801121846735352506a356a6

调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token

请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/category/publish_category' \
--header 'access-token: xxxx' \
--data ''

响应参数

Body

err_msg必填String

错误描述

err_no必填Int32

示例：0

错误码

log_id必填String

示例：20231018153618E549A52830951EXXXX

标识请求的唯一id

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "",
  "log_id": "20231018153618E549A52830951EXXXX"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	28001008	access_token过期	重新获取access_token
200	21408	未满足线上类目发布条件
200	20000	系统错误

类目发布审核结果通知

类目发布审核结果出来之后，会自动触发消息发送，然后开放平台服务器会向第三方小程序应用的【消息与事件接收 URL】以 HTTP POST 方式推送相应授权小程序的类目发布的审核结果。

POST 数据示例：

{
    "Nonce": "4464221",
    "TimeStamp": "1535551395",
    "Encrypt": "Encrypt Message xxxxxxxx",
    "MsgSignature": "ba394c04acece6c2c0edee058c5dddf82474b8ee"
}

其中 Encrypt 字段需要解密，解密详情见消息推送及加解密说明部分。解密后消息格式如下：

{
    "AppId": "XXXX",
    "TpAppId": "XXXX",
    "EventTime": "2023-10-13 18:27:19",
    "Event": "PUBLISH_APP_CATEGORY_AUDIT_RESULT",
    "EventContent": {
        "audit_categories": [{
            "category_id": "188,189,190",
            "category_name": "工具-实用工具-记账"
        }],
        "audit_reason": "{\"redundant_choice\":[],\"lack_choice\":[],\"other_reason\":\"\"}",
        "audit_state": 2
    }
}

消息体字段含义如下：

名称			数据类型	描述
AppId			string	授权小程序 appid
TpAppId			string	授权小程序 appid
EventTime			string	推送事件时间
Event			string	推送事件类型
EventContent			object	服务类目发布审核结果
	audit_categories		array<object>	服务类目列表
		category_id	string	服务类目Id, etc. "158,159,259"
		category_name	string	服务类目名称, etc. "社交类-社交-直播"
	audit_reason		string	审核拒绝原因，为如下格式的json格式字符串 { "redundant_choice": [], // 超出服务范围的服务类目名称列表 "lack_choice": [], // 需补充的服务类目名称列表 "other_reason": "" // 其他原因 }
	audit_state		number	发布审核状态 2：审核通过 3：审核拒绝

开发者文档

发布服务类目

接口说明

基本信息

请求参数

响应参数

错误码

类目发布审核结果通知

发布服务类目在线调试

接口说明

基本信息

请求参数

响应参数

错误码

类目发布审核结果通知

发布服务类目