Skip to main content
GET
Abrechnungsaggregation
GET https://api-datahub.octoparse.com/v1/billing Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>). Wie viel Sie in einem Zeitraum ausgegeben haben, und wo. Unabhängig vom Account-Identity-Endpoint. Die Zeitspanne nutzt dasselbe Vokabular wie Runs auflisten: created_from / created_to sind inklusive/exklusive absolute ISO-8601-Zeiten, keyed nach Run-Startzeit. Dieselben Bounds an Runs auflisten übergeben, um in die Runs hinter jedem Gruppentotal zu drill-downen. tz_offset entscheidet nur, an welchem lokalen Tag ein Run für Tages-Buckets landet; Beträge und die absolute Spanne selbst ändert es nicht. Nur Datengebühren werden aggregiert. Tagesgruppen aufsteigend für Reconciliation; App- und Credential-Gruppen absteigend nach Betrag, damit der größte Spend zuerst erscheint. Die credential-Aufschlüsselung beantwortet „wie viel hat jeder meiner Keys ausgegeben?“. Key = nicht-sensitive stabile Credential-ID, derselbe Wert wie Filter credential bei Runs auflisten. Scope immer Ihr Konto; Credentials anderer nie sichtbar.

Anfrage

Abfrageparameter

string
Standard:"day"
Aufschlüsselungsdimension: day (Standard), data_app oder credential.
string
Inklusiver Start. Weglassen = ab dem frühesten Run.
string
Exklusives Ende. Weglassen = bis jetzt.
integer
Standard:"0"
Zeitzonen-Offset der Tages-Buckets in Minuten gegenüber UTC. Verwenden Sie 480 für China Standard Time; der Standard 0 entspricht UTC-Tagen. Nur fester Offset (keine Sommerzeit). Drill-down-Abfragen mit created_from / created_to müssen denselben Offset verwenden. Bereich -720 bis 840.

Beispielanfrage

Antwort

200 Erfolg

Payload ist in data gewrappt. Felder:
number
Summe des Zeitraums; entspricht der Summe der amount-Werte der Gruppen.
string
Währung.
string
Tatsächlich genutzte Dimension.
object[]
Gruppenzeilen. Jedes Dimensionsfeld ist vorhanden; nicht verwendete sind null.

Fehler

Fehlerantworten nutzen {"error": {code, category, message, retryable}}. Siehe Fehler.

Client-Bibliotheken