lark

package module

v3.1.4 Latest Latest Go to latest Published: Dec 15, 2023 License: MIT Imports: 48 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/zjl233/oapi-sdk-go

Links

Open Source Insights

README ¶

飞书开放接口SDK

旨在让开发者便捷的调用飞书开放API、处理订阅的消息事件、处理服务端推送的卡片行为。

安装

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

API Client

开发者在调用 API 前，需要先创建一个 API Client，然后才可以基于 API Client 发起 API 调用。

创建API Client

对于自建应用，可使用下面代码来创建一个 API Client

var client = lark.NewClient("appID", "appSecret") // 默认配置为自建应用

对于商店应用，需在创建 API Client 时，使用 lark.WithMarketplaceApp 方法指定 AppType 为商店应用。商店应用开发指南可点击这里查看

var client = lark.NewClient("appID", "appSecret",lark.WithMarketplaceApp()) // 设置App为商店应用

配置API Client

创建 API Client 时，可对 API Client 进行一定的配置，比如我们可以在创建 API Client 时设置日志级别、设置 http 请求超时时间等等：

var client = lark.NewClient("appID", "appSecret",
    lark.WithLogLevel(larkcore.LogLevelDebug),
    lark.WithReqTimeout(3*time.Second),
    lark.WithEnableTokenCache(true),
    lark.WithHelpdeskCredential("id", "token"),
    lark.WithHttpClient(http.DefaultClient))

每个配置选项的具体含义，如下表格：

配置选项	配置方式	描述
`AppType`	`lark.WithMarketplaceApp()`	设置 App 类型为商店应用，ISV 开发者必须要设置该选项。
`LogLevel`	`lark.WithLogLevel(logLevel larkcore.LogLevel)`	设置 API Client 的日志输出级别(默认为 Info 级别)，枚举值如下： LogLevelDebug LogLevelInfo LogLevelWarn LogLevelError
`Logger`	`lark.WithLogger(logger larkcore.Logger)`	设置API Client的日志器，默认日志输出到标准输出。开发者可通过实现下面的 Logger 接口，来设置自定义的日志器: `type Logger interface { Debug(context.Context, ...interface{}) Info(context.Context, ...interface{}) Warn(context.Context, ...interface{}) Error(context.Context, ...interface{}) }`
`LogReqAtDebug`	`lark.WithLogReqAtDebug(printReqRespLog bool)`	设置是否开启 Http 请求参数和响应参数的日志打印开关；开启后，在 debug 模式下会打印 http 请求和响应的 headers,body 等信息。在排查问题时，开启该选项，有利于问题的排查。
`BaseUrl`	`lark.WithOpenBaseUrl(baseUrl string)`	设置飞书域名，默认为FeishuBaseUrl，可用域名列表为： `// 飞书域名 var FeishuBaseUrl = "https://open.feishu.cn" // Lark域名 var LarkBaseUrl = "https://open.larksuite.com"`
`TokenCache`	`lark.WithTokenCache(cache larkcore.Cache)`	设置 token 缓存器，用来缓存 token 和 appTicket, 默认实现为内存。如开发者想要定制 token 缓存器，需实现下面 Cache 接口: `type Cache interface { Set(ctx context.Context, key string, value string, expireTime time.Duration) error Get(ctx context.Context, key string) (string, error) }` 对于 ISV 开发者来说，如需要 SDK 来缓存 appTicket，需要实现该接口，实现提供分布式缓存。
`EnableTokenCache`	`lark.WithEnableTokenCache(enableTokenCache bool)`	设置是否开启 TenantAccessToken 的自动获取与缓存。默认开启，如需要关闭可传递 false。
`HelpDeskId、HelpDeskToken`	`lark.WithHelpdeskCredential(helpdeskID, helpdeskToken string)`	该选项仅在调用服务台业务的 API 时需要配置。
`ReqTimeout`	`lark.WithReqTimeout(time time.Duration)`	设置 SDK 内置的 Http Client 的请求超时时间，默认为0代表永不超时。
`HttpClient`	`lark.WithHttpClient(httpClient larkcore.HttpClient)`	设置 HttpClient，用于替换 SDK 提供的默认实现。开发者可通过实现下面的 HttpClient 接口来设置自定义的 HttpClient: `type HttpClient interface { Do(http.Request) (http.Response, error) }`

