REST API

Zorven REST API

トンネル、クライアント、ドメイン、IPルールをプログラムから管理し、リクエストログや利用状況データを取得できます。OpenAPI 3.1リファレンスは下記のとおりです。

  1. トークンを作成ダッシュボードのAPIキーセクションを開きます。
  2. スコープと有効期限を選択必要なスコープ(例: tunnels:read)と有効期限を選びます。トークンは一度だけ表示されます。
  3. リクエストを送信すべてのリクエストの Authorization: Bearer ヘッダーにトークンを付与します。
$curl -H "Authorization: Bearer zrv_api_..." https://zorven.app/api/v1/tunnels

MCPとOAuth 2.1: 同じAPIは https://zorven.app/mcp(OAuth 2.1 + PKCE S256、動的クライアント登録)からも利用できます。OAuthの full(フルアクセス)スコープはMCPクライアントにダッシュボードのセッションと同じ権限を与えます(ユーザー自身の権限を超えることはありません)。同意画面では既定でオフで、直近5分以内の再認証(ステップアップ)が必要です。アクセストークンは30分、すべての呼び出しは監査ログに記録され、APIトークンやサービスアカウントなど一部のエンドポイントは除外されます。詳細は下記のリファレンスの「OAuth 2.1とMCP」を参照してください。

APIアクセスはProプラン以上でご利用いただけます。プログラムからのリクエストは、テナントあたり毎秒約30リクエストに制限されます。プランを比較するか、CLIドキュメントをご覧ください。