ovahub查詢私有網路清單
/api/v1/networks
依 ID 排序讀取目前組織最多 100 筆本機網路快照。空白頁面不代表供應商端不存在網路。
呼叫前請注意
僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
curl "https://tovahub.com/api/v1/networks" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
{
"networks": [],
"nextCursor": null,
"source": "local",
"verification": "unknown",
"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."
}
}參數
after查詢字串 · 選填string
選填的 24 位十六進位游標，取自網路清單的 nextCursor 或網路詳情的 portsNextCursor。回傳 ID 大於游標的最多 100 筆資料；null 表示沒有下一頁。
回應
HTTP 狀態 200
依 ID 排序讀取目前組織最多 100 筆本機網路快照。空白頁面不代表供應商端不存在網路。
networksobject[]依 ID 排序讀取目前組織最多 100 筆本機網路快照。空白頁面不代表供應商端不存在網路。
networks[].idstring平台識別碼，並非供應商識別碼。
networks[].providerstring已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].namestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].regionstring已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].dataCenterstring | null已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].cidrstring | null已記錄的私有網路CIDR；尚未觀測時為null。
networks[].boundServersinteger | null目前組織所擁有實體伺服器的有效綁定數；資料不一致時為null。
networks[].occupiedPortsinteger | null本地有效占位數，包含預留及移出中的名額；占用資料不一致時為null。
networks[].capacityinteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].statestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].versioninteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
networks[].monthlyPricestring美元美分整數字串，並非美元金額；顯示價格不代表可付款。
networks[].serviceFromstring (ISO 8601) | null服務僅在購買確證完成後開始；未知時為 null。
networks[].serviceUntilstring (ISO 8601) | null平台已付服務的截止時間，與供應商已付日期獨立；未知時為 null。
networks[].autoRenewboolean僅為續約意向，不證明已付款或已延長服務期。
networks[].accessStatestring儲存的本機網路存取狀態：active、stopping、stopped、restoring 或 unknown，不代表目前供應商連線已通過驗證。
networks[].currency"USD"固定幣別 USD、價格單位 cent；若有計費週期則為 month。
networks[].priceUnit"cent"固定幣別 USD、價格單位 cent；若有計費週期則為 month。
networks[].checkedAtstring | null快照檢查時間（ISO 8601），未知時為 null。有時間戳記不代表即時驗證。
networks[].testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
networks[].source"local"固定為 local；不向供應商發送即時請求。
networks[].verification"unknown" | "snapshot"有 checkedAt 時為 snapshot，否則為 unknown。兩者均不驗證供應商目前狀態。
networks[].capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。
nextCursorstring | null選填的 24 位十六進位游標，取自網路清單的 nextCursor 或網路詳情的 portsNextCursor。回傳 ID 大於游標的最多 100 筆資料；null 表示沒有下一頁。
source"local"固定為 local；不向供應商發送即時請求。
verification"unknown"固定為 unknown；本機結果為空並非供應商端不存在的證明。
capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。