GETBearer トークン
請求履歴を取得
/api/v1/history
固定チームのサーバーとプライベートネットワークの購入・更新を、製品と時間で絞り込み後に1ページ20件で返します。未確認の結果は不明のままです。
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。1ページ20件。
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を含みます。認証情報やプロバイダー内容は除外します。