Preparazione
- Accedi alla piattaforma AceDataCloud.
- Crea un token dell’account nella console Account Token.
- Gli utenti normali utilizzano
user_id=me; puoi anche ottenere il tuo UUID daGET /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
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èIndividualoGlobal; - il valore effettivo di
typeèUsageoPeriod.
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.

