第三方平台
接口说明

提审代码

接口介绍

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

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

注意:

请求

基本信息

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

查询参数

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

请求体(json)

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

请求体示例

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

注意:

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

响应

响应体

参数名参数类型备注
errnoint错误码
messagestring错误信息

响应体示例

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

错误码

错误码message
10100AppID 错误
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 URLhttps://open.microapp.bytedance.com/openapi/v1/microapp/package/audit
HTTP MethodPOST
权限要求授权小程序授予开发管理权限

查询参数

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

响应

响应体

参数名参数类型备注
errnoint错误码
messagestring错误信息

响应体示例

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

错误码

错误码message
10100AppID 错误
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"
                },
                ......
            ]
        },
        ......
    ]
}

新消息体字段含义如下:

参数名参数类型备注
AppIdstring授权小程序 appid
TpAppIdstring第三方应用 appid
EventTimestring推送事件时间
Eventstring推送事件类型
AuditResultsArray<object>各端的审核结果

AuditResults 说明:

参数名参数类型备注
hostNamestring宿主端英文简称
reasonArray<string>如果被拒,被拒原因是 auditDetail 中所有拒绝原因的汇总
statusint0 或 1,0 代表不通过,1 代表通过
auditDetailArray<object>审核的具体细节,通过时为 null

auditDetail 说明:

参数名参数类型备注
reasonstring被拒原因
modifyGuideobject修改建议
detailFilestring审核拒绝描述附件。文件格式为图片或视频

modifyGuide 说明:

参数名参数类型备注
namestring修改指引名
linkstring修改指引链接

注意:

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

宿主端对应关系为:

toutiao -- 今日头条
tt_lite -- 今日头条lite
douyin -- 抖音
xigua -- 西瓜视频
huoshan -- 抖音火山版
点击纠错
评价此篇文档