API调用

创建完毕 API Client，我们可以使用 Client.业务域.资源.方法名称 来定位具体的 API 方法，然后对具体的 API 发起调用。商店应用开发指南可点击这里查看

飞书开放平台开放的所有 API 列表，可点击这里查看

基本用法

如下示例我们通过 client 调用文档业务的 Create 方法，创建一个文档：

import (
	"context"
	"fmt"

	"github.com/larksuite/oapi-sdk-go/v3"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/service/docx/v1"
)


func main() {
	// 创建 client
	client := lark.NewClient("appID", "appSecret")

	// 发起请求
	resp, err := client.Docx.Document.Create(context.Background(), larkdocx.NewCreateDocumentReqBuilder().
		Body(larkdocx.NewCreateDocumentReqBodyBuilder().
			FolderToken("token").
			Title("title").
			Build()).
		Build())

	//处理错误
	if err != nil {
           // 处理err
           return
	}

	// 服务端错误处理
	if !resp.Success() {
           fmt.Println(resp.Code, resp.Msg, resp.RequestId())
	   return 
	}

	// 业务数据处理
	fmt.Println(larkcore.Prettify(resp.Data))
}

更多 API 调用示例：./sample/api/im.go

设置请求选项

开发者在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 UserAccessToken ,自定义 Headers 等：

import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/service/docx/v1"
)

func main() {
	// 创建client
	client := lark.NewClient("appID", "appSecret")

	// 自定义请求headers
	header := make(http.Header)
	header.Add("k1", "v1")
	header.Add("k2", "v2")

	// 发起请求
	resp, err := client.Docx.Document.Create(context.Background(), larkdocx.NewCreateDocumentReqBuilder().
		Body(larkdocx.NewCreateDocumentReqBodyBuilder().
			FolderToken("token").
			Title("title").
			Build(),
		).
		Build(),
		larkcore.WithHeaders(header), // 设置自定义headers
	)

	//处理错误
	if err != nil {
	   // 处理err
	   return
	}

	// 服务端错误处理
	if !resp.Success() {
	   fmt.Println(resp.Code, resp.Msg, resp.RequestId())
	   return
	}

	// 业务数据处理
	fmt.Println(larkcore.Prettify(resp.Data))
}

如下表格，展示了所有请求级别可设置的选项：

配置选项	配置方式	描述
`Header`	`larkcore.WithHeaders(header http.Header)`	设置自定义请求头，开发者可在发起请求时，这些请求头会被透传到飞书开放平台服务端。
`UserAccessToken`	`larkcore.WithUserAccessToken(userAccessToken string)`	设置用户token，当开发者需要以用户身份发起调用时，需要设置该选项的值。
`TenantAccessToken`	`larkcore.WithTenantAccessToken(tenantAccessToken string)`	设置租户 token，当开发者自己维护租户 token 时（即创建Client时EnableTokenCache设置为了false），需通过该选项传递租户 token。
`TenantKey`	`larkcore.WithTenantKey(tenantKey string)`	设置租户 key, 当开发者开发商店应用时，必须设置该选项。
`RequestId`	`larkCore.WithRequestId(requestId string)`	设置请求 ID，用来做请求的唯一标识，该 ID 会被透传到飞书开放平台服务端。

原生API调用方式

有些老版本的开放接口，不能生成结构化的 API，导致 SDK 内无法提供结构化的使用方式，这时可使用原生模式进行调用：



import (
	"context"
	"fmt"
	"github.com/larksuite/oapi-sdk-go/v3"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"net/http"
	"os"
)

