本文へ
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を含みます。認証情報やプロバイダー内容は除外します。