Vai al contenuto principale
Una «richiesta (Application)» rappresenta la relazione di sottoscrizione dell’account corrente a un determinato servizio: è necessario prima effettuare la richiesta, per poi poter creare credenziali API per questa richiesta e chiamare le interfacce business. Quando si richiede un servizio per la prima volta, l’Application riceverà il free_amount attualmente configurato per quel servizio; questo valore potrebbe essere 0.
ℹ️ Questa interfaccia appartiene alla API di gestione della piattaforma AceDataCloud, con prefisso unificato https://platform.acedata.cloud/api/v1/. Per l’indice completo delle interfacce, vedereOttieni l’elenco della documentazione della piattaforma AceDataCloud.

Flusso di integrazione completo

I nuovi utenti, dalla registrazione fino alla chiamata riuscita della prima interfaccia business, seguono generalmente questi 5 passaggi:
  1. Ottenere il token dell’account → Gestire il token dell’account della piattaforma AceDataCloud
  2. Selezionare un servizio → Ottieni l’elenco dei servizi della piattaforma AceDataCloud
  3. Creare una richiesta (questo documento) → Ottenere la quota iniziale in base alla configurazione del servizio
  4. Creare credenziali API → Creare credenziali API della piattaforma AceDataCloud
  5. Chiamare l’interfaccia business → Usare il Token di 32 caratteri ottenuto per chiamare https://api.acedata.cloud/<path>

Panoramica dell’interfaccia

Istruzioni di autenticazione (come ottenere il token dell’account)

Intestazione della richiesta:
Il token dell’account (Account Token) è una “chiave a livello di account” con cui gli sviluppatori gestiscono le risorse del proprio account tramite API. Modalità per ottenerlo:
  1. Creazione con un clic dalla console (consigliata): accedere alla piattaforma AceDataCloud → console Account Token → fare clic su «Crea» per ottenere un token che inizia con platform-v1-.
  2. Creazione tramite API: usare un token dell’account esistente o il JWT della sessione di accesso del browser per chiamare POST /api/v1/platform-tokens/; per i dettagli vedereGestire il token dell’account della piattaforma AceDataCloud.
⚠️ Il token dell’account è sensibile quanto una password, ed è vietato inserirlo nel codice frontend o nei repository pubblici. In caso di perdita, eliminarlo immediatamente dalla console e ricrearlo.

Corpo della richiesta

Esempi di richiesta

cURL

Python

Node.js

Esempio di risposta

Operazione riuscita (HTTP 201)

La struttura dei campi restituiti è coerente conOttieni i dettagli della richiesta di servizio della piattaforma AceDataCloud.

Già richiesto (HTTP 400)

Questo è un limite rigido per progettazione: ogni utente può avere una sola Application per ogni servizio. Se esiste già, cercare quella esistente tramiteOttieni l’elenco delle richieste di servizio della piattaforma AceDataCloud.

Il servizio non esiste (HTTP 404)

Il servizio richiede approvazione (HTTP 403)

Se il servizio ha need_verify=true (questo campo è visibile nell’elenco dei servizi), è necessario seguire il processo di ticket per richiedere l’inserimento nella whitelist.

Gestione degli errori

Formato unificato della risposta di errore:

Suggerimenti pratici

  • La creazione stessa non comporta addebiti: alla prima creazione, il credito iniziale viene impostato in base all’attuale free_amount del servizio; questo valore può essere 0, e la creazione ripetuta dello stesso tipo di Application non garantisce crediti gratuiti ripetuti.
  • Per verificare se è richiesto un pagamento, consultare il campo paid: subito dopo la richiesta paid=false; dopo aver chiamato Crea un ordine di ricarica della piattaforma AceDataCloud e completato il pagamento, diventa true.
  • disabled=true indica che è temporaneamente disabilitato — ad esempio, per l’attivazione del controllo del rischio, insolvenza, ecc. Quando è disabilitato, l’interfaccia aziendale restituirà 403.
  • Non creare richieste concorrenti senza limiti: ottenere prima il service_id di destinazione dall’elenco paginato dei servizi, quindi richiedere ogni elemento in base alle necessità aziendali; in caso di duplication, riutilizzare l’Application esistente.

Interfacce correlate

allow_overdraft è disabilitato per impostazione predefinita e viene autorizzato separatamente dall’amministratore; non può essere attivato autonomamente tramite parametri della richiesta durante la creazione dell’Application.