func main() {
	// 创建 API Client
	var appID, appSecret = os.Getenv("APP_ID"), os.Getenv("APP_SECRET")
	var cli = lark.NewClient(appID, appSecret)

	// 发起请求
	resp, err := cli.Do(context.Background(),
		&larkcore.ApiReq{
			HttpMethod:                http.MethodGet,
			ApiPath:                   "https://open.feishu.cn/open-apis/contact/v3/users/:user_id",
			Body:                      nil,
			QueryParams:               larkcore.QueryParams{"user_id_type": []string{"open_id"}},
			PathParams:                larkcore.PathParams{"user_id": "ou_c245b0a7dff2725cfa2fb104f8b48b9d"},
			SupportedAccessTokenTypes: []larkcore.AccessTokenType{larkcore.AccessTokenTypeUser},
		},
	)

	// 错误处理
	if err != nil {
		fmt.Println(err)
		return
	}

	// 获取请求 ID
	fmt.Println(resp.RequestId())

	// 处理请求结果
	fmt.Println(resp.StatusCode)      // http status code
	fmt.Println(resp.Header)          // http header
	fmt.Println(string(resp.RawBody)) // http body,二进制数据
}

更多 API 调用示例：./sample/callrawapi/api.go

处理消息事件回调

关于消息订阅相关的知识，可以点击这里查看

飞书开放平台开放的所有事件列表，可点击这里查看

基本用法

开发者订阅消息事件后，可以使用下面代码，对飞书开放平台推送的消息事件进行处理，如下代码基于 go-sdk 原生 http server 启动一个 httpServer：

import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/event"
	"github.com/larksuite/oapi-sdk-go/v3/event/dispatcher"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
	"github.com/larksuite/oapi-sdk-go/v3/service/im/v1"
)

func main() {
    // 注册消息处理器
    handler := dispatcher.NewEventDispatcher("verificationToken", "eventEncryptKey").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error {
        // 处理消息 event，这里简单打印消息的内容 
        fmt.Println(larkcore.Prettify(event))
        fmt.Println(event.RequestId())
        return nil
    }).OnP2MessageReadV1(func(ctx context.Context, event *larkim.P2MessageReadV1) error {
        // 处理消息 event，这里简单打印消息的内容
        fmt.Println(larkcore.Prettify(event))
        fmt.Println(event.RequestId())
        return nil
    })
    
    // 注册 http 路由
    http.HandleFunc("/webhook/event", httpserverext.NewEventHandlerFunc(handler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))
    
    // 启动 http 服务
    err := http.ListenAndServe(":9999", nil)
    if err != nil {
        panic(err)
    }
}

其中 NewEventDispatcher 方法的参数用于签名验证和消息解密使用，默认可以传递为空串；但是如果开发者的应用在控制台的【事件订阅】里面开启了加密，则必须传递控制台上提供的值。

Console

需要注意的是注册处理器时，比如使用 OnP2MessageReceiveV1 注册接受消息事件回调时，其中的P2为消息协议版本，当前飞书开放平台存在两种消息协议，分别为1.0和2.0。

如下图开发者在注册消息处理器时，需从事件列表中查看自己需要的是哪种协议的事件。如果是1.0的消息协议，则注册处理器时，需要找以OnP1xxxx开头的。如果是2.0的消息协议，则注册处理器时，需要找以OnP2xxxx开头的。

Console

更多事件订阅示例：./sample/event/event.go

消息处理器内给对应租户发消息

针对 ISV 开发者，如果想在消息处理器内给对应租户的用户发送消息，则需先从消息事件内获取租户 key,然后使用下面方式调用消息 API 进行消息发送：


import (
	"context"
	"fmt"
	lark "github.com/larksuite/oapi-sdk-go/v3"
	"net/http"
	"os"

	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
	"github.com/larksuite/oapi-sdk-go/v3/event"
	"github.com/larksuite/oapi-sdk-go/v3/event/dispatcher"
	"github.com/larksuite/oapi-sdk-go/v3/service/im/v1"
)

