公開 API はワークスペース資産用のサーバー間インターフェースです。ダッシュボードと同じ権限・使用量を使い、プラン制限を回避したり別枠を得たりはできません。
1. キーの作成と範囲
設定 → API キーで作成します。全プランで利用でき、サブスクリプションとワークスペース範囲に紐付きます。秘密値はサーバー側に保存してください。
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 制限です。一時エラーだけ再試行します。
次へ
開発者リファレンスを参照してください。