提审代码

接口介绍

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

v2 支持传入审核宿主端参数（建议使用）

注意：

相比 v1 版本的接口，请求路径、请求参数变化。
该接口依赖获取可选宿主端列表接口。

请求

基本信息

基本
`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>`	是	本次需要审核的宿主端英文简称

请求体示例

{
  "hostNames": ["toutiao", "douyin"]
}

注意：

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

响应

响应体

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

响应体示例

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

错误码

错误码	message
10100	AppID 错误
10003	该用户没有操作权限
10104	该小程序主体被封禁，此主体下所有小程序无法进行主体认证、提审、发布
10107	该小程序被封禁，不可进行主体认证、提审、发布
10108	第三方应用绑定的开发小程序不能提审、发布
10109	由于长时间未提交版本审核，该小程序/小游戏名称已经被重置，不能提审、发布，请修改名称后重试
11300	提交审核失败，请稍后再试
11301	提审太过频繁，10 秒后重试
11302	测试版本未找到
11303	已有版本在审核中，请审核后再提交
11305	主体认证未完成，请前往总览进行重新认证
11306	基本信息完未填写完成，基本信息包含：名称、简介、图标、服务类目(服务类目至少有一个通过)
11307	请选择正确的应审端
40001	参数错误
40003	找不到相关第三方应用
40004	找不到相关授权小程序
40020	第三方应用 authorizer_access_token 不正确或者已过期
40036	授权小程序未授予该接口对应的权限

v1 不支持传入宿主端参数

该接口有两个缺点：

因为不支持传入宿主端参数，每次审核都会审该小程序默认配置的宿主端，灵活性较差，比如说默认 toutiao、tt_lite、douyin，后面申请加入 xigua 端审核，但是调该接口并不会生效。
现有的审核流程规则为一端不通过则整个审核不通过，不再像以前 douyin 端审核不通过仍然可以发布剩余通过审核的端。所以建议没有准备好的情况下，调 v2 接口选择合适的宿主端去提审。

请求

基本信息

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

查询参数

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

响应

响应体

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

响应体示例

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

错误码

错误码	message
10100	AppID 错误
10003	该用户没有操作权限
10104	该小程序主体被封禁，此主体下所有小程序无法进行主体认证、提审、发布
10107	该小程序被封禁，不可进行主体认证、提审、发布
10108	第三方应用绑定的开发小程序不能提审、发布
10109	由于长时间未提交版本审核，该小程序/小游戏名称已经被重置，不能提审、发布，请修改名称后重试
11300	提交审核失败，请稍后再试
11301	提审太过频繁，10 秒后重试
11302	测试版本未找到
11303	已有版本在审核中，请审核后再提交
11305	主体认证未完成，请前往总览进行重新认证
11306	基本信息完未填写完成，基本信息包含：名称、简介、图标、服务类目(服务类目至少有一个通过)
11307	请选择正确的应审端
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,
        },
        ......
    ]
}

新：
{
    "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`	修改指引链接

注意：

auditDetail 字段为新增部分，其余均无改动。
拒绝描述附件由审核人员决定是否有必要给出，被拒绝时不一定会有附件，即 detailFile 可能为空字符串。

宿主端对应关系为：

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

点击纠错

该文档是否对你的开发有所帮助？

有帮助

没帮助

该文档是否对你的开发有所帮助？

有帮助

没帮助

提审代码
接口介绍
v2 支持传入审核宿主端参数（建议使用）
请求
响应
v1 不支持传入宿主端参数
请求
响应
版本审核结果通知