Skip to main content
Scarica direttamente in formato CSV i dettagli delle chiamate API dell’account corrente, ideale per la riconciliazione finanziaria, l’analisi offline o la conservazione di grandi volumi di record. Se è necessario visualizzare solo una piccola quantità di dettagli nella pagina, utilizzare prima l’elenco dei record di chiamata.

Preparazione

  1. Accedi alla piattaforma AceDataCloud.
  2. Crea un token dell’account nella console Account Token e salvalo immediatamente nel gestore di password o nel Secret Manager.
  3. Ottieni gli ID di filtro necessari 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. Il token dell’account e la Credential per chiamare le API aziendali non possono essere usati in modo intercambiabile.

Panoramica dell’interfaccia

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

Parametri di query

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

Esempi di richiesta

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

Colonne CSV

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

Determinare se l’esportazione è completa

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

Errori e nuovi tentativi

Passi successivi