Saltar para o conteúdo principal
Resume o número de solicitações e a cota efetivamente deduzida da conta atual por data e API, adequado para criar relatórios mensais, gráficos de tendências e análises de custo. Para depurar cada registro, use a lista de registros de chamadas; para obter detalhes completos off-line, use a exportação de volume de chamadas. O intervalo de consulta de registros de chamadas e resumos de cobrança é dos últimos 60 dias; os corpos de solicitação e resposta são mantidos separadamente 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 de Account Token e salve-o imediatamente.
  3. Caso seja necessário restringir o escopo, obtenha o ID correspondente na lista de solicitações de serviço, na lista de credenciais de API ou na lista de APIs.
Para a descrição completa dos tokens, consulte gerenciar tokens de conta. Esta API usa Account Token, não credenciais de negócio.

Visão geral da API

Parâmetros de consulta

start_time / end_time ainda podem ser usados como aliases de compatibilidade para clientes antigos; novas integrações devem usar uniformemente created_at_from / created_at_to. A forma de data de created_at_to incluirá esse dia natural, isto é, usa a meia-noite do dia seguinte como limite.

Exemplos de solicitação

Consulte o resumo diário/API do mês atual no horário de Pequim, incluindo a dimensão de modelo:
Consulte o uso de uma semana de uma Application especificada:
Exemplo em Python:

Exemplo de resposta

Campos da resposta

A unidade de cota depende de service.unit da Application relacionada. Se a consulta incluir serviços com unidades diferentes, primeiro faça as estatísticas separadamente por service_id ou application_id, evitando compará-las ou somá-las diretamente. Quando a hora de término não for maior que a hora de início, a API retorna uma estrutura vazia completa: items=[], total=0, apis={}, requests=0, models=[].

Recomendações de erros e desempenho

  • Por padrão, não ative include_models; habilite-o somente quando o relatório realmente precisar de divisão por modelo.
  • Para consultas de grande alcance, priorize a separação por service_id ou application_id, evitando unidades mistas e reduzindo o custo da consulta.
  • Datas sem chamadas não recebem zeros automaticamente; complete o eixo de datas no cliente antes de desenhar gráficos.

Próximas etapas