ovahub
本文へ
ドキュメントAPI リファレンスチームの USD 残高で見積もりを購入
POSTBearer トークン

チームの USD 残高で見積もりを購入

/api/v1/orders/buy

自分が作成した有効期限内の注文見積もりを、トークンに固定されたチームの USD 残高だけで購入します。成功時は HTTP 202 と applied/balance の支払い情報を返します。サーバーの提供完了ではありません。同じ見積もりの再試行では元の結果を返します。

呼び出す前に

API 購入は初期状態では無効です。チームの既存の未回収サーバーに紐づくチケットで、指定トークンの有効化を管理者に依頼してください。USD 不足は 409 で拒否し、x402、入金、xTOVA、紹介報酬には切り替えません。結果が不明な場合は同じ見積もり ID を保持し、get_payment と get_order を確認してください。MCP 購入はこの設定の対象外です。他のトークンや新規トークンには権限が引き継がれません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL
curl "https://tovahub.com/api/v1/orders/buy" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "id": "507f1f77bcf86cd799439011"
}'

表示のみ。このページから API リクエストは送信されません。

レスポンス例
JSON
{
  "id": "507f1f77bcf86cd799439011",
  "purpose": "order",
  "amount": "1200",
  "asset": "USD",
  "state": "applied",
  "mode": "balance",
  "expiresAt": "2026-11-07T12:30:00.000Z",
  "transactionHash": null,
  "network": null,
  "result": {
    "_id": "507f1f77bcf86cd799439012",
    "status": "pending"
  },
  "error": null
}

パラメーター

idJSON ボディ · 必須

string

quote_vps_order が返す見積もり／支払い情報の ID。24 桁の16進数文字列です。同じ固定チーム内で元の作成者だけが購入できます。他の項目は送らないでください。

レスポンス

HTTP ステータス 202

再試行では受理済みの同じ注文結果を返します。受理はサーバーの納品完了ではありません。

idstring (ObjectId)

決済リクエストの識別子。見積もりの識別子も兼ねます。

purpose"order"

決済の用途。現在の公開作成経路では order または deposit を使用します。保存済みの値には renew もあり得ますが、現在の更新対応を意味しません。

amountstring

整数の USD セント数。

assetstring ('USD')

プラットフォームの会計用資産。

state"applied"

永続化された決済リクエストの状態。

mode"balance"

選択済みの資金調達方法。選択前は null。

expiresAtstring (ISO 8601)

見積もりの有効期限。受領済みの資金については、この時刻を過ぎても照合処理が必要です。

transactionHashnull

存在する場合、ブロックチェーンのトランザクションハッシュ。

networknull

存在する場合、決済ネットワーク。

resultunknown | null

用途別に永続化された適用結果。共通のネストされたレスポンス構造は定義されていません。

errornull

存在する場合、永続化された決済エラー。

関連

リクエストとエラー認証