Vai al contenuto principale
Interroga i dettagli delle chiamate API business dell’account corrente degli ultimi 60 giorni, adatto per verificare gli addebiti, individuare richieste non riuscite e risolvere problemi per servizio, Application, API o credenziale.
Questa pagina interroga i log delle chiamate dell’account stesso. Se desideri visualizzare solo le statistiche pubbliche delle chiamate di una determinata API sull’intera piattaforma, utilizza le statistiche delle chiamate API.

Ambito di conservazione dei dati

I record delle chiamate e i riepiloghi di fatturazione vengono conservati per gli ultimi 60 giorni; i corpi delle richieste e delle risposte vengono conservati per gli ultimi 30 giorni. I record di 30–60 giorni possono ancora interrogare riepiloghi quali trace, stato, ora, modello, utilizzo e addebito effettivo, mentre metadata.request e metadata.response nei dettagli non vengono più restituiti. I riepiloghi necessari per il riepilogo dei modelli e le statistiche sui risultati validi vengono conservati fino alla scadenza dei corpi. Se è necessario conservare i corpi a lungo termine, salvali autonomamente durante la chiamata.

Preparazione

1. Creare un token dell’account

Questa interfaccia appartiene all’API di gestione della piattaforma e richiede l’uso di un Account Token (token dell’account):
  1. Accedi alla piattaforma AceDataCloud.
  2. Apri la console Account Token.
  3. Fai clic su «Crea» e salva immediatamente il token nel gestore di password o in Secret Manager.
Per le istruzioni complete, consulta Gestire i token dell’account della piattaforma AceDataCloud. Il token dell’account viene utilizzato per platform.acedata.cloud/api/v1/**; le interfacce business api.acedata.cloud/** utilizzano credenziali API (Credential), e i due non possono essere utilizzati in modo intercambiabile.
Non scrivere il token nel codice frontend, nei log o in repository pubblici; in caso di divulgazione, eliminalo e ricrealo immediatamente nella console.

2. Preparare gli ID di filtro (facoltativo)

Puoi visualizzare i record che l’account corrente è autorizzato a vedere senza passare condizioni di filtro. Quando è necessario restringere l’ambito: Gli utenti normali non devono passare user_id; se viene passato esplicitamente, deve corrispondere all’account corrente, altrimenti viene restituito 403. Gli amministratori possono utilizzare questo parametro per filtrare tra account diversi.

Panoramica dell’interfaccia

Ambito della query

Parametri di query

Quando l’ora della richiesta è precedente agli ultimi 60 giorni, l’interfaccia restituisce un errore di convalida del campo 400, indicando che i dettagli completi delle chiamate vengono conservati solo per 60 giorni.

Esempi di richiesta

Interrogare gli ultimi 100 record:
Filtrare per ora, Application e stato di errore:
Esempio di paginazione Python:

Esempio di risposta

Campi chiave

L’unità di credito è determinata da service.unit dell’Application corrispondente e non deve essere considerata come dollari per impostazione predefinita.

Errori e tentativi

Per lo stesso gruppo di parametri di query, mantenere al massimo una richiesta in corso. Per le query su intervalli ampi, utilizzare preferibilmente finestre di un giorno o più piccole; non sovrapporre richieste identiche a intervalli fissi.

Passaggi successivi