提审代码

更新时间 2024-07-24 02:58:49

我的收藏

接口介绍

该接口用于第三方小程序应用为授权小程序提审代码（审核成功后，授权小程序具有审核版本）。

注意：

•

该接口依赖获取可选审核宿主端列表接口。

请求

基本信息

基本
HTTP URL	https://open.microapp.bytedance.com/openapi/v2/microapp/package/audit
HTTP Method	POST
权限要求	授权小程序授予开发管理权限

查询参数

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

请求体（json）

参数名	参数类型	是否必须	备注
hostNames	Array<string>	是	本次需要审核的宿主端英文简称
auditNote	string	否	本次提审的备注信息
auditWay	number	否	是否用上次失败的版本重新提审，不传或传0表示正常提审，传1表示用上次审核失败的版本重新提审

请求体示例

json复制
{
  "hostNames": ["toutiao", "douyin"],
  "auditNote": "提审小程序的备注信息",
  "auditWay": 1
}

注意：

•

本接口入参 hostNames 需要根据获取可选审核宿主端列表接口中的 hostNames 返回值进行填写。比如说获取可选审核宿主端列表接口返回 ["toutiao", "douyin", "tt_lite"]，则提审代码接口 Body 参数只能传入 ["toutiao", "douyin", "tt_lite"] 的子集。

•

如提审小程序涉及测试账号/密码，请通过接口的 auditNote 参数同步，避免拒审，影响小程序的发版上线。参数选填，不超过200字符。

响应

响应体

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

响应体示例

json复制
{
  "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	小程序未进行隐私协议配置或更新，请前往平台进行更新
40001	参数错误
40003	找不到相关第三方小程序应用
40004	找不到相关授权小程序
40020	第三方小程序应用 authorizer_access_token 不正确或者已过期
40036	授权小程序未授予该接口对应的权限

版本审核结果通知

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

POST 数据示例：

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

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

json复制
{
    "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 可能为空字符串。

宿主端对应关系为：

js复制
toutiao -- 今日头条
tt_lite -- 今日头条lite
douyin -- 抖音
douyin_lite -- 抖音lite
xigua -- 西瓜视频
huoshan -- 抖音火山版

该文档是否有帮助？

本页导读

提审代码

​接口介绍​

​请求​

​基本信息​

​查询参数​

​请求体（json）​

​请求体示例​

​响应​

​响应体​

​响应体示例​

​错误码​

​版本审核结果通知​

接口介绍

请求

基本信息

查询参数

请求体（json）

请求体示例

响应

响应体

响应体示例

错误码

版本审核结果通知