L'API non è disponibile per la mia organizzazione

L'accesso alla API pubblica può essere sospeso per un'organizzazione. In quel caso le integrazioni che usano le chiavi API smettono di funzionare finché l'accesso non viene ripristinato. Questa guida ti aiuta a riconoscere la situazione e a capire cosa fare.

Come te ne accorgi

• Ogni chiamata alla API risponde con stato 402 e codice feature_disabled, qualunque sia l'endpoint e anche con una chiave valida.
• Creare una nuova chiave in Impostazioni → API & Integrazioni → Chiavi API non riesce: compare un errore con uno dei messaggi qui sotto.

Le chiavi già create non vengono cancellate: restano in elenco e tornano a funzionare quando l'accesso viene ripristinato.

I messaggi possibili

• "La funzione "API pubblica" non è inclusa nel tuo piano. Passa a un piano superiore da Impostazioni → Fatturazione & Pagamenti." — di norma la API pubblica è inclusa in tutti i piani: questo messaggio compare anche quando la API è stata sospesa solo per la tua organizzazione. Prima di cambiare piano, contatta l'assistenza per sapere qual è il motivo.
• "La funzione "API pubblica" è momentaneamente disattivata sulla piattaforma." — la API è sospesa per tutte le organizzazioni: non devi fare nulla sul tuo account. Per sapere quando tornerà disponibile contatta l'assistenza.
• "L'abbonamento della tua organizzazione non è attivo: per eseguire azioni serve un piano pagato. Vai in Impostazioni → Fatturazione & Pagamenti per attivarlo o regolarizzare il pagamento." — l'abbonamento è sospeso o scaduto: vedi Abbonamento non attivo.

Nella risposta della API il campo reason distingue i casi: platform_disabled per la sospensione su tutta la piattaforma, subscription_blocked per l'abbonamento non attivo, feature_disabled negli altri casi.

Cosa continua a funzionare

Quando è sospesa solo la API, e non l'abbonamento:

• i webhook configurati nel tab Webhook continuano a inviare gli eventi ai tuoi endpoint, e puoi crearne o modificarne dall'interfaccia;
• l'import da Excel o CSV e i gestionali collegati nel tab Gestionali non usano le chiavi API;
• le funzioni dell'app non dipendono dalla API e restano disponibili.

Non funzionano invece le integrazioni che chiamano la API con una chiave, comprese le automazioni di Zapier, che si basano sulla stessa chiave.

Cosa fare

1. Verifica il messaggio esatto che ricevi, nella risposta della API o nell'errore della creazione della chiave.
2. Se riguarda l'abbonamento, regolarizzalo da Impostazioni → Fatturazione & Pagamenti.
3. Negli altri casi contatta l'assistenza indicando il messaggio ricevuto e l'organizzazione interessata.

Problemi comuni

• Ho cambiato piano ma ricevo ancora 402 — se la API era stata sospesa per la tua organizzazione, il cambio di piano non basta: contatta l'assistenza.
• Le chiavi risultano attive ma non funzionano — è normale finché l'accesso è sospeso: non revocarle, torneranno utilizzabili.