func main() {

	// 创建 API Client
	var appID, appSecret = os.Getenv("APP_ID"), os.Getenv("APP_SECRET")
	var cli = lark.NewClient(appID, appSecret, lark.WithLogReqAtDebug(true), lark.WithLogLevel(larkcore.LogLevelDebug))

	// 注册消息处理器
	handler := dispatcher.NewEventDispatcher("verificationToken", "eventEncryptKey").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error {
		// 处理消息 event，这里简单打印消息的内容
		fmt.Println(larkcore.Prettify(event))
		fmt.Println(event.RequestId())

		// 获取租户 key 并发送消息
		tenantKey := event.TenantKey()

		// ISV 给指定租户发送消息
		resp, err := cli.Im.Message.Create(context.Background(), larkim.NewCreateMessageReqBuilder().
			ReceiveIdType(larkim.ReceiveIdTypeOpenId).
			Body(larkim.NewCreateMessageReqBodyBuilder().
				MsgType(larkim.MsgTypePost).
				ReceiveId("ou_c245b0a7dff2725cfa2fb104f8b48b9d").
				Content("text").
				Build()).
			Build(), larkcore.WithTenantKey(tenantKey))

		// 发送结果处理，resp,err
		fmt.Println(resp, err)

		return nil
	})

	// 注册 http 路由
	http.HandleFunc("/webhook/event", httpserverext.NewEventHandlerFunc(handler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))

	// 启动 http 服务
	err := http.ListenAndServe(":9999", nil)
	if err != nil {
		panic(err)
	}
}

更多事件订阅示例：./sample/event/event.go

集成Gin框架

如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。

要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 oapi-sdk-gin

安装集成包

go get -u github.com/larksuite/oapi-sdk-gin

集成示例

import (
	"context"
	"fmt"

	 "github.com/gin-gonic/gin"
	 "github.com/larksuite/oapi-sdk-gin"
	 "github.com/larksuite/oapi-sdk-go/v3/card"
	 "github.com/larksuite/oapi-sdk-go/v3/core"
	 "github.com/larksuite/oapi-sdk-go/v3/event/dispatcher"
	 "github.com/larksuite/oapi-sdk-go/v3/service/contact/v3"
	 "github.com/larksuite/oapi-sdk-go/v3/service/im/v1"
)

func main() {
	// 注册消息处理器
	handler := dispatcher.NewEventDispatcher("verificationToken", "eventEncryptKey").OnP2MessageReceiveV1(func(ctx context.Context, event *larkim.P2MessageReceiveV1) error {
		fmt.Println(larkcore.Prettify(event))
		fmt.Println(event.RequestId())
		return nil
	}).OnP2MessageReadV1(func(ctx context.Context, event *larkim.P2MessageReadV1) error {
		fmt.Println(larkcore.Prettify(event))
		fmt.Println(event.RequestId())
		return nil
	}).OnP2UserCreatedV3(func(ctx context.Context, event *larkcontact.P2UserCreatedV3) error {
		fmt.Println(larkcore.Prettify(event))
		fmt.Println(event.RequestId())
		return nil
	})

	...

	// 在已有 Gin 实例上注册消息处理路由
	gin.POST("/webhook/event", sdkginext.NewEventHandlerFunc(handler))
}

集成hertz框架

处理卡片行为回调

关于卡片行为相关的知识，可点击这里查看

基本用法

开发者配置消息卡片回调地址后，可以使用下面代码，对飞书开放平台推送的卡片行为进行处理，如下代码基于go-sdk原生http server启动一个httpServer：

import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3/card"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
)

func main() {
	// 创建 card 处理器
	cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) {
		// 处理 cardAction, 这里简单打印卡片内容
		fmt.Println(larkcore.Prettify(cardAction))
	    fmt.Println(cardAction.RequestId())
		// 无返回值示例
		return nil, nil
	})

	// 注册处理器
	http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))

	// 启动 http 服务
	err := http.ListenAndServe(":9999", nil)
	if err != nil {
		panic(err)
	}
}

