開發者 API

用 REST API 程式化建立／管理短連結（server-to-server）。到 儀表板 → 開發者 API 產生金鑰。每月免費 1,000 次呼叫。

驗證

每個請求帶 Authorization: Bearer lk_live_…。回應標頭含 X-RateLimit-Remaining；額度用完回 429。

建立短連結

POST /api/v1/links

curl -X POST https://link.luvai.net/api/v1/links \
  -H "Authorization: Bearer lk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://example.com.tw/sale",
    "slug": "summer",
    "title": "Summer sale",
    "escape_inapp": true,
    "utm": { "source": "ig", "medium": "bio" }
  }'

# 201 -> { "ok": true, "id": 42, "slug": "summer",
#          "short_url": "https://link.luvai.net/summer" }

欄位：target_url（必填）、slug（可留白＝隨機）、title、mode（simple｜ab｜device）、variants、redirect_type（301｜302）、og{title,description,image}、pixel_fb／ga／gtm／tiktok／line、escape_inapp、expires_at（ISO 時間）、utm、password。目的地會自動過釣魚／惡意網址掃描。

列出 / 查詢 / 刪除

curl https://link.luvai.net/api/v1/links?limit=50 \
  -H "Authorization: Bearer lk_live_YOUR_KEY"

curl https://link.luvai.net/api/v1/links/42 \
  -H "Authorization: Bearer lk_live_YOUR_KEY"

curl -X DELETE https://link.luvai.net/api/v1/links/42 \
  -H "Authorization: Bearer lk_live_YOUR_KEY"

錯誤碼

401 金鑰缺失／無效／已撤銷 · 403 超過連結上限 · 404 找不到（或非你的連結）· 409 短碼重複／保留字 · 429 本月額度用完 · 400 參數錯誤（含目的地未過安全掃描）。

← 回 儀表板

開發者 API｜連 link.luvai.net