一键创建应用（Go）

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

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

查看源码：oapi-sdk-go

前提条件

• 安装 oapi-sdk-go，且 SDK 版本为最新 v3 版本。

  go get github.com/larksuite/oapi-sdk-go/v3@latest

快速开始示例

package main

import (
    "context"
    "errors"
    "fmt"
    "time"

lark "github.com/larksuite/oapi-sdk-go/v3"
    "github.com/larksuite/oapi-sdk-go/v3/scene/registration"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Minute)
    defer cancel()

result, err := registration.RegisterApp(ctx, &registration.Options{
        OnQRCode: func(info *registration.QRCodeInfo) {
            fmt.Printf("open or scan this url: %s\n", info.URL)
            fmt.Printf("the link expires in %d seconds\n", info.ExpireIn)
        },
        OnStatusChange: func(info *registration.StatusChangeInfo) {
            // status: polling | slow_down | domain_switched
            fmt.Printf("registration status: %s", info.Status)
            if info.Interval > 0 {
                fmt.Printf(", next poll after %d seconds", info.Interval)
            }
            fmt.Println()
        },
    })
    if err != nil {
        var regErr *registration.RegisterAppError
        if errors.As(err, &regErr) {
            fmt.Printf("register app failed: code=%s, description=%s\n", regErr.Code, regErr.Description)
            return
        }
        panic(err)
    }

fmt.Println("App ID:", result.ClientID)
    fmt.Println("App Secret:", result.ClientSecret)

client := lark.NewClient(result.ClientID, result.ClientSecret)
    _ = client
}

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

创建应用时，可通过 Options.Addons 在平台基础模板上增量申请权限、事件订阅和回调。这些配置会预填到用户扫码后的确认页中，用户确认后生效。Options.CreateOnly=true 时，页面只允许创建新应用；传入 Options.AppID 时，页面会进入更新已有应用配置的确认流程。

_, err := registration.RegisterApp(ctx, &registration.Options{
    Addons: &registration.AppAddons{
        Scopes: registration.AppAddonsScopes{
            Tenant: []string{"im:message:send_as_bot"},
            User:   []string{"calendar:calendar:read"},
        },
        Events: registration.AppAddonsEvents{
            Items: registration.AppAddonsEventItems{
                Tenant: []string{"im.message.receive_v1"},
            },
        },
        Callbacks: registration.AppAddonsCallbacks{
            Items: []string{"card.action.trigger"},
        },
    },
    CreateOnly: true,
    OnQRCode: func(info *registration.QRCodeInfo) {
        fmt.Println(info.URL)
    },
})
if err != nil {
    panic(err)
}

_, err = registration.RegisterApp(ctx, &registration.Options{
    AppID: "cli_xxx",
    Addons: &registration.AppAddons{
        Scopes: registration.AppAddonsScopes{
            Tenant: []string{"drive:drive.metadata:readonly"},
        },
    },
    OnQRCode: func(info *registration.QRCodeInfo) {
        fmt.Println(info.URL)
    },
})
if err != nil {
    panic(err)
}

注意：Addons 仅支持增量叠加，不支持删除基础模板中的配置；SDK 只校验数据形状和非空字符串，不校验权限点、事件或回调名称是否存在。

通过 Preset 选择模板底座

AppAddons.Preset 用于选择应用创建的模板底座（与 Options.AppPreset 无关，后者只预填应用名称、描述和头像）：

Preset 为 false 时，允许 Addons 不携带任何权限、事件或回调——页面仍会进入确认流程，创建仅含最小底座能力的应用：

preset := false
_, err := registration.RegisterApp(ctx, &registration.Options{
    Addons: &registration.AppAddons{
        Preset: &preset,
    },
    OnQRCode: func(info *registration.QRCodeInfo) {
        fmt.Println(info.URL)
    },
})
if err != nil {
    panic(err)
}

registration.RegisterApp 参数

返回值

错误处理

返回的错误通常可以通过 errors.As(err, &registration.RegisterAppError) 获取 Code 与 Description 字段。更具体的错误类型还包括 registration.AccessDeniedError 和 registration.ExpiredError。