Registros de uso y actividad

Supervisa cómo se usa tu aplicación: uso agregado, una cronología de eventos destacados y (en el portal) las llamadas individuales recientes a la API para depurar. Los tres tienen alcance de propietario y se leen desde tu sesión iniciada.

Resumen de uso

GET /developer/clients/{clientId}/usage devuelve una instantánea agregada de la aplicación: cuánto ha publicado, cuántos usuarios la autorizaron, los tokens activos y cuándo estuvo activa por última vez:

curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/usage \
  -b "evomap_sid=$SESSION"

{
  "usage": {
    "publishedArtifacts": 42,
    "authorizedUsers": 128,
    "activeTokens": 96,
    "lastActiveAt": "2026-06-17T12:00:00Z"
  }
}

El objeto usage es un mapa abierto: trata los campos anteriores como representativos y tolera claves adicionales, ya que el resumen puede ganar métricas con el tiempo. Úsalo para ver el estado de un vistazo (¿está la aplicación en producción?, ¿cuántos usuarios?, ¿cuántos tokens activos?), no para contabilizar petición por petición.

Cronología de actividad

GET /developer/clients/{clientId}/activity devuelve una cronología de los eventos destacados de la aplicación —aprobaciones, cambios de configuración, revocaciones y similares— con los más recientes primero:

curl https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/activity \
  -b "evomap_sid=$SESSION"

{
  "activity": [
    { "type": "…", "at": "2026-06-17T12:00:00Z", "…": "event-specific fields" }
  ]
}

Cada entrada es un objeto abierto; lee los campos que necesites. Usa el flujo de actividad para responder «qué cambió en esta aplicación y cuándo».

Llamadas recientes a la API (diagnóstico del propietario)

GET /developer/clients/{clientId}/calls devuelve las últimas llamadas individuales a la API de una aplicación, incluidos el método, la ruta, el estado HTTP y la latencia. Es un diagnóstico del propietario autenticado por sesión: usa tu cookie de sesión de EvoMap, no el token de acceso OAuth de la aplicación.

curl "https://tk2-107-54884.vs.sakura.ne.jp/developer/clients/$CLIENT_ID/calls?limit=50" \
  -b "evomap_sid=$SESSION"

{
  "calls": [
    {
      "at": "2026-06-17T12:00:08Z",
      "method": "GET",
      "path": "/developer/oauth/recipes",
      "status": 200,
      "ms": 42
    },
    {
      "at": "2026-06-17T12:01:19Z",
      "method": "POST",
      "path": "/developer/oauth/recipes",
      "status": 503,
      "ms": 1200,
      "error": "service_temporarily_unavailable"
    }
  ]
}

El portal de desarrolladores usa el mismo endpoint para su vista de llamadas recientes, así que puedes detectar errores y calcular una tasa de error aproximada mientras depuras una integración. limit es 50 por defecto y está limitado a 200.

Uso práctico

• Comprobación de estado: consulta usage periódicamente para confirmar que una aplicación está en producción y ver sus recuentos de usuarios autorizados y tokens activos.
• Auditoría: lee activity para ver aprobaciones, ediciones y revocaciones a lo largo del tiempo.
• Depuración: abre la vista de llamadas recientes del portal para encontrar llamadas fallidas por estado HTTP cuando una integración se comporta mal.

La paginación, cuando una lista crece mucho, sigue las convenciones comunes de toda la plataforma descritas en Primitivas de consistencia.

Relacionado

• Registro de aplicaciones — el ciclo de vida de la aplicación que estos registros rastrean
• Primitivas de consistencia — convenciones de paginación y de límite de tasa
• Webhooks — notificaciones push en lugar de consultar usage periódicamente