提审代码

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

为授权小程序提审代码（审核成功后，授权小程序具有审核版本）

请求地址

POST   https://open.microapp.bytedance.com/openapi/v2/microapp/package/audit

Query 参数

参数名	参数类型	是否必须	备注
`component_appid`	`string`	是	第三方平台的 appid
`authorizer_access_token`	`string`	是	授权小程序的接口调用令牌

Body 参数（json）

参数名	参数类型	是否必须	备注
`hostNames`	`Array<string>`	是	本次需要审核的宿主端英文简称

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

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

返回值

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

返回值示例

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

v1 不支持传入宿主端参数

为授权小程序提审代码（审核成功后，授权小程序具有审核版本）

该接口有两个缺点：

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

请求地址

POST   https://open.microapp.bytedance.com/openapi/v1/microapp/package/audit

Query 参数

参数名	参数类型	是否必须	备注
`component_appid`	`string`	是	第三方平台的 appid
`authorizer_access_token`	`string`	是	授权小程序的接口调用令牌

返回值

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

返回值示例

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

错误码

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

版本审核结果通知

审核结果出来之后，会自动触发消息发送，然后第三方应用会收到由第三方服务器推送的相应授权小程序的审核结果。

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 -- 今日头条极速版
douyin -- 抖音
xigua -- 西瓜视频
huoshan -- 抖音火山版

点击纠错

评价此篇文档

提审代码
v2 支持传入宿主端参数（建议使用）
v1 不支持传入宿主端参数
版本审核结果通知