第三方平台 开发指南 接口说明 代授权小程序接口 开发管理
# 开发管理
更新时间:2025-05-20 13:39:46
注意:不同接口需要的权限不同,开发管理下的接口需要开发管理权限,基本信息设置下的接口需要基本信息设置权限。
# 上传小程序代码
需要先在第三方平台将草稿添加为模板库,或者选择已存在的模板,获取到对应的模板id(template_id)。然后调用此接口可以为已授权的小程序上传代码。
注意:
1、ext_json字段里的 extEnable 需要为 true 才可以生效。
2、ext_json字段里的 extAppId 需要和已授权小程序的appId 保持一致。
3、通过该接口提交代码后,会同时生成体验版。
# 接口说明
上传小程序代码并生成体验版
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/commit |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
请求体
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| template_id | 是 | string | 模板id, 取自第三方平台 开发配置-模板管理-模板库 |
| ext_json | 是 | string | 具体格式见创建 ext.json 文件 |
| version_name | 是 | string | 提交版本 |
| description | 否 | string | 提交描述 |
{
"template_id": 1,
"description": "xxx",
"version_name": "1.1.1",
"ext_json": "{"extEnable":true,"extAppId":"xxx"}"
}
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
示例:
{
"result":1,
"error_msg":"sucess"
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 403100 | ext_json里的extEnable需要为true |
| 403101 | ext_json里的extAppId与授权小程序的AppId不一致,注意检查参数传递情况 |
# 获取已上线代码的页面列表
调用本接口可获得上线小程序代码的页面列表
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/get_page |
| Method | GET |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| page_list | array | 页面列表 |
示例:
{
"result":1,
"error_msg":"sucess",
"page_list": ["index", "page/list"]
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 404202 | 没有在线上的小程序 |
# 获取体验版二维码
调用本接口可以获取小程序的体验版二维码。
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/get_exp_qrcode |
| Method | GET |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
| path | 否 | string | 指定二维码扫码后直接进入指定页面并可同时带上参数 |
# 响应
请求正常的情况下,返回二维码图片
HTTP/1.1 200 OK
Content-Type: image/jpeg
# 错误码
| 错误码 | 说明 |
|---|---|
| 404203 | 当前小程序没有体验版 |
# 提交审核(新接口)
在调用上传小程序代码接口上传代码后,可以调用本接口,将上传的代码提交审核
# 接口说明
| 请求头 | 说明 |
| URL | https://open.kuaishou.com/openapi/mp/auth/package/submit_audit_v2 |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
Body参数
| 参数 | 是否必须 | 类型 | 备注 |
| version_desc | 是 | string | 版本描述 |
| video | 否 | string | 可访问的录频链接(当应用为“办理类”、“支付类”时,必填) |
| test_acount | 否 | string | 测试账号(需和测试密码同时填写) |
| test_pd | 否 | string | 测试密码(需和测试账号同时填写) |
| test_remark | 否 | string | 测试备注 |
# 响应
| 参数 | 类型 | 描述 |
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| auditid | string | 审核id |
示例:
{
"result":1,
"error_msg":"sucess",
"auditid": "1234"
}
# 错误码
| 错误码 | 说明 |
| 403001 | 审核提交失败,请检查当前是否正在审核中 |
| 403008 | 提审小程序保证金余额不足,不满足提交审核的条件 |
| 403009 | 小程序名称已释放,请重新提交信息 |
# 提交审核(老接口,已废弃)
提醒:不再推荐使用,建议使用新提审接口 (opens new window)
在调用上传小程序代码接口上传代码后,可以调用本接口,将上传的代码提交审核
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/submit_audit |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| auditid | string | 审核id |
示例:
{
"result":1,
"error_msg":"sucess",
"auditid": "1234"
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 403001 | 审核提交失败,请检查当前是否正在审核中 |
| 403008 | 提审小程序保证金余额不足,不满足提交审核的条件 |
| 403009 | 小程序名称已释放,请重新提交信息 |
# 查询指定发布审核单的审核状态
提交审核后,调用本接口可以查询指定发布审核单的审核状态
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/get_audit_status |
| Method | GET |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
| auditid | 是 | string | 提交审核接口返回的结果auditid |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| status | number | 当前审核单状态 |
| rejection_reasons | object[] | 审核拒绝理由 |
审核状态status说明:
| status值 | 说明 |
|---|---|
| 0 | 审核中 |
| 1 | 已拒绝 |
| 2 | 已通过 |
| 3 | 已上线 |
| 4 | 已撤回 |
审核拒绝理由rejection_reasons说明
| 参数 | 类型 | 描述 |
| rejection_reason | string | 原因 |
| image | string[] | 截图链接(30min有效期) |
| video | string[] | 视频链接(30min有效期) |
示例:
{
"result":1,
"error_msg":"sucess",
"status": 0,
"rejection_reasons": []
}
// 审核拒绝
{
"result":1,
"error_msg":"sucess",
"status": 1,
"rejection_reasons": [
{
"rejection_reason": "拒绝理由",
"image": ["图片链接"],
"video": ["视频链接"]
}
]
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 404205 | 未找到当前auditid的审核记录 |
# 查询最新一次提交的审核状态
调用本接口可以查询最新一次提审单的审核状态。
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/get_last_audit_status |
| Method | GET |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| status | number | 当前审核单状态 |
| rejection_reasons | object[] | 审核拒绝理由 |
审核状态status说明:
| status值 | 说明 |
|---|---|
| 0 | 审核中 |
| 1 | 已拒绝 |
| 2 | 已通过 |
| 3 | 已上线 |
| 4 | 已撤回 |
审核拒绝理由rejection_reasons说明
| 参数 | 类型 | 描述 |
| rejection_reason | string | 原因 |
| image | string[] | 截图链接(30min有效期) |
| video | string[] | 视频链接(30min有效期) |
示例:
{
"result":1,
"error_msg":"sucess",
"status": 0,
"rejection_reasons": []
}
// 审核拒绝
{
"result":1,
"error_msg":"sucess",
"status": 1,
"rejection_reasons": [
{
"rejection_reason": "拒绝理由",
"image": ["图片链接"],
"video": ["视频链接"]
}
]
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 404204 | 未找到在审核中状态的小程序 |
# 小程序审核撤回
调用本接口可以撤回当前的代码审核单
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/review_recall |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
示例:
{
"result":1,
"error_msg":"sucess"
}
# 发布已通过审核的小程序
调用本接口可以发布最后一个审核通过的小程序代码版本。
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/release |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
示例:
{
"result":1,
"error_msg":"sucess"
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 404009 | 没有可发布的小程序 |
# 版本回退
调用本接口可以将小程序的线上版本进行回退。
注意:只支持回退上一版本
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/revert |
| Method | POST |
| Content-Type | application/json |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
示例:
{
"result":1,
"error_msg":"sucess"
}
# 错误码
| 错误码 | 说明 |
|---|---|
| 403003 | 没有可回退的版本 |
| 403005 | 不能回退已下线的小程序 |
| 403002 | 当前已回退 |
# 获取小程序版本信息
该接口用于第三方应用为授权小程序获取小程序版本列表信息。
# 接口说明
| 请求头 | 说明 |
|---|---|
| URL | https://open.kuaishou.com/openapi/mp/auth/package/version |
| Method | GET |
# 请求参数
查询参数
| 参数 | 是否必须 | 类型 | 备注 |
|---|---|---|---|
| component_app_id | 是 | string | 第三方应用 appid |
| authorizer_access_token | 是 | string | 授权小程序接口调用凭据 |
# 响应
| 参数 | 类型 | 描述 |
|---|---|---|
| result | number | 状态码 1-成功 非1-错误码 |
| error_msg | string | 错误提示信息,参考常见错误码 |
| info | object | 通用信息 |
| online | object | 线上版本 |
| audit | object | 审核版本 |
| dev | Array | 开发版本 |
通用信息
| 参数 | 类型 | 描述 |
|---|---|---|
| version | string | 版本号 |
| create_time | string | 创建时间的时间戳 |
线上版本
| 参数 | 类型 | 描述 |
|---|---|---|
| version | string | 线上版本版本号 |
| is_offline | boolean | 是否下架 |
| can_revert | boolean | 能否回退 |
| can_revert_version | string | 可回退版本号 |
| create_time | string | 创建时间的时间戳 |
审核版本
| 参数 | 类型 | 描述 |
|---|---|---|
| version | string | 提交审核中的版本 |
| status | number | 审核状态 0审核中 1审核拒绝 2审核通过 |
| can_revert | string | 审核不通过原因 |
| can_revert_version | string | 创建时间的时间戳 |
开发版本
| 参数 | 类型 | 描述 |
|---|---|---|
| version | string | 提交审核中的版本 |
| create_time | string | 创建时间的时间戳 |
| is_in_review | boolean | 是否在审核中 |
示例:
{
"result": 1,
"error_msg": "success",
"info": {
"version": "1.0.0",
"create_time": "1637669795533"
},
"online": {
"version": "1.0.0",
"create_time": "1637669795533",
"is_offline": true,
"can_revert": false
},
"audit": {
"version": "0.0.1",
"create_time": "1635489354453",
"status": 2,
"reason": ""
},
"dev": [
{
"version": "1.0.0",
"create_time": "1612247075583",
"is_in_review": false
},
{
"version": "0.0.1",
"create_time": "1634735367422",
"is_in_review": true
}
]
}