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, masmetadata.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):- Faça login na plataforma AceDataCloud.
- Abra o console de Account Token.
- Clique em «Criar» e salve imediatamente o token em um gerenciador de senhas ou Secret Manager.
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.
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:application_id: obtenha na lista de solicitações de serviço;credential_id: obtenha na lista de credenciais de API;api_id: obtenha na lista de APIs;service_id: obtenha na lista de serviços.
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: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
- Agregar volume de chamadas:veja o uso agregado por data e API.
- Exportar volume de chamadas:baixe grandes quantidades de detalhes diretamente como CSV.
- Ver registros de chamadas Proxy:consulte registros de serviços do tipo Proxy.
- Ver detalhes da solicitação de serviço:verifique o saldo e a unidade da cota.
- Rotacionar credenciais de API:substitua imediatamente caso haja suspeita de vazamento da credencial.

