無料URL短縮API: 実際に動くコード例

無料URL短縮APIを使えば、ダッシュボードをクリックして回るのではなく、コードから短縮リンクを作成できます。遷移先URLを添えたリクエストを送ると、そこへリダイレクトする短縮リンクが返ってきます。この記事には、無料プランで利用できるElidoのAPIに対する、curl、JavaScript、Python、Goでの実行可能なコード例に加え、大半のリストにありがちな部分では省かれがちな正直な話、つまり「無料」が実際に何を制限するのかも扱います。

リンクを一度も短縮したことがない場合は、まずURLの短縮方法で手動での方法を確認してください。以下はすべて、プログラムから行いたい前提です。

短縮APIが行うこと

その中核において、APIはリンクリソースに対する4つの操作、すなわち作成、読み取り、更新、削除です。遷移先URLをPOSTすることでリンクを作成し、サービスは別の場所で解決される短縮URLを返します。

つまずきやすい点が一つあります。APIのホストとリダイレクトのホストは異なります。ElidoのAPIはhttps://api.elido.app/v1にありますが、短縮リンク自体はs.elido.meのようなリダイレクトドメインで解決されます。リンクを管理するにはAPIとやり取りしますが、ユーザーが実際にアクセスするのは常にリダイレクトドメインだけです。この2つを分けておくことで、APIがより重い処理を行う一方、リダイレクトの経路は高速なままに保たれます。

まず認証する

実際のリクエストにはすべて、Authorizationヘッダーにベアラートークンが付きます。トークンはワークスペースの設定で生成し、環境変数として保存し、クライアント側のコードには決して入れないでください。トークンを持つ者は誰でもあなたのアカウントでリンクを作成できてしまうからです。

export ELIDO_TOKEN="your_token_here"

認証モデルはこれがすべてです。すべての呼び出しにAuthorization: Bearer $ELIDO_TOKENという1つのヘッダーを付けます。これを完全に省いているAPIは使い捨てのスクリプトには手軽ですが、リンクの背後にアカウントがないため、後から一覧表示、編集、計測ができません。

短縮リンクを作成する

同じ作成呼び出しを4つの言語で見てみましょう。それぞれ遷移先URLをPOSTし、レスポンスから短縮URLを出力します。

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/spring-sale"}'

レスポンスはJSONです。

{
  "id": "lnk_9aF2xK",
  "short_url": "https://s.elido.me/abc123",
  "destination_url": "https://example.com/spring-sale"
}

JavaScript、組み込みのfetchを使用。

const res = await fetch("https://api.elido.app/v1/links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ELIDO_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ destination_url: "https://example.com/spring-sale" }),
});
const link = await res.json();
console.log(link.short_url); // https://s.elido.me/abc123

Python、requestsを使用。

import os
import requests

res = requests.post(
    "https://api.elido.app/v1/links",
    headers={"Authorization": f"Bearer {os.environ['ELIDO_TOKEN']}"},
    json={"destination_url": "https://example.com/spring-sale"},
)
print(res.json()["short_url"])  # https://s.elido.me/abc123

Go、標準ライブラリを使用。

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]string{
		"destination_url": "https://example.com/spring-sale",
	})
	req, _ := http.NewRequest("POST", "https://api.elido.app/v1/links", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("ELIDO_TOKEN"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var link struct {
		ShortURL string `json:"short_url"`
	}
	json.NewDecoder(res.Body).Decode(&link)
	fmt.Println(link.ShortURL) // https://s.elido.me/abc123
}

必要に応じて、本文にオプションのフィールドを追加できます。カスタムの後半部分用のslug、整理用のtags、ブランドカスタムドメインを選ぶためのdomain、特定の日付以降無効になるリンク用のexpires_atなどです。

「無料」が実際に制限するもの

ここが正直な比較のしどころです。「無料API」という言葉は、実は大きく異なる2つのものを指しているからです。

サインアップ不要、認証不要のエンドポイント、つまり1回の認証なしのPOSTでURLを短縮するものは、本当に無料であり、本当に制限されています。共有のレート制限、アカウントなし、ブランドドメインなし、分析なし、そしてそのサービスが来四半期も存在している保証もありません。使い捨てのスクリプトには十分ですが、実際に公開するものにはリスクがあります。

より有用なのは認証付きの無料枠であり、そこでの制限は予測可能です。有料プランに最もよく取っておかれる機能は、ブランドカスタムドメイン、高いリクエスト量、より長い分析データ保持期間、一括処理用のエンドポイントです。Elidoの無料プランでは、API自体が含まれており、リンクは解決されトラッキングもされ、制限は見知らぬ他人と共有ではなくワークスペース単位です。有料ツールがこの点でどう比較されるかについては、Dub対Bitlyが最もよく知られた2つのAPIを扱っており、無料プランから始めてElidoのAPIを試すこともできます。

経験則としては、そのリンクが使い捨てなら認証なしのAPIで十分です。あなたのブランドを背負う、あるいは計測が必要なら、自分が管理するドメインを持つ認証付きのAPIを使ってください。

レート制限と冪等性

本番運用であなたを実際に守ってくれる数値は、レート制限ではなく冪等性です。

すべての変更を伴うリクエストはIdempotency-Keyヘッダーを受け付けます。作成呼び出しに一意のキーを付けて送信し、もしリクエストがタイムアウトして同じキーで再試行した場合、サーバーは2つ目のリンクを作成する代わりに元の結果を返します。これが再試行ループを安全にする仕組みです。

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Idempotency-Key: spring-sale-2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/spring-sale"}'

冪等性はRFC 9110におけるHTTPメソッドのセマンティクスの特性の一つであり、自動でのリンク作成に使うAPIであれば対応しているべきものです。どのステータスコードで再試行すべきか、レート制限に対してどうペースを合わせるかについての詳しい解説は、本番環境でのレート制限、再試行、冪等性にあります。

SDKか、素のHTTPか

リクエストを自前で組み立てる必要はありません。ElidoはOpenAPI仕様から生成されたTypeScript、Python、Goなどのためのライブラリを提供しており、API・SDKクイックスタートでインストール方法と呼び出し方を解説しています。

型付け、再試行、ページネーションを代わりに処理してほしい場合はSDKを使ってください。依存関係をゼロにしたい場合や、公式クライアントがない言語から呼び出す場合は、上記の例のような素のHTTPを使ってください。どちらも同じREST APIにアクセスしており、SDKはそこへの薄い経路に過ぎません。

ブログの関連記事

• URL短縮API・SDKクイックスタート
• 本番環境でのレート制限、再試行、冪等性
• URLの短縮方法: 無料、ブランド化、一括リンク
• Dub対Bitly: 価格、無料プラン、機能