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:- Ottenere il token dell’account → Gestire il token dell’account della piattaforma AceDataCloud
- Selezionare un servizio → Ottieni l’elenco dei servizi della piattaforma AceDataCloud
- Creare una richiesta (questo documento) → Ottenere la quota iniziale in base alla configurazione del servizio
- Creare credenziali API → Creare credenziali API della piattaforma AceDataCloud
- 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:- 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-. - 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)
Già richiesto (HTTP 400)
Il servizio non esiste (HTTP 404)
Il servizio richiede approvazione (HTTP 403)
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_amountdel 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 richiestapaid=false; dopo aver chiamato Crea un ordine di ricarica della piattaforma AceDataCloud e completato il pagamento, diventatrue. disabled=trueindica 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_iddi destinazione dall’elenco paginato dei servizi, quindi richiedere ogni elemento in base alle necessità aziendali; in caso diduplication, riutilizzare l’Application esistente.
Interfacce correlate
- Ottieni l’elenco dei servizi della piattaforma AceDataCloud — selezionare prima il servizio
- Ottieni l’elenco delle richieste di servizi della piattaforma AceDataCloud — visualizzare tutte le richieste effettuate
- Ottieni i dettagli della richiesta di servizio della piattaforma AceDataCloud — visualizzare una singola richiesta
- Crea una credenziale API della piattaforma AceDataCloud — passaggio successivo dopo il successo della richiesta
- Crea un ordine di ricarica della piattaforma AceDataCloud — ricaricare dopo l’esaurimento del credito gratuito
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.
