ShortURL.bot 公開 API 是伺服器對伺服器的工作區介面，可管理連結、QR、頁面、洞察、用量、表單與轉換。它與網頁控制台共用權益及計數，不能繞過方案限制或取得獨立額度。
1. 建立並限制 API 金鑰
在設定 → API 金鑰中建立。所有方案皆可使用，金鑰屬於訂閱且可限制工作區。只將密鑰存於伺服器端密鑰管理器，不要放入瀏覽器、行動應用、原始碼或記錄。
正式基底 URL 是 https://api.shorturl.bot/v1。使用 Authorization: Bearer <api_key> 並先呼叫 GET /workspaces。
2. 在工作區建立連結
curl -X POST "https://api.shorturl.bot/v1/workspaces/WORKSPACE_ID/links" -H "Authorization: Bearer $SHORTURL_API_KEY" -H "Content-Type: application/json" -d '{"targetUrl":"https://example.com/launch","backHalf":"launch","tags":["email"]}'成功回傳 201。省略 domain 即使用預設網域；2s.gg 等退役網域只保留舊資源。
3. 依權益與錯誤設計
- 所有方案：金鑰、一般建立、標籤、UTM 與自訂後綴，受期間額度限制。
- Go 以上：狀態控制與最多 500 項批次建立。
- Plus 以上：目的地更新、排程、到期、到期後轉址與密碼。
- 系統限制：每 IP 每分鐘 800 個請求，另加方案額度。
401 為金鑰問題，403 為存取或功能拒絕，429 為額度或速率限制。只重試暫時性失敗。
下一步
請參閱開發者參考。