Uso

Referencia de extremo de uso

Las API de uso resumen el consumo de API de REST y la actividad de error de la suscripción. Utilice estos extremos para monitorizar las integraciones, rastrear el volumen diario de llamadas e identificar las tendencias de error.

Los datos de uso incluyen un recuento total de llamadas de API y un desglose por usuario. Los datos de error incluyen un recuento total de errores y un desglose por código de error.

Las API Usage utilizan el mismo método de autenticación que otras API REST de Marketo. Pase el token de acceso en el encabezado Authorization: Bearer {accessToken}.

Puntos de conexión

Uso diario

Recupera el uso de la API para el día actual.

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

Cada objeto de la matriz result contiene un día de totales de uso y un desglose por usuario.

Últimos 7 días de uso

Recupera el uso de la API durante los últimos 7 días. Cada elemento de la matriz result representa un día.

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

Errores diarios

Recupera los errores de API del día actual.

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

Cada objeto de la matriz result contiene un día de totales de errores y un desglose por código de error.

Errores de los últimos 7 días

Recupera errores de API de los últimos 7 días. Cada elemento de la matriz result representa un día.

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

Miembros de respuesta

Objeto de resultado de uso

Objeto de usuario de uso

Objeto de resultado de error

Objeto de error

Notas

La respuesta de uso informa cada usuario de API por separado. Asignar integraciones a usuarios de API independientes facilita la identificación de qué servicio consume cuota y produce errores.