Nutzung

Usage Endpoint Reference

Die Usage APIs bieten eine Zusammenfassung der REST-API-Nutzung und Fehleraktivität für Ihr Abonnement. Diese Endpunkte sind nützlich für die Überwachung von Integrationen, die Verfolgung des täglichen Anrufvolumens und die Identifizierung von Fehlertrends im Zeitverlauf.

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

Jeder Ihrer API-Benutzer wird einzeln in der Antwort zur Nutzung gemeldet. Die Aufteilung von Integrationen auf separate API-Benutzer erleichtert die Identifizierung, welcher Service Kontingente in Anspruch nimmt und Fehler verursacht.