Skip to main content
GET
Aggregazione fatturazione
GET https://api-datahub.octoparse.com/v1/billing Autenticazione: API key obbligatoria (Authorization: Bearer <API Key>). Quanto hai speso in un periodo, e dove. Indipendente dall’endpoint identity account. L’intervallo temporale usa lo stesso vocabolario di Elenca esecuzioni: created_from / created_to sono orari assoluti ISO-8601 inclusivi/esclusivi chiave sull’ora di start della run. Passa gli stessi bound a Elenca esecuzioni per fare drill-down sulle run dietro ogni totale di gruppo. tz_offset decide solo in quale giorno locale cade una run per i bucket giorno; non cambia importi né il range assoluto. Solo le data fee sono aggregate. I gruppi giorno salgono per reconciliation; i gruppi app e credential scendono per importo così la spesa maggiore compare prima. La suddivisione credential risponde a “quanto ha speso ciascuna key?”. La key è un id credenziale stabile non sensibile, lo stesso del filtro credential di Elenca esecuzioni. Scope sempre il tuo account; mai le credenziali altrui.

Richiesta

Parametri di query

string
predefinito:"day"
Dimensione di ripartizione: day (predefinito), data_app o credential.
string
Inizio inclusivo. Ometti per partire dalla run più remota.
string
Fine esclusiva. Ometti per includere fino a ora.
integer
predefinito:"0"
Offset di fuso orario dei bucket giornalieri, in minuti rispetto a UTC. Usa 480 per l’ora standard della Cina; il valore predefinito 0 corrisponde ai giorni UTC. Solo offset fisso (niente ora legale). Le query di dettaglio con created_from / created_to devono usare lo stesso offset. Intervallo da -720 a 840.

Esempio di richiesta

Risposta

200 successo

Il payload è wrappato in data. Campi:
number
Totale del periodo; è uguale alla somma dei valori amount dei gruppi.
string
Valuta.
string
Dimensione effettivamente usata.
object[]
Righe di gruppo. Ogni campo di dimensione è presente; quelli non usati valgono null.

Errori

Le risposte di errore usano {"error": {code, category, message, retryable}}. Vedi Errori.

Librerie client