如上示例，如果不需要处理器内返回业务结果给飞书服务端，则直接使用这种无返回值用法

更多卡片行为处理示例：./sample/card/card.go

返回卡片消息

如开发者需要卡片处理器内同步返回用于更新消息卡片的消息体，则可使用下面方法方式进行处理：


import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3/card"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
)

func main() {
	// 创建card处理器
	cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) {
		fmt.Println(larkcore.Prettify(cardAction))
	    fmt.Println(cardAction.RequestId())
		
		// 创建卡片信息
		messageCard := larkcard.NewMessageCard().
		Config(config).
		Header(header).
		Elements([]larkcard.MessageCardElement{divElement, processPersonElement}).
		CardLink(cardLink).
		Build()

		return messageCard, nil
	})

	// 注册处理器
	http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))

	// 启动http服务
	err := http.ListenAndServe(":9999", nil)
	if err != nil {
		panic(err)
	}
}

更多卡片行为处理示例：./sample/card/card.go

返回自定义消息

如开发者需卡片处理器内返回自定义内容，则可以使用下面方式进行处理：

import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3/card"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
)

func main() {
	// 创建 card 处理器
	cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) {
		fmt.Println(larkcore.Prettify(cardAction))
	    fmt.Println(cardAction.RequestId())
		
		// 创建 http body
		body := make(map[string]interface{})
		body["content"] = "hello"

		i18n := make(map[string]string)
		i18n["zh_cn"] = "你好"
		i18n["en_us"] = "hello"
		i18n["ja_jp"] = "こんにちは"
		body["i18n"] = i18n 
		
		// 创建自定义消息：http状态码，body内容
		resp := &larkcard.CustomResp{
			StatusCode: 400,
			Body:       body,
		}

		return resp, nil
	})

	// 注册处理器
	http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))

	// 启动 http 服务
	err := http.ListenAndServe(":9999", nil)
	if err != nil {
		panic(err)
	}
}

更多卡片行为处理示例：./sample/card/card.go

卡片行为处理器内给对应租户发消息

针对 ISV 开发者，如果想在卡片行为处理器内给对应租户的用户发送消息，则需先从卡片行为内获取租户 key ,然后使用下面方式调用消息 API 进行消息发送：

import (
	"context"
	"fmt"
	"net/http"

	"github.com/larksuite/oapi-sdk-go/v3/card"
	"github.com/larksuite/oapi-sdk-go/v3/core"
	"github.com/larksuite/oapi-sdk-go/v3/core/httpserverext"
)

func main() {
	// 创建 card 处理器
	cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) {
        
        // 处理 cardAction, 这里简单打印卡片内容  
        fmt.Println(larkcore.Prettify(cardAction))
        fmt.Println(cardAction.RequestId())
	    
        // 获取租户 key 并发送消息
        tenanKey := cardAction.TenantKey
        
        // ISV 给指定租户发送消息
        resp, err := client.Im.Message.Create(context.Background(), larkim.NewCreateMessageReqBuilder().
                ReceiveIdType(larkim.ReceiveIdTypeOpenId).
                Body(larkim.NewCreateMessageReqBodyBuilder().
                    MsgType(larkim.MsgTypePost).
                    ReceiveId("ou_c245b0a7dff2725cfa2fb104f8b48b9d").
                    Content("text").
                    Build(), larkcore.WithTenantKey(tenanKey)).
                Build())
                
        // 发送结果处理，resp,err
		
        return nil, nil
	})

	// 注册处理器
	http.HandleFunc("/webhook/card", httpserverext.NewCardActionHandlerFunc(cardHandler, larkevent.WithLogLevel(larkcore.LogLevelDebug)))

	// 启动 http 服务
	err := http.ListenAndServe(":9999", nil)
	if err != nil {
		panic(err)
	}
}

更多卡片行为处理示例：./sample/card/card.go

