go.fanet.work

使い方ガイド

基本的な使い方

トップページのフォームにURLを入力して「短縮する」を押すだけ。

カスタムスラッグ空欄ならランダム6文字を自動生成。英数字・ハイフン・アンダースコアが使えます（最大32文字）
パスワード設定するとアクセス時にパスワード入力が必要になります
有効期限期限を過ぎると自動的にリンクが無効化されます
最大クリック数指定回数に達するとリンクが自動停止します
メモ管理用のメモ。リンクの用途などを記録できます

リンクプレビュー

短縮URLの末尾に + を付けると、リダイレクトせずにリンク情報を確認できます。

https://go.fanet.work/my-link+ → 遷移先URL・クリック数・作成日を表示

API リファレンス

POST /api/shorten

短縮URLを作成します

curl -X POST https://go.fanet.work/api/shorten \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/long-url",
    "slug": "my-link",
    "password": "secret123",
    "expires_at": "2026-12-31T23:59:59Z",
    "max_clicks": 100,
    "note": "キャンペーン用"
  }'
パラメータ必須説明
url*短縮したいURL（http/https/ftp）
slugカスタムスラッグ。省略でランダム生成
passwordパスワード保護
expires_at有効期限（ISO 8601形式）
max_clicks最大クリック数（1以上の整数）
note管理用メモ

GET /api/stats/<slug>

リンクの統計情報を取得します（クリック履歴・日別集計・リファラ）

curl https://go.fanet.work/api/stats/my-link

管理者API（トークン必須）

メソッドエンドポイント説明
GET/api/urls全URL一覧（?page=1&limit=50&q=検索）
DELETE/api/urls/<slug>URL削除
POST/api/urls/<slug>/toggle有効/無効の切替
POST/api/bulk一括作成（最大50件）
 
# 管理者APIの使用例
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://go.fanet.work/api/urls?q=example

# 一括作成
curl -X POST https://go.fanet.work/api/bulk \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls": [
    {"url": "https://a.com", "slug": "a"},
    {"url": "https://b.com", "slug": "b"}
  ]}'

レート制限

URL作成は 60秒あたり30リクエスト に制限されています。リダイレクト（短縮URLへのアクセス）には制限はありません。

レスポンスコード

コード意味
302リダイレクト成功
201URL作成成功
400不正なリクエスト
403権限なし
404リンクが見つからない
409スラッグが既に使用されている
410リンクが期限切れまたは無効化
429レート制限超過
URLを短縮する