ovahub檢查新購伺服器的私有網路
/api/v1/networks/:id/order-check
比較組織擁有的網路與本地 Contabo 方案，並計算本地活動名額。網路或方案不存在時回傳 404。這不是報價、預留或相容性保證。
呼叫前請注意
僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/order-check?planId=V153®ion=EU" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
{
"networkId": "507f1f77bcf86cd799439011",
"source": "local",
"regionMatch": true,
"providerMatch": true,
"eligible": false,
"testOnly": true,
"capabilities": {
"purchase": false,
"attach": false,
"disconnect": false,
"remove": false,
"reconnect": false,
"cancelAddon": false,
"renew": false,
"resize": false,
"delete": false,
"blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
},
"blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment.",
"planId": "V153",
"region": "EU",
"networkState": "ready",
"verification": "unknown",
"capacity": {
"total": 5,
"localOccupied": 2,
"localRemaining": 3,
"networkVersion": 1,
"verification": "snapshot"
},
"compatibility": "unknown",
"supplierCost": "unknown",
"reserved": false
}參數
id路徑 · 必填string
資源 ID：24 個十六進位字元。請使用對應列表端點回傳的平台 ID，而非供應商的執行個體 ID。
planId查詢字串 · 必填string
本地 Contabo 方案 ID：1–100 個英文字母、數字、底線或連字號。不向供應商查詢方案目錄。
region查詢字串 · 必填string
本地方案地區：2–40 個英文字母、數字、底線或連字號。本地必須存在完全相符的供應商、方案及地區。
回應
HTTP 狀態 200
比較組織擁有的網路與本地 Contabo 方案，並計算本地活動名額。網路或方案不存在時回傳 404。這不是報價、預留或相容性保證。
networkIdstring平台識別碼，並非供應商識別碼。
planIdstring本地 Contabo 方案 ID：1–100 個英文字母、數字、底線或連字號。不向供應商查詢方案目錄。
regionstring本地方案地區：2–40 個英文字母、數字、底線或連字號。本地必須存在完全相符的供應商、方案及地區。
source"local"固定為 local；不向供應商發送即時請求。
regionMatchboolean僅比較本機資料；true 不代表相容或可安全連接。
providerMatchboolean僅比較本機資料；true 不代表相容或可安全連接。
networkStatestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
verification"unknown"固定為 unknown；產品與資料中心相容性、供應商容量、增項需求及費用尚未核實。
capacityobject僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
capacity.totalinteger | null僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
capacity.localOccupiedinteger | null僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
capacity.localRemaininginteger | null僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
capacity.networkVersioninteger | null僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
capacity.verification"snapshot" | "unknown"僅為本地容量：total 是已知目錄檔位或 null。數量包含所有活動的 reserved、assigned 與 releasing 名額，包括已斷線名額。資料損壞、超額或網路版本變更時，兩個數量均為 null。快照不預留名額，也不證明供應商容量。
compatibility"unknown"固定為 unknown；產品與資料中心相容性、供應商容量、增項需求及費用尚未核實。
supplierCost"unknown"固定為 unknown；產品與資料中心相容性、供應商容量、增項需求及費用尚未核實。
eligiblefalse僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
reservedfalse僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。
blockedReasonstring僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。