Per iniziare a utilizzare la Business API di Soldo nel tuo account di produzione, dovrai creare un'applicazione nell'app web di Soldo. Questo processo genererà le credenziali che il tuo sistema utilizzerà per autenticarsi in modo sicuro con l'API.
Crea un'applicazione
- Accedi all'app web di Soldo.
- Dal menu di navigazione principale, vai su Integrazioni > Business API.
- Seleziona Crea applicazione.
- Inserisci un nome per la tua applicazione.
- Inserisci una chiave pubblica. Dovrai generare una coppia di chiavi RSA 2048-bit valida in formato PEM.
Cos'è una coppia di chiavi?
- Chiave pubblica: Condivisa con Soldo. Pensala come un nome utente — identifica la tua applicazione.
- Chiave privata: Tenuta segreta. Viene utilizzata per firmare in modo sicuro le tue richieste API.
Puoi trovare istruzioni per creare una coppia di chiavi utilizzando openssl durante il flusso di configurazione.
- Seleziona Avanti.
- Seleziona gli scope di cui la tua applicazione ha bisogno e poi clicca su Continua. Puoi modificarli in seguito se necessario.
- Rivedi le tue impostazioni e accetta i termini e le condizioni.
- Seleziona Crea applicazione
Una volta creata, le tue credenziali verranno mostrate in un popup:
- Client ID – identifica la tua applicazione
- Client secret – utilizzato per l'autenticazione standard
- Fingerprint token – utilizzato per autenticazione avanzata o per scaricare allegati
Cosa succede se perdo le mie credenziali API?
Puoi rigenerarle in qualsiasi momento. Vai su Integrazioni > Business API, seleziona l'applicazione e clicca su Rigenera credenziali. Questo genererà un nuovo Client secret e Fingerprint token. Il tuo Client ID rimarrà lo stesso.
Prossimi passi
Una volta che hai creato la tua applicazione nell'app web e generato le tue credenziali, sei pronto per iniziare con la Business API di Soldo.
La documentazione completa dell'API è disponibile nel nostro Business API Developer Portal.