集成gin框架

如果开发者当前应用使用的是 Gin Web 框架，并且不想要使用 Go-Sdk 提供的原生的 Http Server，则可使用下面方式，把当前应用的 Gin 服务与 SDK进行集成。

要想把 SDK 集成已有 Gin 框架，开发者需要引入集成包 oapi-sdk-gin

安装集成包

go get -u github.com/larksuite/oapi-sdk-gin

集成示例

import (
    "context"
    "fmt"
    
    "github.com/gin-gonic/gin"
    "github.com/larksuite/oapi-sdk-gin"
    "github.com/larksuite/oapi-sdk-go/v3/card"
    "github.com/larksuite/oapi-sdk-go/v3/core"
)


func main() {
      // 创建 card 处理器
      cardHandler := larkcard.NewCardActionHandler("v", "", func(ctx context.Context, cardAction *larkcard.CardAction) (interface{}, error) {
      fmt.Println(larkcore.Prettify(cardAction))
      fmt.Println(cardAction.RequestId())
    
      return nil, nil
      })
      ...
      // 在已有的 Gin 实例上注册卡片处理路由
      gin.POST("/webhook/card", sdkginext.NewCardActionHandlerFunc(cardHandler))
      ...
}

集成hertz框架

扩展示例

我们还基于 SDK 封装了常用的 API 组合调用及业务场景示例，如：

消息
- 发送文件消息
- 发送图片消息
通讯录
- 获取部门下所有用户列表
多维表格
- 创建多维表格同时添加数据表
电子表格
- 复制粘贴某个范围的单元格数据
- 下载指定范围单元格的所有素材列表
教程
- 机器人自动拉群报警 (开发教程)

更多示例可参考：https://github.com/larksuite/oapi-sdk-go-demo

加入答疑群

单击加入答疑群

License

使用 MIT

Documentation ¶

Index ¶

Variables
type Client
- func NewClient(appId, appSecret string, options ...ClientOptionFunc) *Client
type ClientOptionFunc

Constants ¶

This section is empty.

Variables ¶

View Source

var FeishuBaseUrl = "https://open.feishu.cn"

View Source

var LarkBaseUrl = "https://open.larksuite.com"

Functions ¶

This section is empty.

Types ¶

type Client ¶

type Client struct {
	Acs                    *larkacs.AcsService                                         // 智能门禁
	Admin                  *larkadmin.AdminService                                     // 管理后台-企业勋章
	Application            *larkapplication.ApplicationService                         // 应用信息
	Approval               *larkapproval.ApprovalService                               // 审批
	Attendance             *larkattendance.AttendanceService                           // 打卡
	Auth                   *larkauth.AuthService                                       //
	Authen                 *larkauthen.AuthenService                                   //
	Baike                  *larkbaike.BaikeService                                     // 企业百科
	Bitable                *larkbitable.BitableService                                 // 云文档-多维表格
	Block                  *larkblock.BlockService                                     // 小组件
	Calendar               *larkcalendar.CalendarService                               // 日历
	Contact                *larkcontact.ContactService                                 // 通讯录
	Corehr                 *larkcorehr.CorehrService                                   // CoreHR
	DocumentAi             *larkdocument_ai.DocumentAiService                          //
	Docx                   *larkdocx.DocxService                                       // 云文档-文档
	Drive                  *larkdrive.DriveService                                     // 云文档-文件管理
	Ehr                    *larkehr.EhrService                                         // 智能人事
	Event                  *larkevent.EventService                                     // 事件订阅
	GrayTestOpenSg         *larkgray_test_open_sg.GrayTestOpenSgService                //
	Helpdesk               *larkhelpdesk.HelpdeskService                               // 服务台
	Hire                   *larkhire.HireService                                       // 招聘
	HumanAuthentication    *larkhuman_authentication.HumanAuthenticationService        // 实名认证
	Im                     *larkim.ImService                                           // 消息与群组
	Lingo                  *larklingo.LingoService                                     //
	Mail                   *larkmail.MailService                                       // 邮箱
	Mdm                    *larkmdm.MdmService                                         // 主数据
	Okr                    *larkokr.OkrService                                         // OKR
	OpticalCharRecognition *larkoptical_char_recognition.OpticalCharRecognitionService // AI能力
	Passport               *larkpassport.PassportService                               // 帐号
	PersonalSettings       *larkpersonal_settings.PersonalSettingsService              // 个人设置
	Search                 *larksearch.SearchService                                   // 搜索
	SecurityAndCompliance  *larksecurity_and_compliance.SecurityAndComplianceService   //
	Sheets                 *larksheets.SheetsService                                   // 云文档-电子表格
	SpeechToText           *larkspeech_to_text.SpeechToTextService                     // AI能力
	Task                   *larktask.TaskService                                       // 任务
	Tenant                 *larktenant.TenantService                                   // 企业信息
	Translation            *larktranslation.TranslationService                         // AI能力
	Vc                     *larkvc.VcService                                           // 视频会议
	Wiki                   *larkwiki.WikiService                                       // 云文档-知识库
	Workplace              *larkworkplace.WorkplaceService                             //
	Ext                    *larkext.ExtService
	// contains filtered or unexported fields
}

