Skip to main content
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 ID da Application 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 informar user_id=me. Se não for informado, a consulta não será primeiro restrita por conta, e a paginação poderá retornar 403 ao encontrar objetos sem permissão; administradores podem visualizar a tabela inteira sem informá-lo.

​
Parâmetros de consulta

paid, disabled, expired, low_balance e tag atualmente não são parâmetros de filtragem do servidor. Para alertas de saldo, após obter a lista, deve-se avaliar no cliente com base em remaining_amount, service.unit e no limite de negócio de cada Application.

​
Exemplos de solicitação

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

​
Descrição da resposta

A resposta é {count, items}. Cada item contém os campos do modelo Application e também:
  • 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;
  • o valor real de scope é Individual ou Global;
  • o valor real de type é Usage ou Period.
remaining_amount pode estar vazio; o cliente deve primeiro verificar se está vazio antes de fazer comparações numéricas. A unidade da cota é determinada por service.unit.

​
Próximas etapas