Hoppa till huvudinnehåll
Returnerar sidvis de Application som kontot äger eller har beviljats behörighet att använda, inklusive saldo, status, tjänstesammanfattning och associerade autentiseringsuppgifter. Lämpligt för batchövervakning av saldo, sökning efter Application ID och åtkomst till hantering av autentiseringsuppgifter.

Förberedelser

  1. Logga in på AceDataCloud-plattformen.
  2. Skapa en kontotoken i Account Token-konsolen.
  3. Vanliga användare använder user_id=me; du kan även hämta din egen UUID från GET /api/v1/platform-tokens/me/.

API-översikt

Vanliga användare bör skicka user_id=me. Om det inte skickas begränsas frågan inte först efter konto, och sidindelningen kan returnera 403 när objekt utan behörighet påträffas; om administratörer inte skickar det kan de se hela tabellen.

Frågeparametrar

paid, disabled, expired, low_balance och tag är för närvarande inte filtreringsparametrar på serversidan. Saldoalarm bör hämta listan och sedan avgöra på klientsidan utifrån varje Applications remaining_amount, service.unit och verksamhetströskel.

Begäransexempel

Visa samtidigt de Application du äger och de som andra har auktoriserat dig för:

Svarsbeskrivning

Svaret är {count, items}. Varje post innehåller fälten i Application-modellen och lägger till:
  • service: id, alias, title, type, unit, icon_url;
  • credentials: sammanfattning av autentiseringsuppgifter som den aktuella anroparen har behörighet att se;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft;
  • det verkliga värdet för scope är Individual eller Global;
  • det verkliga värdet för type är Usage eller Period.
allow_overdraft är ett skrivskyddat booleskt fält som styrs av administratören och är som standard false. För användningsbaserade (Usage) applikationer med aktiverad övertrassering hindrar inte otillräckligt saldo anrop, utan avgifter dras fortfarande enligt faktisk användning; negativt saldo innebär kredit som väntar på avräkning. Inaktivering, utgång och begränsningar för API-autentiseringsuppgifter gäller fortfarande. remaining_amount kan vara tomt; klienten måste först kontrollera om värdet är tomt och sedan göra numeriska jämförelser. Kvotenheten bestäms av service.unit.

Nästa steg