Account & Billing
請求集計
期間支出を日・App・資格情報で内訳。
GET
請求集計
GET https://api-datahub.octoparse.com/v1/billing
認証:APIキー必須(Authorization: Bearer <API Key>)。
期間にいくら・どこで使ったか。アカウント情報エンドポイントとは独立。
時間範囲の語彙は 実行一覧: created_from / created_to は実行開始時刻基準の inclusive/exclusive ISO-8601 絶対時刻。同じ境界を実行一覧に渡せばグループ合計の背後を掘れる。tz_offset は日バケットのローカル日だけ決め、金額や絶対範囲は変えない。
集計はデータ料金のみ。日グループは照合しやすい昇順、App・資格情報は金額降順で最大が先。
credential 内訳は「自分の各キーがいくら使ったか」。キーは機微でない安定資格情報 id で、実行一覧の credential フィルタと同じ値。スコープは常に自分のアカウント。
リクエスト
クエリパラメータ
string
デフォルト:"day"
内訳次元:
day(既定)/ data_app / credential。string
開始(inclusive)。省略で最古から。
string
終了(exclusive)。省略で現在まで。
integer
デフォルト:"0"
日バケットの UTC からの分オフセット。中国標準時は
480。既定 0 は UTC 日。固定オフセットのみ(DST なし)。掘り下げの created_from / created_to も同オフセット。範囲 -720〜840。リクエスト例
レスポンス
200 成功
data に包まれます。フィールド:
number
期間合計。各グループ
amount 合計と一致。string
通貨。
string
実際に使われた次元。
object[]
グループ行。全次元フィールドあり、未使用は
null。エラー
エラー応答は
{"error": {code, category, message, retryable}} です。エラー を参照。