ovahubGETBearer 權杖
查詢帳務紀錄
/api/v1/history
依產品及時間篩選固定團隊的伺服器與私有網路購買／續約紀錄，再分頁返回，每頁二十筆；未確認結果保留未知。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
cURL
curl "https://tovahub.com/api/v1/history?product=all&page=1" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
JSON
{
"userId": "507f1f77bcf86cd799439012",
"page": 1,
"limit": 20,
"total": 1,
"items": [
{
"_id": "network:507f1f77bcf86cd799439013",
"product": "network",
"kind": "purchase",
"amount": "990",
"coin": "USD",
"hostname": "team-switch",
"status": "completed",
"createdAt": "2026-11-12T00:00:00.000Z"
}
]
}參數
product查詢字串 · 選填string
all、server 或 network，預設 all。
page查詢字串 · 選填integer
頁碼 1–10000，每頁二十筆。
from查詢字串 · 選填string
含起點的 ISO 8601 UTC 時間；from 與 to 同時提供或同時省略。
to查詢字串 · 選填string
不含終點的 ISO 8601 UTC 時間，須晚於 from；用戶端將含首尾的本地日期轉成所屬時區的午夜邊界。
回應
HTTP 狀態 200
伺服器與私有網路的購買及續約紀錄，先篩選再分頁。
userIdstring已驗證讀取者的 ID；團隊由身分驗證固定。
pageinteger要求的頁碼，從 1 開始。
limit20固定每頁筆數。
totalinteger此固定團隊符合篩選的紀錄總數。
itemsarray安全紀錄包含 _id、product（server/network）、kind（purchase/renew）、整數字串 amount、coin（USD/xTOVA）、hostname、status 與 createdAt，不含供應商內容或憑據。