Saltar para o conteúdo principal
Retorna de forma paginada as Applications que a conta possui ou está autorizada a usar, incluindo saldo, status, resumo do serviço e credenciais associadas. Adequado para monitoramento de saldo em lote, localização do Application ID e acesso ao gerenciamento de credenciais.

Preparação

  1. Faça login na plataforma AceDataCloud.
  2. Crie um token de conta no console de Account Token.
  3. Usuários comuns usam user_id=me; também é possível obter seu próprio UUID em GET /api/v1/platform-tokens/me/.

Visão geral da interface

Usuários comuns devem passar user_id=me. Sem passá-lo, a consulta não será primeiro restrita pela conta, e a paginação poderá retornar 403 ao encontrar objetos sem permissão; administradores podem visualizar toda a tabela sem passá-lo.

Parâmetros de consulta

paid, disabled, expired, low_balance e tag atualmente não são parâmetros de filtragem do servidor. Os alertas de saldo devem buscar a lista e, em seguida, determinar no cliente com base em remaining_amount, service.unit e nos limites de negócio de cada Application.

Exemplo de solicitação

Visualizar ao mesmo tempo as Applications que você possui e as que outros autorizaram para você:

Descrição da resposta

A resposta é {count, items}. Cada item contém os campos do modelo Application e acrescenta:
  • service: id, alias, title, type, unit, icon_url;
  • credentials: resumo das credenciais que o chamador atual tem permissão para visualizar;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft;
  • o valor real de scope é Individual ou Global;
  • o valor real de type é Usage ou Period.
allow_overdraft é um campo booleano somente leitura controlado pelo administrador, com padrão false. Para aplicações por uso (Usage) com descoberto ativado, saldo insuficiente não impedirá as chamadas, e a cobrança ainda será feita com base no uso real; saldo negativo representa crédito pendente de liquidação. Desativação, expiração e limites de credenciais de API continuam em vigor. remaining_amount pode estar vazio; o cliente deve primeiro verificar se está vazio antes de realizar comparações numéricas. A unidade da cota é determinada por service.unit.

Próximos passos