接口介绍

该接口用于第三方小程序应用为授权小程序提审代码(审核成功后,授权小程序具有审核版本)。
注意
该接口依赖获取可选审核宿主端列表接口。

请求

基本信息

基本
HTTP URL
HTTP Method
POST
权限要求
授权小程序授予开发管理权限

查询参数

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

请求体(json)

参数名
参数类型
是否必须
备注
hostNames
Array<string>
本次需要审核的宿主端英文简称。注意:小程序线上版本只有一个,在其它未被传入的宿主端,小程序将对用户不可见。
auditNote
string
本次提审的备注信息
auditWay
number
是否用上次失败的版本重新提审,不传或传0表示正常提审,传1表示用上次审核失败的版本重新提审

请求体示例

{ "hostNames": ["toutiao", "douyin"], "auditNote": "提审小程序的备注信息", "auditWay": 1 }
注意:
    如提审小程序涉及测试账号/密码,请通过接口的 auditNote 参数同步,避免拒审,影响小程序的发版上线。参数选填,不超过200字符。

响应

响应体

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

响应体示例

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

错误码

错误码
message
10100
AppID 错误
10003
该用户没有操作权限
10104
该小程序主体被封禁,此主体下所有小程序无法进行主体认证、提审、发布
10107
该小程序被封禁,不可进行主体认证、提审、发布
10108
第三方小程序应用绑定的开发小程序不能提审、发布
10109
由于长时间未提交版本审核,该小程序/小游戏名称已经被重置,不能提审、发布,请修改名称后重试
11300
提交审核失败,请稍后再试
11301
提审太过频繁,10 秒后重试
11302
测试版本未找到
11302
无可重新提审的版本(仅在重新提审时有此错误)
11303
已有版本在审核中,请审核后再提交
11305
主体认证未完成,请前往总览进行重新认证
11306
基本信息未填写完成,基本信息包含:名称、简介、图标、服务类目(服务类目至少有一个通过)
11307
请选择正确的应审端
11309
小程序服务类目包含失效类目,无法提审
11310
小程序服务类目包含无权限类目,无法提审;详情原因参考接口响应体 message 信息
11311
审核备注最大长度为 200
11312
小程序未进行隐私协议配置或更新,请前往平台进行更新
11317
请预设主营类目后重试,详情查看预设主营类目
40001
参数错误
40003
找不到相关第三方小程序应用
40004
找不到相关授权小程序
40020
第三方小程序应用 authorizer_access_token 不正确或者已过期
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": "PACKAGE_AUDIT", "AuditResults": [ { "hostName": "toutiao", "reason": ["", ""], "status": 1, "auditDetail": [ { "reason":"xxx", "modifyGuide": { "name":"xxx", "link":"xxx" }, "detailFile":"xxx" }, ...... ] }, ...... ] }
消息体字段含义如下:
参数名
参数类型
备注
AppId
string
授权小程序 appid
TpAppId
string
第三方小程序应用 appid
EventTime
string
推送事件时间
Event
string
推送事件类型
AuditResults
Array<object>
各端的审核结果
AuditResults 说明:
参数名
参数类型
备注
hostName
string
宿主端英文简称
reason
Array<string>
如果被拒,被拒原因是 auditDetail 中所有拒绝原因的汇总
status
int
0 或 1,0 代表不通过,1 代表通过
auditDetail
Array<object>
审核的具体细节,通过时为 null
auditDetail 说明:
参数名
参数类型
备注
reason
string
被拒原因
modifyGuide
object
修改建议
detailFile
string
审核拒绝描述附件。文件格式为图片或视频
modifyGuide 说明:
参数名
参数类型
备注
name
string
修改指引名
link
string
修改指引链接
注意:拒绝描述附件由审核人员决定是否有必要给出,被拒绝时不一定会有附件,即 detailFile 可能为空字符串。
宿主端对应关系为:
toutiao -- 今日头条 tt_lite -- 今日头条lite douyin -- 抖音 douyin_lite -- 抖音lite xigua -- 西瓜视频 huoshan -- 抖音火山版