伶俐數據 API 快速開始

首次串接從確認 API 與費用開始。備妥自己的伺服器端環境，再依目前文件設定金鑰與請求參數。

串接前先核對這三項

1. 閱讀呼叫前費用與使用條件，確認本次驗證允許的範圍。
2. 依金鑰與驗證說明準備伺服器端設定。
3. 使用API 串接檢查清單記錄回應處理、失敗復原與驗收結果。

若要評估 Facebook 貼文搜尋，可結合該 API 的公開說明閱讀以下範例。其他 API 須採用各自文件，不能只替換請求位址後直接套用參數。

建立帳戶並選擇 API

前往登入與註冊入口，完成頁面要求的註冊與身分確認。在 API 市場選擇符合業務需求的 API，檢查請求方法、參數、回應說明、計費條件與呼叫限制。

記錄本次串接要驗證的內容，例如「是否能依指定主題取得文件約定的欄位」。不要將 API 名稱或行銷介紹視為完整規範。

在伺服器端準備金鑰

在使用者中心建立金鑰，將其儲存為伺服器端的 LINGLI_API_KEY 環境變數。真實值不得進入原始碼、公開設定、瀏覽器指令碼或截圖。

以下 Python 請求沿用官網公開範例。執行前須安裝 requests、設定自己的環境變數，並核對 API 目前狀態與費用。範例用於說明請求結構，執行會產生真實請求，請先核對費用。

import os
import requests

response = requests.get(
    "https://api.linglis.com/api/facebook/search/posts",
    headers={"X-API-Key": os.environ["LINGLI_API_KEY"]},
    params={"query": "technology"},
    timeout=30,
)
response.raise_for_status()
data = response.json()

檢查回應後再串接業務

HTTP 成功僅表示請求在 HTTP 層取得正常回應，仍須依文件檢查業務結果。確認欄位含義、空結果處理與資料使用範圍後，再撰寫後續業務邏輯。

需要取得更多結果時，先查明 API 是否提供分頁、如何續讀下一頁與何時停止。範例未展示分頁，不應自行假設存在 page、offset 或 cursor 參數。

請求失敗時

先核對請求位址、方法、必填參數與金鑰設定，再查看控制台中的可用狀態、費用條件與文件說明。失敗日誌應去識別化。自動重試須考慮計費與重複呼叫風險，不能直接重送所有失敗請求。

查看目前 API 詳情

如何判斷首次串接準備已完成

記錄所讀文件的日期、選用 API、金鑰存放位置、預期業務結果與失敗處理方式。若已進行獲准的真實呼叫，再保存去識別化實際結果；尚未呼叫時註明「尚未驗證」。本頁範例未提供回應樣本，不能據此假設成功標記、資料欄位或分頁標記。

下一步在控制台查看目前 API 詳情，依已確認條件完成自己的驗證。讀者執行範例會產生真實網路請求；本頁的文件檢查未替你執行收費呼叫。