func NewClient ¶

func NewClient(appId, appSecret string, options ...ClientOptionFunc) *Client

func (*Client) Delete ¶

func (cli *Client) Delete(ctx context.Context, httpPath string, body interface{}, accessTokeType larkcore.AccessTokenType, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) Do ¶

func (cli *Client) Do(ctx context.Context, apiReq *larkcore.ApiReq, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) Get ¶

func (cli *Client) Get(ctx context.Context, httpPath string, body interface{}, accessTokeType larkcore.AccessTokenType, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) GetAppAccessTokenByMarketplaceApp ¶

func (cli *Client) GetAppAccessTokenByMarketplaceApp(ctx context.Context, req *larkcore.MarketplaceAppAccessTokenReq) (*larkcore.AppAccessTokenResp, error)

func (*Client) GetAppAccessTokenBySelfBuiltApp ¶

func (cli *Client) GetAppAccessTokenBySelfBuiltApp(ctx context.Context, req *larkcore.SelfBuiltAppAccessTokenReq) (*larkcore.AppAccessTokenResp, error)

func (*Client) GetTenantAccessTokenByMarketplaceApp ¶

func (cli *Client) GetTenantAccessTokenByMarketplaceApp(ctx context.Context, req *larkcore.MarketplaceTenantAccessTokenReq) (*larkcore.TenantAccessTokenResp, error)

func (*Client) GetTenantAccessTokenBySelfBuiltApp ¶

func (cli *Client) GetTenantAccessTokenBySelfBuiltApp(ctx context.Context, req *larkcore.SelfBuiltTenantAccessTokenReq) (*larkcore.TenantAccessTokenResp, error)

func (*Client) Patch ¶

func (cli *Client) Patch(ctx context.Context, httpPath string, body interface{}, accessTokeType larkcore.AccessTokenType, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) Post ¶

func (cli *Client) Post(ctx context.Context, httpPath string, body interface{}, accessTokeType larkcore.AccessTokenType, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) Put ¶

func (cli *Client) Put(ctx context.Context, httpPath string, body interface{}, accessTokeType larkcore.AccessTokenType, options ...larkcore.RequestOptionFunc) (*larkcore.ApiResp, error)

func (*Client) ResendAppTicket ¶

func (cli *Client) ResendAppTicket(ctx context.Context, req *larkcore.ResendAppTicketReq) (*larkcore.ResendAppTicketResp, error)

type ClientOptionFunc ¶

type ClientOptionFunc func(config *larkcore.Config)

func WithAppType ¶

func WithAppType(appType larkcore.AppType) ClientOptionFunc

func WithEnableTokenCache ¶

func WithEnableTokenCache(enableTokenCache bool) ClientOptionFunc

