トップページに戻る

APIリファレンス

プログラムからURL4Uの機能を直接利用するためのガイドです。

概要

URL4UのAPIを使用して、プログラムからURLを短縮することができます。 全てのAPIエンドポイントはHTTPSで提供され、JSON形式でデータをやり取りします。

認証

現在、APIの使用には認証やAPIキーは必要ありません。
厳密なレート制限は設けていませんが、以下の制限を目安にご利用ください：

  • 1日あたり 1,000 リクエストまで
  • 1分あたり 10 リクエストまで
URL短縮エンドポイント

エンドポイント

POST https://4url.jp/api/shorten

リクエスト

Content-Type: application/json

{
  "originalUrl": "https://example.com",
  "password": "optional_password"
}

レスポンス

Status: 201 Created

{
  "shortUrl": "abc123",
  "fullUrl": "https://4url.jp/i/abc123",
  "consoleLink": "/console/abc123",
  "fullconsoleLink": "https://4url.jp/console/abc123"
}

エラーレスポンス

Status: 400 Bad Request

{
  "message": "無効なURL形式です"
}
使用例

JavaScript (Fetch API)

const response = await fetch('https://4url.jp/api/shorten', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    originalUrl: 'https://example.com',
    password: 'optional_password'
  })
});

const data = await response.json();
console.log(data.shortUrl);

Python (Requests) - パスワードなし

import requests

response = requests.post(
    'https://4url.jp/api/shorten',
    json={
        'originalUrl': 'https://example.com'
    }
)

data = response.json()
print(data['shortUrl'])
制限事項
  • 短縮URLはパスワードなしの場合、生成から180日で自動的に期限切れとなります。
  • パスワードを設定した場合、デフォルトで1年間有効になります。
  • 悪意のあるコンテンツやプライバシー侵害に関わるリンクの作成は固く禁じています。
  • 大規模な利用（大量のURLを一括で短縮するなど）をご検討の場合は事前にご相談ください。
トップページに戻る