Vai al contenuto principale
Aggrega per data e API il numero di richieste e l’importo effettivamente detratto dell’account corrente, adatto per creare report mensili, grafici delle tendenze e analisi dei costi. Per il debug voce per voce, utilizzare l’elenco dei record delle chiamate; per i dettagli offline completi, utilizzare l’esportazione del volume delle chiamate. L’intervallo di query dei record delle chiamate e dei riepiloghi di fatturazione è costituito dagli 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. Accedere alla piattaforma AceDataCloud.
  2. Creare un token dell’account nella console Account Token e salvarlo immediatamente.
  3. Se è necessario restringere l’ambito, ottenere l’ID corrispondente dall’elenco delle richieste di servizio, dall’elenco delle credenziali API o dall’elenco delle API.
Per la descrizione completa del token, vedere gestire i token dell’account. Questa interfaccia utilizza Account Token e non utilizza Credential aziendali.

Panoramica dell’interfaccia

Parametri di query

start_time / end_time possono ancora essere utilizzati come alias di compatibilità per i client precedenti; le nuove integrazioni utilizzano uniformemente created_at_from / created_at_to. La forma data di created_at_to includerà quel giorno naturale, ovvero utilizzerà la mezzanotte del giorno successivo come limite.

Esempi di richiesta

Interroga il riepilogo giornaliero/API del mese corrente nell’ora di Pechino, includendo la dimensione del modello:
Interroga l’utilizzo di una settimana per l’Application specificata:
Esempio Python:

Esempio di risposta

Campi della risposta

L’unità dell’importo dipende da service.unit dell’Application correlata. Se la query include servizi con unità diverse, eseguire prima statistiche separate per service_id o application_id, evitando confronti o somme diretti. Quando l’ora di fine non è maggiore dell’ora di inizio, l’interfaccia restituisce una struttura vuota completa: items=[], total=0, apis={}, requests=0, models=[].

Errori e suggerimenti sulle prestazioni

  • Per impostazione predefinita, non attivare include_models; abilitarlo solo quando il report necessita effettivamente della suddivisione per modello.
  • Per le query su intervalli ampi, separare prima per service_id o application_id, evitando sia unità miste sia costi di query più elevati.
  • Le date senza chiamate non vengono automaticamente riempite con zero; il client deve completare l’asse delle date prima di disegnare il grafico.

Passaggi successivi