lihi API 功能是什麼？如何取得 API 金鑰？

這篇文章會教你 lihi API 功能可以做什麼，以及如何取得 API 金鑰。lihi API 適合 Business 商業方案與 Enterprise 企業方案用戶，用於系統串接、自動建立短網址、查詢短網址資料、修改目的網址或批次維護連結。

如果只是需要一次建立多筆短網址，也可以先參考 Excel 批次匯入功能，不一定需要使用 API 串接。

lihi API 可讓工程團隊透過系統串接，自動建立、查詢、修改或刪除短網址。適合用於大量短網址產生、後台系統整合、活動連結管理與批次維護等情境。

 

串接完成後，當您發布文章或頁面的長網址時可以同時自動生成自家網域的短網址，
同時可依需求指定slug(自訂網址)/tag(標籤)。
串接API KEY請至API功能複製金鑰，萬一串接金鑰被盜用或失效可點擊
提醒：API 金鑰具有帳號操作權限，請勿公開貼在文章、截圖、前端網頁或公開 GitHub 儲存庫中。若懷疑金鑰外洩，請立即重新產生 API 金鑰，並同步更新串接系統中的設定。

注意：一旦重新產生 API 金鑰，舊的金鑰將會立即失效，原本串接中的系統也需要同步更新新金鑰。

當串接完成的短網址會顯示在API功能的網址列表，介面與首頁相同

lihi API 可做哪些操作？

lihi API 可協助 Business 商業方案與 Enterprise 企業方案用戶進行短網址串接，常見用途包含：

• 自動建立短網址

• 查詢既有短網址資料

• 修改既有短網址的目的網址

• 刪除短網址

• 搭配自訂 slug 或標籤進行管理

API 適合需要大量建立短網址、批次維護連結、或將短網址功能整合到自家系統的團隊使用。

---

如何查詢既有短網址資料？

若要查詢一筆既有短網址的資料，可以使用：

GET /api/v1/url?type=short&url=https://domain/slug

其中：

• type=short：代表要查詢的是短網址

• url=https://domain/slug：代表要查詢的完整短網址

查詢成功後，回傳內容會包含短網址、目的網址與點擊數等資料，例如：

• shortUrl：短網址

• click：總點擊數

• repeatClick：重複點擊數

• longUrls[].url：目前導向的目的網址

• longUrls[].click：該目的網址的點擊數

注意：不能只呼叫 /api/v1/url。若未帶入 type 或 url，系統會回傳 400 validation error。

---

如何修改既有短網址的目的網址？

若要修改一筆既有短網址的目的網址，可以使用：

PUT /api/v1/url
Content-Type: application/json
Authorization: x-api-key:您的_API_KEY

Body 範例如下：

{
  "shortUrl": "https://domain/slug",
  "longUrl": "https://new-destination.example/"
}

其中：

• shortUrl：要修改的既有短網址

• longUrl：新的目的網址，也就是更新後要導向的網址

若更新成功，會回傳：

{
  "result": "success"
}

若回傳 400 或 422，通常代表缺少必要欄位、網址格式不正確，或該短網址不屬於此 API key 對應的帳號或群組。

---

批次修改大量短網址時的建議

若需要批次修改大量既有短網址的目的網址，建議先整理好 shortUrl → 新目的網址 的對照表，再由工程端透過 PUT /api/v1/url API 批次更新。

為避免誤改大量短網址，建議正式處理前先以 5–10 筆測試資料進行驗證，確認更新結果與導向行為都正確後，再正式處理全部資料。