ovahub見積もりを作成
/api/v1/orders/quote
有効期間 30 分の変更不可の USD 見積もりを作成します。同じ requestKey では元の見積もりが返されます。
呼び出す前に
見積もりは注文や在庫予約ではありません。管理者が有効化したトークンは、見積もり id と十分なチーム USD 残高で POST /api/v1/orders/buy を使えます。MCP pay_quote は別のフローです。HTTP 入金は提供しません。
API のフィールド名、型、コードはすべての言語で共通です。
リクエスト例
curl "https://tovahub.com/api/v1/orders/quote" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"requestKey": "docs_example_001",
"planId": "<PLAN_ID>",
"region": "<REGION_CODE>",
"days": 31,
"hostname": "myserver",
"os": "debian12"
}'表示のみ。このページから API リクエストは送信されません。
レスポンス例
{
"id": "507f1f77bcf86cd799439011",
"purpose": "order",
"amount": "1200",
"asset": "USD",
"state": "quoted",
"mode": null,
"expiresAt": "2026-11-07T12:30:00.000Z",
"transactionHash": null,
"network": null,
"result": null,
"error": null
}パラメーター
requestKeyJSON ボディ · 必須string
8–100 文字。使用できるのは A–Z、a–z、0–9、アンダースコア、ハイフンです。同じ操作を再試行するときは、同じキーと完全に同じ入力を使用してください。
planIdJSON ボディ · 必須string
現在のカタログにある空でないプラン ID。
regionJSON ボディ · 必須string
カタログのリージョンコード。1–40 文字。
networkIdJSON ボディ · 任意string
このサーバー注文で選択する、所属組織のプライベートネットワークID（任意）。選択は変更できません。提供元の対応が未確認の場合、支払いや調達前に拒否します。
daysJSON ボディ · 必須integer
1–730 日。プランで実際に提供されている課金期間を選択してください。
hostnameJSON ボディ · 必須string
3–16 文字の ASCII 英数字。小文字に統一されます。
osJSON ボディ · 必須string
OS 識別子。標準の選択肢には debian12 と ubuntu24 があります。利用可否とライセンスは選択したプランに対して検証されます。サーバー操作とそのチャレンジでは、reinstall のみが os を受け付けます。
firewallIdJSON ボディ · 任意string
system または 24 文字の組織ファイアウォール ID。
rootPasswordJSON ボディ · 任意string
省略可能な root パスワード。8–128 文字。保存される見積もりには残りません。秘密にしてください。
sshPublicKeyJSON ボディ · 任意string
1 行の OpenSSH 公開鍵。最大 8,192 文字。ssh-ed25519、ssh-rsa、ecdsa-sha2-nistp256/384/521 に対応します。秘密鍵、authorized_keys オプション、制御文字は使用できません。コメントは削除されます。
autoRenewJSON ボディ · 任意boolean
既定値は true。サイト側の設定を保存するもので、プロバイダーの契約更新を約束するものではありません。
レスポンス
HTTP ステータス 200
注文や在庫予約をせず、有効期間 30 分の固定 USD 見積もりを作成するか、元の見積もりを再取得します。
idstring (ObjectId)決済リクエストの識別子。見積もりの識別子も兼ねます。
purposestring決済の用途。現在の公開作成経路では order または deposit を使用します。保存済みの値には renew もあり得ますが、現在の更新対応を意味しません。
amountstring整数の USD セント数。
assetstring ('USD')プラットフォームの会計用資産。
statestring ('quoted' | 'authorized' | 'broadcast' | 'settled' | 'applied' | 'failed')永続化された決済リクエストの状態。
modestring ('balance' | 'x402') | null選択済みの資金調達方法。選択前は null。
expiresAtstring (ISO 8601)見積もりの有効期限。受領済みの資金については、この時刻を過ぎても照合処理が必要です。
transactionHashstring | null存在する場合、ブロックチェーンのトランザクションハッシュ。
networkstring | null存在する場合、決済ネットワーク。
resultunknown | null用途別に永続化された適用結果。共通のネストされたレスポンス構造は定義されていません。
errorstring | null存在する場合、永続化された決済エラー。