縮網址 API 與會員追蹤說明。

建立短網址

POST /api/links
Content-Type: application/json

{"url":"https://example.com"}

成功回傳 code 與 shortURL。僅接受 http／https，原始網址最多 768 字元。同源請求必須帶 Origin 標頭。

管理你的連結

GET /api/links 取得目前使用者的連結與累積點擊次數。

PATCH /api/links
Content-Type: application/json

{"code":"連結代碼","active":false}

將 active 設為 false 可停用連結，設為 true 則重新啟用。僅能修改自己的連結。

轉址與回應

GET /s/代碼 以 HTTP 302 轉址並累加點擊次數。無效或停用的連結回傳 404。

會員曝光與點擊分析

GET /api/links/代碼/analytics?start=2026-10-01&end=2026-10-07&offset=0 回傳指定日期的每日統計與事件明細，只能查詢自己的連結。日期採台北時間，最多 90 天；事件每頁 50 筆。

POST /api/links/代碼/tracking 為舊連結啟用曝光追蹤，需要登入並帶同源 Origin。

會員後台提供專屬 HTML 追蹤碼。曝光以追蹤圖片載入計次，追蹤版點擊以專屬參數轉址計次；CTR = 追蹤版點擊 ÷ 量測曝光。一般短網址點擊另外統計，沒有曝光資料時 CTR 為空值。

僅保存連結代碼、事件類型與伺服器 UTC 時間，介面顯示台北時間。不保存訪客 IP、姓名或裝置識別。數據為請求次數，可能受自動預覽、圖片阻擋與快取影響，並非不重複訪客或社群平台曝光。

會員資料夾分類

GET /api/folders 取得自己的資料夾。POST /api/folders 以 JSON name 建立資料夾；名稱 1 至 40 個字元，同帳號名稱不可重複。

PATCH /api/folders 傳入 id 與 name 重新命名。DELETE /api/folders 傳入 id 刪除資料夾，連結會回到未分類，成效紀錄保留。

PATCH /api/links
Content-Type: application/json

{"code":"連結代碼","folderId":"資料夾代碼"}

folderId 設為 null 即移回未分類。移動分類不會改變連結的啟用狀態。所有寫入需要登入與同源 Origin；只能存取自己的資料夾與短連結。