Autenticazione
Chiavi gestite dal gestionale, permessi per integrazione, revoca immediata.
La chiave
Ogni chiamata porta la chiave nell'intestazione:
Authorization: Bearer sc_live_LATUACHIAVELe chiavi si creano e si revocano in autonomia da Impostazioni → Chiavi API. La revoca è immediata: la chiave smette di funzionare alla richiesta successiva. Solo HTTPS.
I permessi
Alla creazione si selezionano i permessi della chiave: sono gli stessi permessi delle schermate — per esempio articoli.read, articoli.write, fatture.write, movimenti.write. Una chiamata fuori dai permessi della chiave risponde 403 con il permesso che manca. Indicazione operativa: una chiave per integrazione, con i soli permessi necessari — una revoca disattiva una sola integrazione.
Le anagrafiche di supporto (categorie, aliquote, pagamenti, magazzini…) le legge ogni chiave valida, senza permessi particolari: sono i dati necessari per risolvere gli id da passare nelle scritture.
Se qualcosa non va
| Risposta | Significato |
|---|---|
401 chiave_mancante | Manca l'intestazione Authorization. |
401 chiave_non_valida | La chiave è sbagliata o è stata revocata. |
403 api_spente | Le API non sono attive sull'installazione: contattare l'assistenza. |
403 scope_mancante | La chiave non ha il permesso per quell'operazione. |