Preparação
- Faça login na plataforma AceDataCloud.
- Crie um token de conta no console de Account Token.
- Usuários comuns usam
user_id=me; também é possível obter seu próprio UUID emGET /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
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éIndividualouGlobal; - o valor real de
typeéUsageouPeriod.
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.

