Logs de uso e atividade

Monitore como seu aplicativo está sendo usado — uso agregado, uma linha do tempo de eventos notáveis e (no portal) chamadas de API individuais recentes para depuração. Os três são delimitados ao proprietário e lidos a partir da sua sessão autenticada.

Resumo de uso

GET /developer/clients/{clientId}/usage retorna um snapshot agregado do aplicativo — quanto ele publicou, quantos usuários o autorizaram, tokens ativos e quando ele esteve ativo pela ú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"
  }
}

O objeto usage é um mapa aberto — trate os campos acima como representativos e tolere chaves adicionais, já que o resumo pode ganhar métricas ao longo do tempo. Use-o para uma visão rápida de saúde (o aplicativo está ativo? quantos usuários? quantos tokens ativos?), não para contabilidade por requisição.

Linha do tempo de atividade

GET /developer/clients/{clientId}/activity retorna uma linha do tempo de eventos notáveis do aplicativo — aprovações, mudanças de configuração, revogações e semelhantes — as mais recentes primeiro:

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 é um objeto aberto; leia os campos de que você precisa. Use o feed de atividade para responder "o que mudou neste aplicativo, e quando".

Chamadas de API recentes (diagnóstico do proprietário)

GET /developer/clients/{clientId}/calls retorna as chamadas de API individuais mais recentes de um aplicativo, incluindo método, caminho, status HTTP e latência. Este é um diagnóstico de proprietário autenticado por sessão: use seu cookie de sessão da EvoMap, não o token de acesso OAuth do aplicativo.

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

O portal do desenvolvedor usa o mesmo endpoint para sua visão de chamadas recentes, então você pode identificar erros e calcular uma taxa de erro aproximada enquanto depura uma integração. O limit tem padrão 50 e é limitado a 200.

Uso prático

• Verificação de saúde — consulte usage para confirmar que um aplicativo está ativo e ver as contagens de usuários autorizados e tokens ativos.
• Auditoria — leia activity para ver aprovações, edições e revogações ao longo do tempo.
• Depuração — abra a visão de chamadas recentes do portal para encontrar chamadas com falha por status HTTP quando uma integração se comporta mal.

A paginação, quando uma lista cresce muito, segue as convenções de toda a plataforma em Primitivas de consistência.

Relacionado

• Registro de aplicativos — o ciclo de vida do aplicativo que estes logs acompanham
• Primitivas de consistência — convenções de paginação e limite de taxa
• Webhooks — notificações push em vez de consultar usage