Account & Billing
Abrechnungsaggregation
Ausgaben über einen Zeitraum summieren und nach Tag, App oder Credential aufschlüsseln.
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
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.