Saltar para o conteúdo principal
Consulte os detalhes das chamadas de API de negócio da conta atual nos últimos 60 dias, adequado para verificar cobranças, localizar solicitações com falha e investigar problemas por serviço, Application, API ou credencial.
Esta página consulta os registros de chamadas da própria conta. Se desejar apenas visualizar as estatísticas públicas de chamadas de uma determinada API em toda a plataforma, use Estatísticas de chamadas de API.

Escopo de retenção de dados

Os registros de chamadas e os resumos de cobrança são mantidos pelos últimos 60 dias; os corpos de solicitação e resposta são mantidos pelos últimos 30 dias. Os registros de 30–60 dias ainda podem consultar resumos como trace, status, horário, modelo, uso e cobrança real, mas metadata.request e metadata.response nos detalhes não serão mais retornados. Os resumos necessários para a consolidação de modelos e as estatísticas de resultados válidos serão mantidos até a expiração dos corpos. Se precisar manter os corpos por longo prazo, salve-os durante a chamada.

Preparação

1. Criar token da conta

Esta interface pertence à API de administração da plataforma e requer o uso de Account Token (token da conta):
  1. Faça login na plataforma AceDataCloud.
  2. Abra o console de Account Token.
  3. Clique em «Criar» e salve imediatamente o token em um gerenciador de senhas ou Secret Manager.
Para instruções completas, consulte Gerenciar tokens de conta da plataforma AceDataCloud. O token da conta é usado para platform.acedata.cloud/api/v1/**; para chamar as interfaces de negócio api.acedata.cloud/**, são usadas credenciais de API (Credential), e os dois não podem ser misturados.
Não escreva o token em código de frontend, logs ou repositórios públicos; se ele vazar, exclua-o e recrie-o imediatamente no console.

2. Preparar IDs de filtro (opcional)

É possível visualizar os registros que a conta atual tem permissão para ver sem passar condições de filtro. Quando precisar restringir o escopo: Usuários comuns não precisam passar user_id; se for passado explicitamente, ele deverá corresponder à conta atual, caso contrário será retornado 403. Administradores podem usar este parâmetro para filtrar entre contas.

Visão geral da interface

Escopo da consulta

Parâmetros de consulta

Quando o horário da solicitação for anterior aos últimos 60 dias, a interface retornará um erro de validação de campo 400, indicando que os detalhes completos das chamadas são mantidos apenas por 60 dias.

Exemplos de solicitação

Consultar os 100 registros mais recentes:
Filtrar por horário, Application e status de falha:
Exemplo de paginação em Python:

Exemplo de resposta

Campos principais

A unidade da cota é determinada por service.unit da Application correspondente e não deve ser assumida como dólares americanos por padrão.

Erros e novas tentativas

Mantenha no máximo uma solicitação em andamento para o mesmo conjunto de parâmetros de consulta. Para consultas de grande intervalo, priorize janelas de um dia ou menores; não sobreponha solicitações idênticas em intervalos fixos.

Próximas etapas