Vai al contenuto principale
Restituisce in modo paginato le Application possedute dall’account o autorizzate all’uso, inclusi saldo, stato, riepilogo del servizio e credenziali associate. Adatto al monitoraggio batch del saldo, alla ricerca dell’ID Application e all’accesso alla gestione delle credenziali.

Preparazione

  1. Accedi alla piattaforma AceDataCloud.
  2. Crea un token dell’account nella console Account Token.
  3. Gli utenti normali utilizzano user_id=me; puoi anche ottenere il tuo UUID da GET /api/v1/platform-tokens/me/.

Panoramica dell’interfaccia

Gli utenti normali devono passare user_id=me. Se non viene passato, la query non viene prima ristretta per account e la paginazione potrebbe restituire 403 quando incontra oggetti non autorizzati; se un amministratore non lo passa, può visualizzare l’intera tabella.

Parametri di query

paid, disabled, expired, low_balance e tag al momento non sono parametri di filtro lato server. Per gli avvisi di saldo, dopo aver recuperato l’elenco, devi valutare lato client in base a remaining_amount, service.unit e alle soglie di business di ogni Application.

Esempio di richiesta

Visualizza contemporaneamente le Application che possiedi e quelle che altri hanno autorizzato per te:

Descrizione della risposta

La risposta è {count, items}. Ogni elemento contiene i campi del modello Application e include inoltre:
  • service: id, alias, title, type, unit, icon_url;
  • credentials: riepilogo delle credenziali che il chiamante corrente è autorizzato a vedere;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft;
  • il valore effettivo di scope è Individual o Global;
  • il valore effettivo di type è Usage o Period.
allow_overdraft è un campo booleano di sola lettura controllato dall’amministratore, con valore predefinito false. Per le applicazioni a consumo (Usage) con scoperto abilitato, un saldo insufficiente non impedisce le chiamate e l’addebito avviene comunque in base all’utilizzo effettivo; un saldo negativo rappresenta un importo in attesa di regolamento. La disabilitazione, la scadenza e i limiti delle credenziali API restano comunque validi. remaining_amount potrebbe essere vuoto; il client deve prima verificarne l’assenza, quindi effettuare il confronto numerico. L’unità dell’importo è determinata da service.unit.

Passaggi successivi