Vai al contenuto principale
Scarica direttamente i dettagli delle chiamate API dell’account corrente come CSV, adatto per la riconciliazione finanziaria, l’analisi offline o il salvataggio di grandi quantità di record. Se devi solo visualizzare una piccola quantità di dettagli nella pagina, utilizza prima l’elenco dei record delle chiamate. L’intervallo di query per i record delle chiamate e i riepiloghi di fatturazione è degli ultimi 60 giorni; i corpi delle richieste e delle risposte vengono conservati separatamente per gli ultimi 30 giorni. La scadenza dei corpi non modifica l’addebito effettivo, l’utilizzo o le statistiche aggregate di quel record.

Preparazione

  1. Accedi alla piattaforma AceDataCloud.
  2. Crea un token dell’account nella console Account Token e salvalo immediatamente in un gestore di password o in un Secret Manager.
  3. Ottieni gli ID di filtro secondo necessità dall’elenco delle richieste di servizio, dall’elenco delle credenziali API o dall’elenco delle API.
Per la descrizione completa dei token, consulta Gestire i token dell’account. I token dell’account e le Credential per chiamare API aziendali non sono intercambiabili.

Panoramica dell’interfaccia

Questa interfaccia restituisce sincronicamente il CSV in streaming, non crea attività di esportazione e non restituisce JSON o link per il download. Solo quando entrambi gli orari di inizio e fine non vengono forniti, vengono esportati per impostazione predefinita i record dall’inizio del mese solare corrente fino al momento attuale; quando viene fornito un solo limite, l’altro non viene automaticamente completato con il limite del mese corrente.

Parametri di query

L’intervallo di esportazione è sempre limitato ai record visibili per l’account corrente come soggetto pagante e/o chiamante effettivo; l’esportazione tra account non è supportata.

Esempi di richiesta

Salva direttamente il CSV del mese corrente:
Esporta per Application, orario e codice di stato:
Salvataggio in streaming con Python e verifica dell’integrità:

Colonne CSV

L’ordine dell’intestazione CSV è fisso:
L’unità di credito è determinata da service.unit della Application corrispondente.

Determinare se l’esportazione è completa

Una singola esportazione può produrre al massimo 1.000.000 record. Dopo che il server ha iniziato a restituire il CSV, non può più modificare un errore intermedio in un altro stato HTTP, pertanto il client deve controllare l’ultima riga:
  • # truncated:: è stato raggiunto il limite di righe; esporta in segmenti utilizzando finestre temporali più piccole.
  • # error:: la lettura in streaming è stata interrotta; riduci l’intervallo ed esporta nuovamente.
Quando il programma di riconciliazione rileva uno qualsiasi dei marker, deve considerare il file incompleto e non può contabilizzarlo silenziosamente.

Errori e tentativi

Passaggi successivi