lark

README

飞书开放接口SDK/Feishu OpenPlatform Server SDK

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

Feishu Open Platform offers a series of server-side atomic APIs to achieve diverse functionalities. However, actual coding requires additional work, such as obtaining and maintaining access tokens, encrypting and decrypting data, and verifying request signatures. Furthermore, the lack of semantic descriptions for function calls and type system support can increase coding burdens.

To address these issues, Feishu Open Platform has developed the Open Interface SDK, which incorporates all lengthy logic processes, provides a comprehensive type system, and offers a semantic programming interface to enhance the coding experience.

介绍文档 Introduction Documents

• 开发前准备（安装） / Preparations before development(Install SDK)
• 调用服务端 API / Calling Server-side APIs
• 处理事件订阅 / Handle Events
• 处理卡片回调 / Handle Card Callbacks
• 常见问题 / SDK FAQs

扩展示例

我们还基于 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
  • func (cli *Client) Delete(ctx context.Context, httpPath string, body interface{}, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) Do(ctx context.Context, apiReq *larkcore.ApiReq, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) Get(ctx context.Context, httpPath string, body interface{}, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) GetAppAccessTokenByMarketplaceApp(ctx context.Context, req *larkcore.MarketplaceAppAccessTokenReq) (*larkcore.AppAccessTokenResp, error)
  • func (cli *Client) GetAppAccessTokenBySelfBuiltApp(ctx context.Context, req *larkcore.SelfBuiltAppAccessTokenReq) (*larkcore.AppAccessTokenResp, error)
  • func (cli *Client) GetTenantAccessTokenByMarketplaceApp(ctx context.Context, req *larkcore.MarketplaceTenantAccessTokenReq) (*larkcore.TenantAccessTokenResp, error)
  • func (cli *Client) GetTenantAccessTokenBySelfBuiltApp(ctx context.Context, req *larkcore.SelfBuiltTenantAccessTokenReq) (*larkcore.TenantAccessTokenResp, error)
  • func (cli *Client) Patch(ctx context.Context, httpPath string, body interface{}, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) Post(ctx context.Context, httpPath string, body interface{}, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) Put(ctx context.Context, httpPath string, body interface{}, ...) (*larkcore.ApiResp, error)
  • func (cli *Client) ResendAppTicket(ctx context.Context, req *larkcore.ResendAppTicketReq) (*larkcore.ResendAppTicketResp, error)
• type ClientOptionFunc
  • func WithAppType(appType larkcore.AppType) ClientOptionFunc
  • func WithEnableTokenCache(enableTokenCache bool) ClientOptionFunc
  • func WithHeaders(header http.Header) ClientOptionFunc
  • func WithHelpdeskCredential(helpdeskID, helpdeskToken string) ClientOptionFunc
  • func WithHttpClient(httpClient larkcore.HttpClient) ClientOptionFunc
  • func WithLogLevel(logLevel larkcore.LogLevel) ClientOptionFunc
  • func WithLogReqAtDebug(printReqRespLog bool) ClientOptionFunc
  • func WithLogger(logger larkcore.Logger) ClientOptionFunc
  • func WithMarketplaceApp() ClientOptionFunc
  • func WithOpenBaseUrl(baseUrl string) ClientOptionFunc
  • func WithReqTimeout(reqTimeout time.Duration) ClientOptionFunc
  • func WithSerialization(serializable larkcore.Serializable) ClientOptionFunc
  • func WithTokenCache(cache larkcore.Cache) ClientOptionFunc

Variables

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

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

Types

type Client

type Client struct {
	Hire                   *hire.Service
	Report                 *report.Service
	Mdm                    *mdm.Service
	Acs                    *acs.Service
	Attendance             *attendance.Service
	Auth                   *auth.Service
	Block                  *block.Service
	DocumentAi             *document_ai.Service
	Event                  *event.Service
	Mail                   *mail.Service
	Tenant                 *tenant.Service
	Application            *application.Service
	Authen                 *authen.Service
	Baike                  *baike.Service
	Docx                   *docx.Service
	OpticalCharRecognition *optical_char_recognition.Service
	Sheets                 *sheets.Service
	Admin                  *admin.Service
	Compensation           *compensation.Service
	Contact                *contact.Service
	Corehr                 *corehr.Service
	MeetingRoom            *meeting_room.Service
	Moments                *moments.Service
	SecurityAndCompliance  *security_and_compliance.Service
	Calendar               *calendar.Service
	GrayTestOpenSg         *gray_test_open_sg.Service
	Im                     *im.Service
	Passport               *passport.Service
	SpeechToText           *speech_to_text.Service
	Workplace              *workplace.Service
	Bitable                *bitable.Service
	Drive                  *drive.Service
	Lingo                  *lingo.Service
	Translation            *translation.Service
	Task                   *task.Service
	Aily                   *aily.Service
	Board                  *board.Service
	Docs                   *docs.Service
	Ehr                    *ehr.Service
	Helpdesk               *helpdesk.Service
	PersonalSettings       *personal_settings.Service
	Search                 *search.Service
	Vc                     *vc.Service
	Approval               *approval.Service
	HumanAuthentication    *human_authentication.Service
	Okr                    *okr.Service
	Verification           *verification.Service
	Wiki                   *wiki.Service
	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