第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

提审代码

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

为授权小程序提审代码(审核成功后,授权小程序具有审核版本)

请求地址

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

 

Query 参数

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

Body 参数(json)

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

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

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

 

返回值

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

返回值示例

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

 

v1 不支持传入宿主端参数

为授权小程序提审代码(审核成功后,授权小程序具有审核版本)

该接口有两个缺点:

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

请求地址

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

 

Query 参数

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

 

返回值

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

返回值示例

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

错误码

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

新消息体字段含义如下:

参数名参数类型备注
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 字段为新增部分,其余均无改动

宿主端对应关系为:

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