Användning

Referens för användningsslutpunkt

API:erna för användning ger en sammanfattning av användningen av REST API och felaktiviteten för din prenumeration. Dessa slutpunkter är användbara för att övervaka integreringar, spåra dagliga samtalsvolymer och identifiera feltrender över tid.

Användningsdata omfattar totalt antal API-anrop och per användare. Feldata innehåller ett totalt antal fel och en uppdelning per felkod.

Användnings-API:erna använder samma autentiseringsmetod som andra Marketo REST API:er. Skicka åtkomsttoken i huvudet Authorization: Bearer {accessToken}.

Slutpunkter

Daglig användning

Hämtar API-användning för den aktuella dagen.

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
            }
         ]
      }
   ]
}

Varje objekt i result-arrayen innehåller en dags summor för användning och en beskrivning per användare.

Användning de senaste 7 dagarna

Hämtar API-användning de senaste 7 dagarna. Varje element i arrayen result representerar en dag.

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

Dagliga fel

Hämtar API-fel för den aktuella dagen.

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
            }
         ]
      }
   ]
}

Varje objekt i result-arrayen innehåller en dag med felsummor och en uppdelning efter felkod.

Fel under de senaste 7 dagarna

Hämtar API-fel de senaste 7 dagarna. Varje element i arrayen result representerar en dag.

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

Svarsmedlemmar

Användningsresultatobjekt

Användarobjekt

Felresultatsobjekt

Felobjekt

Anteckningar

Var och en av dina API-användare rapporteras individuellt i användningssvaret. Genom att dela upp integreringar mellan olika API-användare blir det enklare att identifiera vilken tjänst som förbrukar kvoter och skapar fel.