tecnico · risposta con fonti

Cos'è la sandbox mode di SendGrid?

La sandbox mode di SendGrid è un ambiente con restrizioni che consente agli sviluppatori di testare integrazioni API e configurazioni SMTP senza inviare email a destinatari reali. In questa modalità il sistema convalida la richiesta e restituisce una risposta di successo, ma l'email non viene effettivamente consegnata all'indirizzo di destinazione, per evitare spam accidentale o abusi durante lo sviluppo.

Come funziona la sandbox mode

Quando un account è in sandbox mode, SendGrid elabora la chiamata API o la richiesta SMTP in arrivo per verificare che il payload sia sintatticamente corretto e che l'autenticazione sia valida. L'API restituisce il codice di stato 202 Accepted, a indicare che la richiesta è stata ricevuta. Tuttavia, il mail transfer agent non inoltra il messaggio su Internet. Questo consente agli sviluppatori di verificare la logica del codice e la gestione degli errori senza mettere a rischio la reputazione del mittente né sostenere costi.

Requisiti di verifica

Per uscire dalla sandbox mode, gli utenti devono completare un processo di verifica. Di solito questo significa fornire i dati dell'account e verificare un'identità mittente. SendGrid richiede questo passaggio per ridurre il rischio che la piattaforma venga usata per scopi malevoli. Finché l'account non è approvato del tutto, qualsiasi tentativo di inviare posta a indirizzi non verificati porta allo scarto del messaggio, nonostante l'API restituisca una risposta di successo.

Strategie di test

Usa la sandbox mode per testare l'integrazione della tua applicazione con l'API di SendGrid. Una volta confermato che le risposte dell'API sono corrette, il passo successivo è verificare un singolo indirizzo email mittente o un intero dominio. Gli strumenti gratuiti di SendHQ ti aiutano ad assicurarti che i record DNS siano configurati correttamente prima di passare in produzione, per evitare errori di consegna.

Passare alla produzione

Il passaggio alla produzione richiede di completare l'attivazione dell'account e configurare l'autenticazione del dominio. Questo significa aggiungere i record SPF e DKIM alle impostazioni DNS del dominio di invio. Quando lo stato dell'account passa da sandbox ad attivo, le email vengono instradate ai destinatari reali. Prima di inviare all'intera lista di utenti, esegui un ultimo test con un indirizzo interno noto.

Le domande dei team

Perché ricevo una risposta 202 ma nessuna email?

È il comportamento previsto della sandbox mode. Lo stato 202 significa che la richiesta API era valida, ma l'email non è stata consegnata perché l'account ha ancora delle restrizioni.

Come disattivo la sandbox mode?

Devi completare il processo di verifica dell'account e fornire al team di SendGrid le informazioni aziendali richieste per l'approvazione.

Posso inviare al mio indirizzo email in sandbox mode?

In genere no. A meno che l'indirizzo email non sia specificamente verificato come mittente o faccia parte di un'identità verificata, la sandbox mode blocca la consegna verso tutti gli indirizzi.

La sandbox mode ha un costo?

No, le richieste effettuate in sandbox mode non vengono conteggiate nella quota di invio mensile, perché non viene consegnata alcuna email.

Fonti primarie