Account & Billing
Aggregazione fatturazione
Somma la spesa su un periodo e suddividila per giorno, app o credenziale.
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
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.