一键创建应用（Java）

Java SDK 提供了 RegisterApp.register 方法，基于 OAuth 2.0 Device Authorization Grant（RFC 8628）协议实现一键创建应用。

调用该方法会返回一个验证链接，用户在飞书或 Lark 中打开该链接（或扫码）完成授权后，即可自动注册应用并获取凭据（App ID 和 App Secret），无需手动前往开发者后台创建。

查看源码：oapi-sdk-java

前提条件

• 安装 oapi-sdk，且 SDK 版本为 2.6.1 及以上。

Maven：

  <dependency>
      <groupId>com.larksuite.oapi</groupId>
      <artifactId>oapi-sdk</artifactId>
      <version>2.6.1</version>
  </dependency>

快速开始示例

import com.lark.oapi.scene.registration.AppPreset;
import com.lark.oapi.scene.registration.RegisterApp;
import com.lark.oapi.scene.registration.RegisterAppException;
import com.lark.oapi.scene.registration.RegisterAppOptions;
import com.lark.oapi.scene.registration.RegisterAppResult;

public class Sample {

public static void main(String[] args) {
        try {
            RegisterAppResult result = RegisterApp.register(
                    RegisterAppOptions.newBuilder()
                            .source("test")
                            .appPreset(AppPreset.newBuilder()
                                    .avatars(
                                            "https://s1-imfile.feishucdn.com/static-resource/v1/v3_00cj_d6bebede-c56b-40a2-b767-8e9da07f3b3g",
                                            "https://s1-imfile.feishucdn.com/static-resource/v1/v2_bc5d2075-fcbd-41f8-bfe3-5a5ecbf0f7dg"
                                    )
                                    .name("{user}的应用")
                                    .desc("由业务平台自动生成")
                                    .build())
                            .onQRCode(info -> {
                                System.out.println("Please scan the QR code:");
                                System.out.println(info.getUrl());
                                System.out.println(String.format("Link expires in %s seconds", info.getExpireIn()));
                            })
                            .onStatusChange(info -> System.out.println(
                                    "status: " + info.getStatus()
                                            + (info.getInterval() > 0
                                            ? String.format(" (Interval: %s seconds)", info.getInterval())
                                            : "")
                            ))
                            .build()
            );

System.out.println("App ID: " + result.getClientId());
            System.out.println("App Secret: " + result.getClientSecret());
            System.out.println("User Info: " + result.getUserInfo());
        } catch (RegisterAppException e) {
            System.err.println("fail: " + e.getCode() + " " + e.getDescription());
        }
    }
}

真实可运行示例：

• RegisterAppRealDemo
• RegisterAppAppPresetE2E

自定义权限/事件/回调与更新已有应用

创建应用时，可以通过 addons 在平台基础模板上增量申请权限、事件订阅和回调。这些配置会预填到用户打开验证链接后的确认页中，用户确认后生效：

import com.lark.oapi.scene.registration.AppAddons;

// 创建：增量申请权限/事件/回调，且只允许创建新应用。
RegisterApp.register(RegisterAppOptions.newBuilder()
        .addons(AppAddons.newBuilder()
                .tenantScopes("im:message:send_as_bot")
                .userScopes("calendar:calendar:read")
                .tenantEvents("im.message.receive_v1")
                .callbacks("card.action.trigger")
                .build())
        .createOnly(true)
        .onQRCode(info -> System.out.println(info.getUrl()))
        .build());

// 更新：传入已有应用的 appId，让用户确认增量配置变更。
RegisterApp.register(RegisterAppOptions.newBuilder()
        .appId("cli_xxx")
        .addons(AppAddons.newBuilder()
                .tenantScopes("drive:drive.metadata:readonly")
                .build())
        .onQRCode(info -> System.out.println(info.getUrl()))
        .build());

// 最小底座：preset(false) 把底座切换为最小基础模板，确认页只展示 addons 中显式声明的配置。
// 此时增量项可以为空。
RegisterApp.register(RegisterAppOptions.newBuilder()
        .addons(AppAddons.newBuilder()
                .preset(false)
                .tenantScopes("im:message:send_as_bot")
                .build())
        .onQRCode(info -> System.out.println(info.getUrl()))
        .build());

• addons 仅支持增量叠加，不能删减基础模板里的权限。
• addons.preset 控制底座模板：缺省或 true 保留平台默认模板（含默认权限/事件/回调）；false 切换为最小基础模板（仅机器人能力，无业务权限），最终配置完全由 addons 声明。preset(false) 时增量项可以全部为空。
• 仅支持 5 类公开配置：应用/用户身份权限、应用/用户身份事件、回调。事件请求 URL、security.*、加密 key 等敏感配置不能通过 addons 传入，需要使用更新应用开发配置 OpenAPI。
• SDK 校验数据形状和非空值，不校验权限点/事件/回调名称是否存在于平台目录。

RegisterAppOptions 参数

返回值

状态回调

错误处理

RegisterAppException 包含 code 和 description 字段：