Package: lark-oapi-shortcut
飞书开放接口 SDK为帮助开发者更加便捷地使用飞书开放能力开发应用，简化在接入飞书开放平台时的操作步骤，开放平台提供了统一的服务端 SDK。开发者可使用 SDK，快捷地开发功能，提升开发效率。安装pipinstalllark-oapi-U支持 Python 3.7 及以上简单示例importlark_oapiaslark# 创建clientclient=lark.Client.builder().app_id("APP_ID").app_secret("APP_SECRET").build()# 构造请求对象request=lark.contact.v3.GetUserRequest.builder().user_id("7be5fg9a").build()# 发起请求response=client.contact.v3.user.get(request)更多示例可参考：请求示例API Client开发者在调用 API 前，需要先创建一个 API Client，然后才可以基于 API Client 发起 API 调用。创建 Client自建应用importlark_oapiaslarkclient=lark.Client.builder()\.app_id("APP_ID")\.app_secret("APP_SECRET")\.build()商店应用importlark_oapiaslarkclient=lark.Client.builder()\.app_id("APP_ID")\.app_secret("APP_SECRET")\.app_type(lark.AppType.ISV)\.build()Client 配置项创建 API Client 时，可以对 API Client 进行一定的配置，比如我们可以在创建 API Client 时设置日志级别、http 请求超时时间等。importlark_oapiaslarkclient=lark.Client.builder()\.app_id("APP_ID")\.app_secret("APP_SECRET")\.domain(lark.FEISHU_DOMAIN)\# 域名, 默认为 https://open.feishu.cn.timeout(3)\# 客户端超时时间, 单位秒, 默认永不超时.app_type(lark.AppType.ISV)\# 应用类型, 默认为自建应用; 若设为 ISV 需在 request_option 中配置 tenant_key.app_ticket("xxxx")\# 获取 app_access_token 凭证, app_type = ISV 时需配置.enable_set_token(False)\# 是否允许手动设置 token, 默认不开启; 开启后需在 request_option 中配置 token.cache(Cache())\# 自定义缓存, 默认使用预置的本地缓存.log_level(lark.LogLevel.DEBUG)\# 日志级别, 默认为 WARNING.build()API 调用创建完 API Client 后，我们可以使用client.业务域.版本.资源.方法名称来定位具体的 API 方法，然后对具体的 API 发起调用。飞书开放平台开放的所有 API
列表，可点击这里查看基本用法如下示例，我们通过 client 调用通过手机号或邮箱获取用户 ID接口。# Code generated by Lark OpenAPI.importlark_oapiaslarkfromlark_oapi.api.contact.v3import*client=lark.Client.builder()\.app_id("APP_ID")\.app_secret("APP_SECRET")\.log_level(lark.LogLevel.DEBUG)\.build()# 构造请求对象request:BatchGetIdUserRequest=BatchGetIdUserRequest.builder()\.user_id_type("open_id")\.request_body(BatchGetIdUserRequestBody.builder().emails(["xxxx@bytedance.com"]).mobiles(["15000000000"]).build())\.build()# 发起请求response:BatchGetIdUserResponse=client.contact.v3.user.batch_get_id(request)# 处理失败返回ifnotresponse.success():lark.logger.error(f"client.contact.v3.user.batch_get_id failed, code:{response.code}, msg:{response.msg}, log_id:{response.get_log_id()}")# 处理业务结果lark.logger.info(lark.JSON.marshal(response.data,indent=4))更多示例可参考：请求示例Request 配置项在每次发起 API 调用时，可以设置请求级别的一些参数，比如传递 userAccessToken, 自定义 headers 等。importlark_oapiaslarkfromlark_oapi.api.contact.v3import*# 创建clientimportlark_oapiaslarkfromlark_oapi.api.contact.v3import*# 创建clientclient=lark.Client.builder()\.enable_set_token(True)\.log_level(lark.LogLevel.DEBUG)\.build()# 构造请求对象request:BatchGetIdUserRequest=BatchGetIdUserRequest.builder()\.user_id_type("open_id")\.request_body(BatchGetIdUserRequestBody.builder().emails(["xxxx@bytedance.com"]).mobiles(["15000000000"]).build())\.build()# 设置请求选项headers={"key1":"value1","key2":"value2"}req_opt=lark.RequestOption.builder()\.tenant_access_token("t-g1047hjTXIZKCBFYWXUCK3D2LJWZYCWYL7USXXXX")\.headers(headers)\.build()# 发起请求response:BatchGetIdUserResponse=client.contact.v3.user.batch_get_id(request,req_opt)# 处理失败返回ifnotresponse.success():lark.logger.error(f"client.contact.v3.user.batch_get_id failed, code:{response.code}, msg:{response.msg}, log_id:{response.get_log_id()}")# 处理业务结果lark.logger.info(lark.JSON.marshal(response.data,indent=4))如上使用 RequestOptions 的 Builder 模式构建请求级别的参数。如下表格，展示了所有可设置的选项：配置选项描述tenant_key租户 key, 商店应用必须设置该选项。user_access_token用户 token，创建 Client 时 enable_set_token 需要设置为 True。tenant_access_token租户 token，创建 Client 时 enable_set_token 需要设置为 True。app_access_token应用 token，创建 Client 时 enable_set_token 需要设置为 True。headers自定义请求头，这些请求头会被透传到飞书开放平台服务端。原生方式调用部分老版本接口，由于没有元数据信息，所以无法生成对应的 SDK 模型，需要使用原生方式调用。如下示例，使用 client 原生方式同样调用通过手机号或邮箱获取用户 ID接口。importlark_oapiaslark# 创建clientclient=lark.Client.builder()\.app_id("APP_ID")\.app_secret("APP_SECRET")\.log_level(lark.LogLevel.DEBUG)\.build()# 构造请求对象request:lark.BaseRequest=lark.BaseRequest.builder()\.http_method(lark.HttpMethod.POST)\.uri("/open-apis/contact/v3/users/batch_get_id")\.token_types({lark.AccessTokenType.TENANT})\.queries([("user_id_type","open_id")])\.body({"emails":["xxxx@bytedance.com"],"mobiles":["15000000000"]})\.build()# 发起请求response:lark.BaseResponse=client.request(request)# 处理失败返回ifnotresponse.success():lark.logger.error(f"client.request failed, code:{response.code}, msg:{response.msg}, log_id:{response.get_log_id()}")# 处理业务结果lark.logger.info(str(response.raw.content,lark.UTF_8))更多示例可参考：原生调用处理消息事件回调了解消息订阅相关的知识，可以点击这里获取飞书开放平台开放的所有事件列表，可以点击这里基本用法开发者订阅消息事件后，可以使用下面代码，对飞书开放平台推送的消息事件进行处理。如下示例中使用 flask 启动 httpServer，如使用其他 web 框架，只需处理 http 出入参转换即可。fromflaskimportFlaskimportlark_oapiaslarkfromlark_oapi.adapter.flaskimport*fromlark_oapi.api.im.v1import*app=Flask(__name__)defdo_p2_im_message_receive_v1(data:P2ImMessageReceiveV1)->None:print(lark.JSON.marshal(data))defdo_customized_event(data:lark.CustomizedEvent)->None:print(lark.JSON.marshal(data))handler=lark.EventDispatcherHandler.builder(lark.ENCRYPT_KEY,lark.VERIFICATION_TOKEN,lark.LogLevel.DEBUG)\.register_p2_im_message_receive_v1(do_p2_im_message_receive_v1)\.register_p1_customized_event("message",do_customized_event)\.build()@app.route("/event",methods=["POST"])defevent():resp=handler.do(parse_req())returnparse_resp(resp)if__name__=="__main__":app.run(port=7777)其中 EventDispatcherHandler.builder(encrypt_key: str, verification_token: str) 方法参数用于签名验证和消息解密使用, 可在开发者后台->「事件订阅」中查看。需要注意的是注册处理器时，比如使用 register_p2_im_message_receive_v1 注册接受消息事件回调时，其中的 P2 为消息协议版本，当前飞书开放平台存在两种消息协议，分别为 1.0 和 2.0。如下图开发者在注册消息处理器时，需从事件列表中查看自己需要的是哪种协议的事件。如果是 1.0 的消息协议，则注册处理器时，需要找以 register_p1_xxxx 开头的。如果是 2.0 的消息协议，则注册处理器时，需要找以 register_p2_xxxx 开头的。若在 SDK 中未找到处理器，可使用 register_p1_customized_event 或 register_p2_customized_event 注册自定义事件。更多示例可参考：事件回调处理卡片行为回调关于卡片行为相关的知识，可点击这里查看基本用法开发者可以使用下面代码处理卡片回调，示例中使用 flask 启动 httpServer，如使用其他 web 框架，只需处理 http 出入参转换即可。fromtypingimportAnyfromflaskimportFlaskimportlark_oapiaslarkfromlark_oapi.adapter.flaskimport*app=Flask(__name__)defdo_interactive_card(data:lark.Card)->Any:print(lark.JSON.marshal(data))content={"header":{"title":{"tag":"plain_text","content":"更新卡片成功"},"template":"green"},"elements":[{"tag":"div","text":{"tag":"lark_md","content":"**Success!\n成功啦😄**"}},]}returncontenthandler=lark.CardActionHandler.builder(lark.ENCRYPT_KEY,lark.VERIFICATION_TOKEN,lark.LogLevel.DEBUG)\.register(do_interactive_card)\.build()@app.route("/card",methods=["POST"])defcard():resp=handler.do(parse_req())returnparse_resp(resp)if__name__=="__main__":app.run(port=7777)更多示例可参考：事件回调扩展示例我们还基于 SDK 封装了常用的 API 组合调用及业务场景示例，如：消息发送文件消息发送图片消息通讯录获取部门下所有用户列表多维表格创建多维表格同时添加数据表电子表格复制粘贴某个范围的单元格数据下载指定范围单元格的所有素材列表教程机器人自动拉群报警(开发教程)更多示例可参考：https://github.com/larksuite/oapi-sdk-python-demoLicenseMIT加入讨论群单击或扫码加入讨论群