Utilisation

Référence du point d’entrée d’utilisation

Les API d’utilisation résument la consommation et l’activité d’erreur de l’API REST pour votre abonnement. Utilisez ces points d’entrée pour surveiller les intégrations, suivre le volume d’appels quotidien et identifier les tendances d’erreur.

Les données d’utilisation comprennent un nombre total d’appels API et une répartition par utilisateur. Les données d’erreur incluent un nombre total d’erreurs et une répartition par code d’erreur.

Les API d’utilisation utilisent la même méthode d’authentification que les autres API REST Marketo. Transmettez le jeton d’accès dans l’en-tête Authorization: Bearer {accessToken}.

Points d’entrée

Utilisation quotidienne

Récupère l’utilisation de l’API pour la journée en cours.

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

Chaque objet du tableau result contient un jour de totaux d’utilisation et une répartition par utilisateur.

Utilisation des 7 derniers jours

Récupère l’utilisation de l’API pour les 7 derniers jours. Chaque élément du tableau result représente un jour.

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

Erreurs quotidiennes

Récupère les erreurs API pour la journée en cours.

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

Chaque objet du tableau result contient un jour d’erreur total et une répartition par code d’erreur.

Erreurs des 7 derniers jours

Récupère les erreurs API des 7 derniers jours. Chaque élément du tableau result représente un jour.

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

Membres de la réponse

Objet de résultat d’utilisation

Objet Utilisateur D’Utilisation

Objet de résultat d’erreur

Objet d’erreur

Notes

La réponse d’utilisation signale chaque utilisateur de l’API séparément. L’affectation d’intégrations à des utilisateurs d’API distincts facilite l’identification du service qui consomme des quotas et génère des erreurs.