第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

增加服务类目

该接口用来为小程序添加服务类目。由于小程序主体的不同(个人或企业),允许添加的服务类目也不同。

请求地址

POST   https://open.microapp.bytedance.com/openapi/v1/microapp/app/add_categories

 

Query 参数

参数名参数类型是否必须备注
component_appidstring第三方平台的 appid
authorizer_access_tokenstring授权小程序的接口调用令牌

Body 参数(json)

参数名参数类型是否必须备注
categorystring服务类目 id 形式
categoryCertArray<object>需要上传的所有资质信息
idstring资质 id
namestring资质名称
pathstring需要上传的资质的文件路径。
注意:如果想要设置的服务类目需要上传资质,则需要根据规则调用 上传图片材料 接口先上传,然后在此传入文件路径

Body 参数示例

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

注意:

  • 最多设置 5 个服务类目;
  • 一定要注意服务类目之间的层级关系,不然接口会报错;
  • 在想要设置的服务类目允许的范围内,资质可以多传,但不能少传;
  • 不需要资质的服务类目,因为不需要审核,所以不要填写 categoryCert 字段,不然接口会报错;

 

返回值

参数名参数类型备注
errnoint错误码
messagestring错误信息

返回值示例

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

错误码

参数名参数类型
21300App 服务类目不符合规范
21301无效的服务类目
21302无效的服务类目资质
21303本月没有剩余足够的修改次数,每个月只有 3 次
21304超过 5 个服务类目的设置
21306添加的小程序服务类目存在重复
21315此服务类目不需要上传资质
40033获取不到上传的图片材料,请确认文件路径正确

 

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

修改服务类目审核结果出来之后,会自动触发消息发送,然后第三方应用会收到由第三方服务器推送的相应授权小程序的修改服务类目的审核结果。

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": ""
        },
        ...
    ]
}

消息体字段含义如下:

参数名参数类型备注
AppIdstring授权小程序的 appid
TpAppIdstring第三方平台的 appid
EventTimestring推送事件时间
Eventstring推送事件类型
ModifyAppCategoryResultsArray<object>修改服务类目的审核结果
categorystring服务类目 id 形式
categoryNamestring服务类目中文形式
reasonstring如果被拒,被拒原因
statusint0 或 1,0 代表不通过,1 代表通过
点击纠错
评价此篇文档