Developers

API

4l.vc の API を使うと、プログラムから短縮 URL を作ったり、自分のリンクの一覧やクリック数を取ったり、削除したりできます。

はじめに

ログインして、ダッシュボードの「API キー」で鍵を発行します。鍵（4lvc_ で始まる文字列）は、すべてのリクエストの Authorization ヘッダに入れます。

エンドポイント

URL の頭はすべて https://4l.vc/api/v1 です。

例

# リンクを作る
curl -X POST https://4l.vc/api/v1/links \
  -H "Authorization: Bearer $FOURL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/very/long/path"}'

# 応答
{"data": {"slug": "Qx7mP", "short": "https://4l.vc/Qx7mP", "url": "https://example.com/very/long/path",
          "status": "active", "clicks": 0, "createdAt": "2026-10-09T12:00:00.000Z", "lastClickAt": null}}

# クリック数
curl https://4l.vc/api/v1/links/Qx7mP -H "Authorization: Bearer $FOURL_KEY"

応答とエラー

うまくいくと {"data": …}、だめなときは HTTP の状態が 400 番台か 500 番台で {"error": {"code", "message"}} が返ります。Accept-Language: en を付けると、エラーの文が英語になります。

制限

回数の制限はありません。触れるのは、そのキーのアカウントのリンクだけです。