基本
`HTTP URL`	`https://open.microapp.bytedance.com/openapi/v1/microapp/app/add_categories`
`HTTP Method`	`POST`
`权限要求`	授权小程序授予基本信息设置权限

查询参数

参数名	参数类型	是否必须	备注
`component_appid`	`string`	是	第三方小程序应用 appid
`authorizer_access_token`	`string`	是	授权小程序接口调用凭据

请求体（json）

参数名			参数类型	是否必须	备注
`categoryInfo`			`Array<object>`	是
	`category`		`string`	是	英文逗号隔开的三级服务类目 id，形如："一级类目id,二级类目id,三级类目id"。获取可以设置的服务类目列表
	`categoryCert`		`Array<object>`	否	需要上传的所有资质信息
		`id`	`string`	否	资质 id
		`name`	`string`	否	资质名称
		`path`	`string`	否	需要上传的服务类目资质路径如果想要设置的服务类目需要上传资质，则需要使用代授权小程序上传资源接口返回的路径才可以，接口调用时入参 material_type 字段为 2，否则报错。
		`pathList`	`Array<string>`	否	需要上传的服务类目资质路径列表，当需要上传多张资质图片时使用如果想要设置的服务类目需要上传资质，则需要使用代授权小程序上传资源接口返回的路径才可以，接口调用时入参 material_type 字段为 2，否则报错。

请求体示例

{
    "categoryInfo": [
        {
            "category": "158,159,259",
            "categoryCert":[
                {"id":"79", "name":"《信息网络传播视听节目许可证》", "path":"xxxx/xxxx"},
                {"id":"117", "name":"《网络文化经营许可证》(经营范围含网络表演）", "path":"xxxx/xxxx"},
                {"id":"158", "name":"《统一社会信用代码证》（适用于政府主体）", "path":"xxxx/xxxx"}
            ]
        },
        {
            "category": "1,2,6"
        }
        ......
    ]
}

注意：

•

每个小程序最多设置 5 个服务类目。

•

一定要注意服务类目之间的层级关系，不然接口会报错。

•

在想要设置的服务类目允许的范围内，资质可以多传，但不能少传。

•

不需要资质的服务类目，因为不需要审核，所以不要填写 categoryCert 字段，不然接口会报错。

响应

响应体

参数名	参数类型	备注
`errno`	`int`	错误码
`message`	`string`	错误信息

响应体示例

{
  "errno": 0,
  "message": "success"
}

错误码

错误码	message
21300	App 服务类目不符合规范
21301	无效的服务类目
21302	无效的服务类目资质
21303	本月没有剩余足够的修改次数，每个月只有 3 次
21304	超过 5 个服务类目的设置
21306	添加的小程序服务类目存在重复
21315	此服务类目不需要上传资质
21320	添加的小程序服务类目包含失效类目
40001	参数错误
40003	找不到相关第三方小程序应用
40004	找不到相关授权小程序
40020	第三方小程序应用 authorizer_access_token 不正确或者已过期
40033	获取不到上传的材料，请确认文件路径正确
40036	授权小程序未授予该接口对应的权限
40052	添加的小程序类目包含定向邀约类目，仅向试点主体开放

修改服务类目审核结果通知

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

POST 数据示例：

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

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

{
    "AppId": "授权小程序的appid",
    "TpAppId": "第三方小程序应用appid",
    "EventTime": "2019-01-14 12:45:10",
    "Event": "MODIFY_APP_CATEGORY",
    "ModifyAppCategoryResults": [
        {
            "category": "158,159,259",
            "categoryName": "社交类-社交-直播",
            "status": 1,
            "reason": ""
        },
        ...
    ]
}

消息体字段含义如下：

参数名		参数类型	备注
`AppId`		`string`	授权小程序 appid
`TpAppId`		`string`	第三方小程序应用 appid
`EventTime`		`string`	推送事件时间
`Event`		`string`	推送事件类型
`ModifyAppCategoryResults`		`Array<object>`	修改服务类目的审核结果
	`category`	`string`	服务类目 id 形式
	`categoryName`	`string`	服务类目中文形式
	`reason`	`string`	如果被拒，被拒原因
	`status`	`int`	0 或 1，0 代表不通过，1 代表通过