Zaglロゴ

APIドキュメント

コードから直接リンクを短縮。エンドポイント1つ、ベアラートークン1つ。

エンドポイント

POSThttps://za.gl/api/shorten
RESTJSONボディベアラー認証

認証

APIトークンは Authorization ヘッダーにベアラートークンとして渡します。最初のリンクを作成すると、アカウントのダッシュボードから取得できます。

ヘッダー
Authorization: Bearer YOUR_API_TOKEN

トークンがまだなくても、そのままエンドポイントを呼び出せます。Za.glが匿名アカウントを自動で作成し、新しいトークンを data.newAuthToken. に返します。後でリンクを管理できるよう保存しておいてください。

リクエストボディ

originalUrl必須

string

短縮したい長いURL。プロトコルを省略すると https:// が自動で付きます。

customAlias

string

自分で決める末尾。例: za.gl/my-link。重複していると 409 が返ります。

password

string

リンクを保護し、訪問者にパスワードの入力を求めます。

expiresAt

string (ISO date)

リンクが使えなくなる日時。未来の日時を指定してください。

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt の代わりに、現在からの経過時間で失効させます。

waitTimer

number (0-300)

リダイレクト前に訪問者がプレビューページで待つ秒数。

customGtmId

string

プレビューページで発火する、自分の Google Tag Manager ID (GTM-XXXXXXX)。

title / description

string

リンクと一緒に保存する任意のメタデータ。

generateQR

boolean

短縮URLのQRコードも返します。

リクエスト例

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

レスポンス例

成功すると 200 OK が返ります。短縮URLが入るのは次の項目です: data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

レート制限とエラー

10 req/min1クライアントあたり毎分10リクエストまで。
409そのカスタムエイリアスはすでに使われています。
400URLが不正、または有効期限が過去の日時です。
429レート制限、または月間の上限に達しました。