短縮リンク API - ドキュメント

短縮リンクの作成・照会のための JSON API です。アカウント用に発行された API キー(または該当する場合はプラットフォームの API_TOKEN)を使用してください。

公開 API: https://anyurl.bond - JSON は /api/v1/。

Authorization

Authorization: Bearer 1234

Authorization: Bearer に正確な API キーを付与してください。ダッシュボードログインでは同じキーとメールを使います。

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}
{"long_url":"https://example.com","permanent":true}

expiration_time および max_uses は有料プラン向けの任意項目です。未払い階層では暦月(UTC、1 日リセット)ごとに上限があり、リクエスト本文に関わらず各リンクは約 10 分で失効します。

GET /api/v1/info/{short_code}

短縮コードのメタデータと有効性を返し、クリック数は増やしません。

GET /api/v1/me

プラン種別、管理画面の実効上限、当月(UTC)の利用状況(新規リンクと API 編集)を返します。

GET /api/v1/links

?limit=50&offset=0

お使いの API キーで作成した短縮リンクだけを列挙します(owner_id がそのキーと一致;GET /info と同じ範囲)。プラットフォーム API トークンはこのエンドポイントを使えません。クエリ: limit(既定 50、最大 100)、offset(既定 0、最大 100000)。JSON: links(各要素は GET /info と同じフィールド)、total、limit、offset。一覧は行を削除せずクリックも増やしません。

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

既存の短縮コードを変えるには /api/v1/info/{short_code} に PUT または PATCH を使います(POST /shorten ではありません)。JSON 本文: long_url、expiration_time、max_uses、allow_bots のいずれか。省略したフィールドは変更しません。expiration_time を "" で時刻期限を解除;max_uses -1 で回数無制限。応答の形は GET /info と同じです。

コマンドライン例(curl)

トークン 1234 は例です - 実際の API キーを使ってください。ホスト: https://anyurl.bond。

POST /api/v1/shorten - 完全な JSON(ホスト https://anyurl.bond)
curl
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"
POST /api/v1/shorten - 最小ボディ(有料:既定で 24 時間で失効)
curl
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"
POST /api/v1/shorten - 恒久的(有料;スマート編集を 1 回消費)
curl
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"
GET /api/v1/info/{short_code} - 短コード例 abc123
curl
curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'
GET /api/v1/me
curl
curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'
GET /api/v1/links - 短縮リンクのページ送り一覧
curl
curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'
PATCH /api/v1/info/{short_code}
curl
curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"
PUT /api/v1/info/{short_code}
curl
curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"
Verbose (-v) デバッグ用
curl
curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

無料 API:暦月(UTC)あたり新規短縮は最大 100 件で、枠は毎月 1 日にリセットされます。各リンクは約 10 分で失効します。有料プランも同じ月次サイクルです。

ホームに戻る · 利用規約