Saltar para o conteúdo principal
Baixe diretamente os detalhes das chamadas de API da conta atual como CSV, adequado para reconciliação financeira, análise offline ou armazenamento de grandes volumes de registros. Se precisar apenas visualizar uma pequena quantidade de detalhes na página, use primeiro a lista de registros de chamadas. O intervalo de consulta dos registros de chamadas e do resumo de faturamento é dos últimos 60 dias; os corpos de solicitação e resposta são mantidos separadamente apenas pelos últimos 30 dias. A expiração dos corpos não altera a cobrança real, o uso ou as estatísticas agregadas desse registro.

Preparação

  1. Faça login na plataforma AceDataCloud.
  2. Crie um token de conta no console Account Token e salve-o imediatamente em um gerenciador de senhas ou Secret Manager.
  3. Conforme necessário, obtenha IDs de filtro na lista de solicitações de serviço, na lista de credenciais de API ou na lista de APIs.
Para uma explicação completa sobre tokens, consulte gerenciar tokens de conta. O token de conta e a Credential para chamar APIs de negócio não podem ser usados de forma intercambiável.

Visão geral da interface

Esta interface retorna o CSV de forma síncrona e em streaming, não cria uma tarefa de exportação e não retorna JSON ou um link de download. Somente quando tanto a hora de início quanto a de término não forem fornecidas, ela exportará por padrão os registros desde o início do mês natural atual até o momento atual; quando apenas um lado do limite for fornecido, o outro lado não será preenchido automaticamente com o limite deste mês.

Parâmetros de consulta

O intervalo de exportação é sempre limitado aos registros visíveis para a conta atual como entidade pagadora e/ou chamador real, e não há suporte para exportação entre contas.

Exemplos de solicitação

Salvar diretamente o CSV do mês atual:
Exportar por Application, hora e código de status:
Salvar em streaming com Python e verificar a integridade:

Colunas CSV

A ordem do cabeçalho CSV é fixa:
A unidade de crédito é determinada por service.unit da Application correspondente.

Determinar se a exportação está completa

Uma única exportação produz no máximo 1.000.000 de registros. Depois que o servidor começa a retornar o CSV, ele não pode mais alterar um erro ocorrido no meio para outro status HTTP; portanto, o cliente deve verificar a última linha:
  • # truncated:: o limite de linhas foi atingido; exporte em segmentos usando janelas de tempo menores.
  • # error:: a leitura em streaming foi interrompida; exporte novamente após reduzir o intervalo.
Quando o programa de reconciliação encontrar qualquer marker, ele deve considerar o arquivo incompleto e não pode contabilizá-lo silenciosamente.

Erros e novas tentativas

Próximo passo