API リファレンス

Nayalink は完全に型付けされた REST API を提供します。ダッシュボードでできることはすべて — 短縮リンクの作成、キャンペーンとタグの管理、プライバシー重視のクリック分析の閲覧 — プログラムから利用できます。

ブラウザーでリクエストを試せるインタラクティブなリファレンスについては、インタラクティブ API リファレンス を開いてください。機械可読なコントラクトは OpenAPI ドキュメント です。

ベース URL

すべてのエンドポイントは https://api.nayalink.co から提供されます。

認証

Bearer トークンとして送信される API キーで認証します。

Authorization: Bearer <your-api-key>

API キーは Pro および Business プランで利用でき、特定の権限にスコープを限定できます。設定 → API トークン で管理します。

短縮リンクの作成

必須なのは original_url のみです。

curl -X POST https://api.nayalink.co/api/v1/links \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"original_url": "https://example.com/very/long/url"}'

レスポンスには、生成された短縮コードと完全な短縮 URL が含まれます。

リソース

• リンク — 短縮リンクの作成、更新、管理：カスタムコード、有効期限、パスワード保護、ルーティングルール。
• キャンペーン — リンクをキャンペーンにまとめ、それらの分析を集約します。
• タグ — 色分けされたタグでリンクを整理します。
• アナリティクス — 集計されたプライバシー重視のクリック分析を閲覧します：期間ごとの訪問数、国、都市、リファラー、ブラウザー、オペレーティングシステム、デバイスの種類、言語、UTM パラメーター。IP アドレスは一切保存されません。
• API トークン — スコープ付き API キーを作成・失効します。
• プロフィール — 認証済みアカウントを読み取り、更新します。

次のステップ

• API リファレンス でリクエストをインタラクティブに試せます。
• Nayalink は初めてですか？ まずは イントロダクション から始めましょう。