Se riscontri problemi con le tue chiavi API, come chiamate API non riuscite, disattivazioni impreviste o email di sicurezza, leggi i seguenti suggerimenti prima di contattare il nostro team di assistenza.
Ricevo un errore "Access denied for resource" (Accesso negato alla risorsa)
Una chiamata API non riesce e la risposta indica che la chiave API non include l'autorizzazione richiesta. Il messaggio è simile al seguente: Access denied for resource "account". The API key does not include the required permission. Update the key permissions or send the request with a different key (Accesso negato alla risorsa "account". La chiave API non include l'autorizzazione richiesta. Aggiorna le autorizzazioni della chiave o invia la richiesta con una chiave diversa). Il nome della risorsa cambia a seconda della chiamata.
Cause e soluzioni comuni
Espandi i seguenti paragrafi comprimibili per ulteriori informazioni su ciascuna causa:
La risorsa nominata nell'errore è una risorsa che la chiave non può raggiungere o non può utilizzare nel modo richiesto dalla chiamata. Ad esempio, una chiave con autorizzazione Read (Lettura) può visualizzare una risorsa ma non può modificarla e l'eliminazione richiede All (Tutti). Ciò può verificarsi anche se le autorizzazioni della chiave sono state ridotte al momento della modifica.
Soluzione: modifica la chiave e imposta il livello di autorizzazione necessario alla chiamata per quella risorsa. Per ulteriori informazioni, consulta il nostro articolo dedicato Creazione e gestione delle chiavi API. Solo il proprietario dell'account o gli utenti con l'autorizzazione alle chiavi API possono modificare una chiave.
Se il tuo account ha diverse chiavi API, l'integrazione potrebbe utilizzare una chiave le cui autorizzazioni non includono la risorsa.
Soluzione: confronta le ultime cifre della chiave utilizzata dall'integrazione con quelle visualizzate sulla pagina API Keys & MCP (Chiavi API e MCP). Quindi aggiorna le autorizzazioni di tale chiave o cambia l'integrazione con una chiave che disponga dell'autorizzazione richiesta.
Verifica della correzione
Invia di nuovo la stessa chiamata API con la chiave aggiornata e verifica che non restituisca più l'errore.
Se il problema persiste, contatta il nostro team di assistenza e includi le ultime cifre della chiave e il messaggio di errore esatto che hai ricevuto.
La mia chiave API mostra "No fixed date" (Nessuna data fissa), ma ho ricevuto un avviso di inattività
Non hai impostato alcuna data di scadenza al momento della creazione della tua chiave API, ma hai comunque ricevuto un'email che ti avvisa che la chiave verrà disattivata per inattività.
Causa e soluzione
La data di scadenza e la regola di inattività sono due impostazioni separate. No expiration (Nessuna scadenza) significa solo che la chiave non ha una data di scadenza fissa. Qualsiasi chiave che non abbia effettuato una chiamata API riuscita in 90 giorni viene disattivata, indipendentemente dalla sua impostazione di scadenza.
Soluzione: conferma che la tua integrazione utilizzi questa chiave specifica, poiché potrebbe usare una chiave diversa da quella del tuo account. Quindi assicurati che faccia almeno una chiamata API riuscita prima che scadano i 90 giorni. Se la chiave è già disattivata, puoi riattivarla. Per ulteriori informazioni, consulta il nostro articolo dedicato Creazione e gestione delle chiavi API.
Verifica della correzione
Effettua una chiamata API di prova con la chiave, quindi verifica nella pagina API Keys & MCP (Chiavi API e MCP) che il suo stato sia Active (Attivo) e che Last used on (Ultima volta utilizzato il) mostri la data di oggi.
Se il problema persiste, contatta il nostro team di assistenza e includi le ultime cifre della chiave e il messaggio di avviso esatto che hai ricevuto.
Ho ricevuto un'email di sicurezza con il messaggio "Verify a new IP" (Verifica un nuovo IP)
Hai ricevuto un'email da Brevo che ti chiedeva di confermare o smentire una chiamata API effettuata da un indirizzo IP non riconosciuto, e non sei sicuro se sia legittima.
Causa e soluzione
Se il blocco degli indirizzi IP sconosciuti è attivato sul tuo account, Brevo invia questa email ogni volta che rileva una chiamata API da un indirizzo IP non utilizzato in precedenza. Non significa necessariamente che ci sia qualcosa che non va. Un'integrazione legittima, come un nuovo server o uno strumento di terze parti, può trigger quando si connette per la prima volta.
Soluzione: se riconosci l'attività, autorizza il nuovo indirizzo IP dall'email o dalla pagina Authorized IPs (IP autorizzati). Se non lo riconosci, negalo ed elimina subito la chiave API, quindi creane una nuova. Per ulteriori informazioni, consulta il nostro articolo dedicato Autorizzazione e blocco degli indirizzi IP per la sicurezza di API e SMTP.
Verifica della correzione
Vai su alla pagina Authorized IPs (IP autorizzati) e conferma che l'indirizzo IP mostri lo stato previsto, autorizzato o rimosso.
Se continui a ricevere avvisi per indirizzi IP che non riconosci dopo aver sostituito la tua chiave API, contatta il nostro team di assistenza.
⏭️ E adesso?
- Creazione o eliminazione di una chiave API
- Informazioni sulle autorizzazioni delle chiavi API
- Il mio account è stato compromesso, cosa devo fare?
🤔 Domande?
In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.
Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.