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

补充服务类目资质信息

该接口用来为小程序没有通过审核的服务类目补充资质信息。

请求地址

POST   https://open.microapp.bytedance.com/openapi/v1/microapp/app/supply_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"}
            ]
        },
        ......
    ]
}

注意:

  • 只有审核不通过的服务类目才能补充资质信息;
  • 传入的服务类目以及资质 id 一定要和之前不通过的记录保持一致才可以通过校验,否则不允许补充;
  • 补充资质不消耗次数,但前提是要有修改次数才可以补充;

 

返回值

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

返回值示例

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

错误码

参数名参数类型
21300App 服务类目不符合规范
21303本月没有剩余足够的修改次数,每个月只有 3 次
21308本次补充的服务类目需要和上次保持一致
21309本次补充的服务类目资质需要和上次保持一致
21310提交的服务类目不处于补交状态
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 代表通过
点击纠错
评价此篇文档