func WithHeaders ¶

func WithHeaders(header http.Header) ClientOptionFunc

设置每次请求都会携带的 header

func WithHelpdeskCredential ¶

func WithHelpdeskCredential(helpdeskID, helpdeskToken string) ClientOptionFunc

func WithHttpClient ¶

func WithHttpClient(httpClient larkcore.HttpClient) ClientOptionFunc

func WithLogLevel ¶

func WithLogLevel(logLevel larkcore.LogLevel) ClientOptionFunc

func WithLogReqAtDebug ¶

func WithLogReqAtDebug(printReqRespLog bool) ClientOptionFunc

func WithLogger ¶

func WithLogger(logger larkcore.Logger) ClientOptionFunc

func WithMarketplaceApp ¶

func WithMarketplaceApp() ClientOptionFunc

func WithOpenBaseUrl ¶

func WithOpenBaseUrl(baseUrl string) ClientOptionFunc

func WithReqTimeout ¶

func WithReqTimeout(reqTimeout time.Duration) ClientOptionFunc

func WithSerialization ¶

func WithSerialization(serializable larkcore.Serializable) ClientOptionFunc

func WithTokenCache ¶

func WithTokenCache(cache larkcore.Cache) ClientOptionFunc

Source Files ¶

View all Source files

client.go

Directories ¶

Path	Synopsis
card
core
httpserverext
event
dispatcher Package dispatcher code generated by oapi sdk gen	Package dispatcher code generated by oapi sdk gen
service
acs/v1
admin/v1
application/v6
approval/v4
attendance/v1
auth/v3
authen/v1
baike/v1
bitable/v1
block/v2
calendar/v4
contact/v3
corehr/v1
document_ai/v1
docx/v1
drive/v1
ehr/v1
event/v1
ext
face_detection/v1
gray_test_open_sg/v1
helpdesk/v1
hire/v1
human_authentication/v1
im/v1
lingo/v1
mail/v1
mdm/v1
meeting_room/v1
okr/v1
optical_char_recognition/v1
passport/v1
personal_settings/v1
search/v2
security_and_compliance/v1
sheets/v3
speech_to_text/v1
task/v1
tenant/v2
translation/v1
vc/v1
wiki/v2
workplace/v1

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

README ¶

飞书开放接口SDK

目录

安装

API Client

创建API Client

配置API Client

API调用

基本用法

设置请求选项

原生API调用方式

处理消息事件回调

基本用法

消息处理器内给对应租户发消息

集成Gin框架

安装集成包

集成示例

集成hertz框架

处理卡片行为回调

基本用法

返回卡片消息

返回自定义消息

卡片行为处理器内给对应租户发消息

集成gin框架

安装集成包

集成示例

集成hertz框架

扩展示例

加入答疑群

License

Documentation ¶

Index ¶

Constants ¶

Variables ¶

Functions ¶

Types ¶

type Client ¶

func NewClient ¶

func (*Client) Delete ¶

func (*Client) Do ¶

func (*Client) Get ¶

func (*Client) GetAppAccessTokenByMarketplaceApp ¶

func (*Client) GetAppAccessTokenBySelfBuiltApp ¶

func (*Client) GetTenantAccessTokenByMarketplaceApp ¶

func (*Client) GetTenantAccessTokenBySelfBuiltApp ¶

func (*Client) Patch ¶

func (*Client) Post ¶

func (*Client) Put ¶

func (*Client) ResendAppTicket ¶

type ClientOptionFunc ¶

func WithAppType ¶

func WithEnableTokenCache ¶

func WithHeaders ¶

func WithHelpdeskCredential ¶

func WithHttpClient ¶

func WithLogLevel ¶

func WithLogReqAtDebug ¶

func WithLogger ¶

func WithMarketplaceApp ¶

func WithOpenBaseUrl ¶

func WithReqTimeout ¶

func WithSerialization ¶

func WithTokenCache ¶

Source Files ¶

Directories ¶