Skip to main content
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 você precisar apenas visualizar uma pequena quantidade de detalhes na página, use primeiro a lista de registros de chamadas.

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, lista de credenciais de API ou lista de APIs.
Para a explicação completa sobre tokens, consulte gerenciar tokens de conta. O token de conta e a Credential usada para chamar APIs de negócios 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 também não retorna JSON nem um link de download. Somente quando os horários de início e fim não são fornecidos é que, por padrão, são exportados os registros do início do mês-calendário atual até o momento atual; quando apenas um limite é fornecido, o outro limite não é automaticamente complementado com o limite deste mês.

Parâmetros de consulta

O escopo de exportação é sempre limitado aos registros visíveis para a conta atual como entidade pagadora e/ou chamadora real, e não oferece suporte à exportação entre contas.

Exemplos de solicitação

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

Colunas do CSV

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

Determinar se a exportação está completa

Uma única vez pode produzir no máximo 1.000.000 de registros. Depois que o servidor começa a retornar o CSV, não é possível 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; reduza o escopo e exporte novamente.
Quando um 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óximos passos