Le chiavi API

Una chiave API è la credenziale che un gestionale, un middleware (Zapier, Make, n8n) o un sistema esterno usa per collegarsi alla API pubblica di Accordyx, in lettura o scrittura a seconda degli scope che le assegni.

Creare una chiave

1. Nel tab Chiavi API, premi Nuova chiave.
2. Nel dialog Nuova chiave API, inserisci un Nome che ti aiuti a riconoscerla (es. "Connettore ERP", "Zapier"), fino a 80 caratteri.
3. Spunta gli scope da assegnare (di default sono selezionati tutti): «Leggi controparti», «Leggi contratti», «Leggi scadenze», «Export CSV», «Crea/modifica controparti», «Crea contratti», «Gestisci webhook».
4. Premi Crea chiave.
5. Nel dialog Chiave creata, copia subito la chiave mostrata: per sicurezza non sarà più visibile dopo la chiusura di questa finestra. Conferma con Ho copiato la chiave.

Da questo momento, in Accordyx resta salvato solo un prefisso della chiave (es. "ak_live_3f9a…") per riconoscerla in lista — mai la chiave completa.

Cosa vedi in lista

Ogni chiave mostra nome, prefisso, scope assegnati, data di creazione e l'ultimo utilizzo, oppure "mai usata" se non è ancora stata chiamata.

Revocare una chiave

1. Sulla riga della chiave, premi Revoca.
2. Conferma su Revoca chiave. Da questo momento le richieste che usano quella chiave vengono rifiutate immediatamente; l'operazione non è reversibile.

La chiave revocata resta visibile in lista con un badge "revocata", così mantieni lo storico di cosa è stato collegato nel tempo.

Limiti

Ogni chiave è limitata a 60 richieste al minuto; oltre questa soglia le richieste vengono rifiutate finché il minuto non si rinnova.

Problemi comuni

• "Dai un nome alla chiave (es. "Connettore ERP")" — il campo Nome è obbligatorio.
• "Seleziona almeno uno scope" — devi spuntare almeno uno scope prima di creare la chiave.
• "Copia non riuscita: seleziona e copia manualmente" — se il pulsante di copia non funziona, seleziona il testo della chiave a mano prima di chiudere il dialog.