2.創建應用

創建應用。在開發者后臺,根據實際需求,創建自建應用或者商店應用。

3.獲取訪問憑證

飛書開放平臺設置了多種訪問憑證(也稱為 access_token),不同的訪問憑證代表了不同的資源訪問權限。調用 API 時,必須在 HTTP Header 中攜帶訪問憑證,以便獲取權限范圍內的資源信息。

獲取自建應用的 tenant_access_token

  1. 登錄開發者后臺,選擇指定的自建應用。
  2. 在 基礎信息 > 憑證與基礎信息 頁面,獲取應用憑證 App ID 和 App Secret
  3. 調用自建應用獲取 tenant_access_token 接口,通過應用憑證 App ID 和 App Secret 獲取自建應用的tenant_access_token

獲取自建應用的 app_access_token

  1. 登錄開發者后臺,選擇指定的自建應用。
  2. 在 基礎信息 > 憑證與基礎信息 頁面,獲取應用憑證 App ID 和 App Secret
  3. 調用自建應用獲取 app_access_token 接口,通過應用憑證 App ID 和 App Secret 獲取自建應用的app_access_token

獲取商店應用的 app_access_token

  1. 獲取 app_ticket。
    1. 為商店應用配置事件訂閱請求地址。具體操作參見配置請求地址。完成配置后,飛書會每隔 1 小時向該地址自動推送最新的 app_ticket,應用根據接收到的 app_ticket 事件來獲取并保存app_ticket,以便后續使用。
    2. (可選)調用重新獲取 app_ticket 接口,觸發飛書重新推送 app_ticketapp_ticket 推送可能存在延遲,如果沒有收到推送,可以使用該方式重新推送 app_ticket
  2. 獲取應用憑證 App ID 和 App Secret。
    1. 登錄開發者后臺,選擇指定的自建應用。
    2. 在 基礎信息 > 憑證與基礎信息 頁面,獲取應用憑證 App ID 和 App Secret
  3. 調用商店應用獲取 app_access_token 接口,通過應用憑證 App ID 和 App Secret、以及 app_ticket 獲取商店應用的app_access_token

獲取商店應用的 tenant_access_token

請先獲取并保存商店應用的 app_access_token,再獲取商店應用的 tenant_access_token。

  1. 獲取 tenant_key。tenant_key為租戶在飛書上的唯一標識,用來換取對應的 tenant_access_token,也可以用作租戶在應用里面的唯一標識,可以通過如下方式獲取:
  2. 調用商店應用獲取 tenant_access_token 接口,通過app_access_tokentenant_key獲取商店應用的tenant_access_token

獲取 user_access_token

本章節以應用的網頁應用功能為例介紹如何獲取 user_access_token。

獲取 user_access_token 的方式同時適用于企業自建應用和商店應用。

  1. 登錄開發者后臺,選擇指定應用。
  2. 在 開發配置 > 安全設置 頁面,配置重定向 URL。你需要將實際發起 API 請求的服務端公網地址配置為應用的重定向 URL。重定向 URL 支持配置多個,只有在重定向 URL 列表中的 URL 在請求時才會通過開放平臺的安全校驗。
  3. 調用獲取授權登錄授權碼接口,獲取登錄預授權碼 code。調用接口時需要使用應用憑證 App ID,你可以在應用詳情頁的 基礎信息 > 憑證與基礎信息 頁面,獲取應用憑證 App ID
  4. 調用獲取 user_access_token接口,獲取user_access_token。同時可以獲取到 Token 的有效期(expires_in 響應字段)。
  5. (可選)調用刷新 user_access_token接口,刷新 user_access_tokenuser_access_token 的有效期為兩小時左右,過期后,需要刷新后再使用。

4. 調用示例

向企業內員工發消息

你可以調用發送消息接口完成向企業內員工發消息的操作,從接口文檔中可以確定,調用該接口前,需要獲取 tenant_access_token

1.參考 獲取訪問憑證 獲取 tenant_access_token。獲取憑證的請求示例如下,你需要將 app_id 和 app_secret 替換為實際值。

curl -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/'
-H 'Content-Type: application/json; charset=utf-8'
-d '{
"app_id": "<app_id>",
"app_secret": "<app_secret>"
}'

2.根據文檔內的請求參數描述,調用發送消息接口。

方式一:在調試臺發起 API 調用

方式二:本地發送 curl 請求該 API 需要使用 POST 方式發起。

示例如下,請將參數示例值替換為實際值。

curl -X POST 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=user_id'
-H 'Authorization:Bearer <tenant_access_token>'
-H 'content-type:application/json; charset=utf-8'
-d '{
"content": {
"text": "Hello World"
},
"msg_type": "text",
"receive_id": "<user_id>"
}'

5. 常見問題

問題1:如何找到飛書API

冪簡集成是國內領先的API集成管理平臺,專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’飛書API‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。

問題2在“開發者助手”上提交問題,一般要填寫哪些信息?

目前“開發者助手”上的工單主要分為兩大類型:

(1)一類是OriginOS 開放能力、AI大模型、藍河操作系統及其他開放內容的相關咨詢,開發者需填寫標題及詳細描述,如有需要可上傳圖片等相關附件對問題進行更具體的描述。

(2)另一類是vivo系統上穩定性、多媒體等的技術問題反饋,開發者需填寫標題、詳細描述、機型、應用名這些必要信息及其他如系統版本等相關信息。另外,為了vivo工程師可以更快速、準確地對問題進行分析,請提供問題相關的日志。

問題3如何提交問題相關的日志?

請按照以下步驟提交日志:

(1)打開電話,輸入*##112##* , 根據實際問題選擇具體的問題類型,一般情況下選擇“通用”類型。

(2)復現問題

(3)打開電話,輸入*##112##*,反饋,選擇所有時間段日志上傳。上傳完后提供日志提取碼給vivo。

問題4什么情況下需要日志打印授權?

日志打印授權用于解決以下兩種情況:

一是日志中部分敏感信息以星號(**)顯示。–對應權限:日志脫敏

二是日志打印太頻繁中間缺少部分日志。–對應權限:行數限制

對于開發flutter應用時出現無法調試的問題,可通過日志打印授權進行解決

問題5:飛書API 的替代品有哪些?

提供AI大模型服務商除飛書API,還有其他替代服務商也提供類似api服務,例如:

Perplexity AI大模型

Copilot AI大模型

Flowise AI 大模型

更多競品可以在冪簡API平臺找到。

問題6:飛書API這個密鑰還適用于哪些api?

獲取登錄用戶信息自建應用獲取 tenant_access_token自建應用獲取 app_access_token

6.  總結

本文詳細闡述了獲取飛書API開放平臺訪問Token的全過程,為開發者提供了一個全面、實用的分步指南。從注冊飛書開發者賬號開始,通過完成應用創建和認證流程,到最終獲取訪問Token,每一步操作都進行了詳盡的說明,旨在幫助開發者輕松完成Token的獲取。雖然本文未直接提及,但獲取Token后進行可用性測試的重要性不言而喻,這有助于確保開發者能夠順利地將飛書API集成到應用中,并提升應用的交互性和功能性。這一環節對于確保API的穩定性和準確性至關重要。本文為開發者提供了一個詳盡而系統的指南,旨在幫助他們順利獲取飛書API開放平臺的訪問Token,并將其有效地集成到應用中,從而為企業和團隊提供更加高效、便捷的協同辦公體驗。

上一篇:

如何使用API批量發送電子郵件?

下一篇:

如何獲取百度網訊科技API開放平臺訪問token分步指南
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費