Skip to content

提交发布自建应用

自建应用提交应用发布,如果当前自建应用没有待发布的版本,则会自动创建一个版本,如果有待发布的版本,则直接提交该版本。

Tip: - 若用 user_access_token 代表某个终端用户操作API,则需确保该用户为应用的所有者、管理员,否则无法操作成功

  • 若用 tenant_access_token 代表应用操作API,则仅可操作自身

Warning: 仅支持发布开发者后台创建的自建应用,不包含通过机器人助手等其他渠道创建的自建应用

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/application/v7/applications/:app_id/publish
HTTP MethodPOST
接口频率限制20 次/分钟
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用application:application:patch 修改应用信息

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

路径参数

名称类型描述
app_idstring应用的app_id 如何获取应用的 App ID
示例值:"cli_a508dbf34038d01c"

请求体

名称类型必填描述
mobile_default_abilitystring移动端默认能力
注意:如果应用开启了小程序、机器人或者网页应用能力,则该参数必填。
示例值:"gadget"
可选值有
- gadget: 小程序 - web_app: 网页应用 - bot: 机器人
pc_default_abilitystringPC端默认能力
注意:如果应用开启了小程序、机器人或者网页应用能力,则该参数必填。
示例值:"gadget"
可选值有
- gadget: 小程序 - web_app: 网页应用 - bot: 机器人
remarkstring申请理由(500字符以内)
示例值:"更新了移动端默认应用能力"
changelogstring更新描述(500字符以内)
示例值:"更新了小程序的头像"
versionstring应用版本号
示例值:"1.1.1"

请求体示例

json
{
    "mobile_default_ability": "gadget",
    "pc_default_ability": "gadget",
    "remark": "更新了移动端默认应用能力",
    "changelog": "更新了小程序的头像",
    "version": "1.1.1"
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ version_idstring应用版本ID
  └ versionstring应用版本号

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "version_id": "oav_d317f090b7258ad0372aa53963cda70d",
        "version": "1.1.1"
    }
}

错误码

HTTP状态码错误码描述排查建议
400210001As the app was not created in our developer console, it cannot be released using this API.仅可以操作开发者后台创建的应用,请使用开发者后台创建的应用调用该API
400210302Unable to submit the release request, as the app is currently under review.应用正在审核中,不能进行该操作,请等待审核通过后再尝试
500210003Internal server error服务内部错误,请稍候重试或联系技术支持(https://applink.feishu.cn/TLJpeNdW)
400210303Invalid version number. The number should be in the form X.X.X版本号格式不对,且必须递增。请将版本号修改为X.X.X格式(如1.0.0)并确保版本号高于当前版本
400210304Missing required fields检查必填字段是否填写
403210036Lack of permission to update other app.应用身份调用仅允许更新自身,不允许更新其它应用。请使用应用自身的 app_id 调用该 API,或避免尝试更新其他应用。

内容来源:飞书开放平台 · 自动爬取整理