Nutzung

Usage Endpoint Reference

Die Nutzungs-APIs fassen die Nutzung der REST-API und die Fehleraktivität für Ihr Abonnement zusammen. Verwenden Sie diese Endpunkte, um Integrationen zu überwachen, das tägliche Anrufvolumen zu verfolgen und Fehlertrends zu identifizieren.

Die Nutzungsdaten enthalten eine Gesamtanzahl der API-Aufrufe und eine Aufschlüsselung pro Benutzer. Die Fehlerdaten enthalten eine Gesamtanzahl von Fehlern und eine Aufschlüsselung nach Fehlercode.

Die Nutzungs-APIs verwenden dieselbe Authentifizierungsmethode wie andere Marketo REST-APIs. Übergeben Sie das Zugriffstoken in der Authorization: Bearer {accessToken}.

Endpunkte

Tägliche Nutzung

Ruft die API-Nutzung für den aktuellen Tag ab.

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

Jedes Objekt im result-Array enthält die Nutzungssummen für einen Tag und eine Aufschlüsselung pro Benutzer.

Nutzung der letzten 7 Tage

Ruft die API-Nutzung der letzten 7 Tage ab. Jedes Element im result stellt einen Tag dar.

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

Tägliche Fehler

Ruft API-Fehler für den aktuellen Tag ab.

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

Jedes Objekt im result-Array enthält einen Tag mit Fehlersummen und eine Aufschlüsselung nach Fehlercode.

Fehler der letzten 7 Tage

Ruft API-Fehler der letzten 7 Tage ab. Jedes Element im result stellt einen Tag dar.

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

Antwort-Member

Usage Result Object

Benutzerobjekt verwenden

Fehlerergebnisobjekt

Fehlerobjekt

Hinweise

Die Nutzungsantwort meldet jeden API-Benutzer separat. Durch die Zuweisung von Integrationen zu separaten API-Benutzern kann leichter ermittelt werden, welcher Service Kontingente in Anspruch nimmt und Fehler verursacht.