ovahub建立報價
/api/v1/orders/quote
建立有效 30 分鐘、內容不可變更的美元報價。相同 requestKey 會回傳原報價。
呼叫前請注意
報價不會建立訂單或預留庫存。管理員已開通的權杖可帶報價 id 呼叫 POST /api/v1/orders/buy，使用足額團隊 USD。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
作業系統識別碼。內建選項包括 debian12 與 ubuntu24；系統會依所選方案檢查可用性與授權。伺服器操作及其挑戰中，只有 reinstall 接受 os。
firewallIdJSON 請求主體 · 選填string
system 或組織防火牆 ID（24 個字元）。
rootPasswordJSON 請求主體 · 選填string
選填的 root 密碼，8–128 個字元。不會保留在儲存的報價中，請妥善保密。
sshPublicKeyJSON 請求主體 · 選填string
單行 OpenSSH 公開金鑰，最多 8,192 個字元：ssh-ed25519、ssh-rsa 或 ecdsa-sha2-nistp256/384/521。不接受私密金鑰、authorized_keys 選項或控制字元；註解會被移除。
autoRenewJSON 請求主體 · 選填boolean
預設為 true。僅儲存網站偏好，不構成供應商續約承諾。
回應
HTTP 狀態 200
建立或重取有效期限固定為三十分鐘的 USD 報價，不會下單或保留庫存。
idstring (ObjectId)付款意圖識別碼，同時也是報價識別碼。
purposestring意圖用途。目前公開建立流程使用 order 或 deposit；儲存值也可能是 renew，但不代表目前支援續約。
amountstring以美分表示的整數金額。
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持久化的付款錯誤（若有）。