Gebruik

Gebruik eindpuntverwijzing

De gebruikers-API's bevatten een overzicht van het gebruik van de REST API en de foutactiviteit van uw abonnement. Deze eindpunten zijn nuttig om integratie te controleren, dagelijks vraagvolume te volgen, en foutentendensen in tijd te identificeren.

De gegevens van het gebruik omvatten een totaal aantal API vraag en een per-gebruikersuitsplitsing. Foutgegevens bevatten een totaal aantal fouten en een indeling naar foutcode.

De Gebruiks-API's gebruiken dezelfde verificatiemethode als andere Marketo REST-API's. Geef het toegangstoken door in de header Authorization: Bearer {accessToken} .

Eindpunten

Dagelijks gebruik

Hiermee wordt het API-gebruik voor de huidige dag opgehaald.

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

Elk object in de array result bevat een gebruiksduur van één dag en een uitsplitsing per gebruiker.

Gebruik van de laatste 7 dagen

Hiermee wordt het API-gebruik voor de laatste 7 dagen opgehaald. Elk element in de array result vertegenwoordigt één dag.

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

Dagelijkse fouten

Hiermee worden API-fouten voor de huidige dag opgehaald.

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

Elk object in de array result bevat een dag met fouttotalen en een verdeling op basis van foutcode.

Fouten van afgelopen 7 dagen

Hiermee worden API-fouten van de laatste 7 dagen opgehaald. Elk element in de array result vertegenwoordigt één dag.

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

Antwoordleden

Gebruiksresultaat-object

Gebruikersobject gebruiken

Foutresultaatobject

Foutobject

Notities

Elk van uw API-gebruikers wordt afzonderlijk vermeld in de gebruiksreactie. Door de integratie van verschillende API-gebruikers te splitsen, kunt u gemakkelijker zien welke service quota verbruikt en fouten veroorzaakt.