接口介绍

该接口用于第三方小程序应用为授权小程序没有通过审核的服务类目补充资质信息。
注意
    资质审核通过后,还需调用「发布类目API」将类目发布生效。

请求

基本信息

基本
HTTP URL
HTTP Method
POST
权限要求
授权小程序授予基本信息设置权限

查询参数

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

请求体(json)

参数名
参数类型
是否必须
备注
categoryInfo
Array<object>
category
string
服务类目 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"} ] }, ...... ] }
注意:
    只有审核不通过的服务类目才能补充资质信息。
    传入的服务类目以及资质 id 一定要和之前不通过的记录保持一致才可以通过校验,否则不允许补充。
    补充资质不消耗次数,但前提是要有修改次数才可以补充。

响应

响应体

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

响应体示例

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

错误码

错误码
message
21300
App 服务类目不符合规范
21303
本月没有剩余足够的修改次数,每个月只有 5 次
21308
本次补充的服务类目需要和上次保持一致
21309
本次补充的服务类目资质需要和上次保持一致
21310
提交的服务类目不处于补交状态
21321
提交的服务类目包含定向开放类目,仅向试点主体开放
21322
提交的服务类目包含失效类目
40001
参数错误
40003
找不到相关第三方小程序应用
40004
找不到相关授权小程序
40020
第三方小程序应用 authorizer_access_token 不正确或者已过期
40033
获取不到上传的材料,请确认文件路径正确
40036
授权小程序未授予该接口对应的权限

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

修改服务类目审核结果出来之后,会自动触发消息发送,然后开放平台服务器会向第三方小程序应用的【消息与事件接收 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 代表通过