Utilizzo

Riferimento endpoint di utilizzo

Le API di utilizzo forniscono un riepilogo del consumo delle API REST e dell’attività di errore per l’abbonamento. Questi endpoint sono utili per monitorare le integrazioni, monitorare il volume giornaliero delle chiamate e identificare le tendenze di errore nel tempo.

I dati di utilizzo includono un conteggio totale di chiamate API e un raggruppamento per utente. I dati di errore includono un conteggio totale degli errori e una suddivisione per codice di errore.

Le API di utilizzo utilizzano lo stesso metodo di autenticazione delle altre API REST di Marketo. Passa il token di accesso nell'intestazione Authorization: Bearer {accessToken}.

Endpoint

Utilizzo giornaliero

Recupera l’utilizzo dell’API per il giorno corrente.

GET /rest/v1/stats/usage.json

{
   "requestId": "5f7f#17d7d8f2b6f",
   "success": true,
   "result": [
      {
         "date": "2015-10-17",
         "total": 1120,
         "users": [
            {
               "userId": "some.body@yahoo.com",
               "count": 200
            },
            {
               "userId": "some.body@marketo.com",
               "count": 200
            },
            {
               "userId": "some.body@gmail.com",
               "count": 720
            }
         ]
      }
   ]
}

Ogni oggetto nell'array result contiene un giorno di totali di utilizzo e un raggruppamento per utente.

Utilizzo ultimi 7 giorni

Recupera l’utilizzo API per gli ultimi 7 giorni. Ogni elemento nell'array result rappresenta un giorno.

GET /rest/v1/stats/usage/last7days.json

Errori giornalieri

Recupera gli errori API per il giorno corrente.

GET /rest/v1/stats/errors.json

{
   "requestId": "5f7f#17d7d8f2b6f",
   "success": true,
   "result": [
      {
         "date": "2015-10-17",
         "total": 73,
         "errors": [
            {
               "errorCode": "604",
               "count": 1
            },
            {
               "errorCode": "609",
               "count": 56
            },
            {
               "errorCode": "610",
               "count": 16
            }
         ]
      }
   ]
}

Ogni oggetto nell'array result contiene un giorno di totali di errore e una suddivisione per codice di errore.

Errori degli ultimi 7 giorni

Recupera gli errori API per gli ultimi 7 giorni. Ogni elemento nell'array result rappresenta un giorno.

GET /rest/v1/stats/errors/last7days.json

Membri risposta

Oggetto risultato utilizzo

Oggetto utente di utilizzo

Oggetto risultato errore

Oggetto Error

Note

Ogni utente API viene segnalato singolarmente nella risposta di utilizzo. La suddivisione delle integrazioni tra utenti API separati semplifica l’identificazione del servizio che consuma quote e genera errori.