公開API

私たちの公開APIを使用すると、プログラムでURLを短縮できます。APIキーや認証は不要です。

📥 POST /api/links

URLを短縮するために、単一のオブジェクトまたはオブジェクトの配列を送信します。

{
  "domain": "clc.is",
  "target_url": "https://example.com",
  "slug": "custom", // 任意
  "expired_url": "https://expired.example.com", // 任意
  "expired_hours": 48 // 任意 (0 = 有効期限なし)
}

🔁 応答:

{
  "input": { ... },
  "slug": "custom",
  "url": "https://clc.is/custom",
  "is_generated": false
}

🌐 GET /api/domains

リンク短縮のために利用可能なドメインの配列を返します。

["clc.is", "alt1.com", "alt2.com"]

⚠️ エラーハンドリング

409 Conflict — スラッグが既に使用されている場合
400 Bad Request — パラメーターが不足しているか無効な場合

📦 バルク処理

一度に最大5000件のURLを送信するには、バルクページを使用するか、エントリの配列を/api/linksに送信します。