本文へ
ドキュメントクイックスタート

クイックスタート.

1. プラン一覧を取得

サービス情報、プラン、リージョンは認証不要です。まず読み取り専用のリクエストを送ります。

リクエスト例
curl "https://tovahub.com/api/v1/plans"

2. チームへのアクセスを設定

Dashboard → MCP でトークンを作成します。AI はウォレット署名で認証できます。トークンはサーバー側に保存してください。

トークン設定

3. サーバー一覧を取得

実行環境に TOVAHUB_TOKEN を設定します。トークンは固定のチームに紐づきます。

リクエスト例
curl "https://tovahub.com/api/v1/servers" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

4. エンドポイントを選ぶ

チームの既存の未回収サーバーに紐づくチケットで、指定トークンの有効化を管理者に依頼してください。初期状態は無効です。POST /api/v1/orders/quote で見積もりを作成し、作成者が同じ固定チームで POST /api/v1/orders/buy に { "id": "<QUOTE_ID>" } だけを送ります。十分な USD 残高が必要で、x402、入金、xTOVA、紹介報酬には切り替えません。HTTP 202 は支払い情報であり、サーバーの提供完了ではありません。GET /api/v1/payments/:id と、result._id を使った GET /api/v1/orders/:id で確認し、結果不明時に別の購入を作成しないでください。顧客向け購入画面は追加しません。MCP 購入はこの設定の対象外です。 他のトークンや新規トークンには権限が引き継がれません。同じ見積もりの再試行では元の結果を返します。

API を見る