Utilizzo

Riferimento endpoint di utilizzo

Nelle API di utilizzo viene riepilogato il consumo e l’attività di errore REST API per la sottoscrizione. Utilizza questi endpoint per monitorare le integrazioni, monitorare il volume giornaliero delle chiamate e identificare le tendenze di errore.

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

La risposta di utilizzo segnala ogni utente API separatamente. L’assegnazione di integrazioni a utenti API separati semplifica l’identificazione del servizio che consuma la quota e genera errori.