Manuale operativo

La richiesta API è scaduta: la casella è stata creata?

Di Alexey Bulygin
Una lente davanti a una cassetta postale verde accanto a una clessidra

Un timeout non dice se la creazione è fallita. Il tuo sistema deve collegare la richiesta del cliente alla casella risultante. Separa creazione, inoltro e disponibilità, così un’interruzione non spinge a premere Crea di nuovo senza sapere cosa è successo.

Puoi affidare a un programma la creazione delle caselle e la configurazione degli inoltri tramite l'API di TrekMail. L'API permette al tuo sistema di inviare comandi senza che una persona ripeta i passaggi nel pannello. Queste modifiche richiedono Pro o Agency, permessi adatti e accesso al dominio scelto.

Definisci cosa vuoi creare

Parti da una descrizione semplice. «Serve una casella personale di lavoro» e «la posta di un indirizzo comune deve andare altrove» richiedono impostazioni diverse.

Una casella completa conserva le proprie conversazioni. Puoi configurare un inoltro e scegliere se mantenere una copia locale. Un indirizzo di inoltro senza casella serve a ricevere su un indirizzo e consegnare a un altro senza un archivio autonomo sul primo. Condizioni e limiti sono diversi.

Separa inoltre l'amministrazione del servizio dal contenuto dei messaggi. Creare un indirizzo non richiede automaticamente di leggere la posta dei dipendenti. I messaggi appartengono a funzioni API separate. Non concedere lettura a un programma che crea soltanto caselle.

Scrivi queste differenze prima dello sviluppo. Chi implementa saprà quale risorsa creare e quale risultato deve comparire nel pannello.

Prepara il piano e un accesso limitato

Poter impostare una funzione manualmente non significa poterla modificare via API. Creazione di caselle e modifica degli inoltri richiedono Pro o Agency. Starter consente la lettura della configurazione infrastrutturale disponibile, ma non basta per questa automazione.

Crea un accesso specifico per il programma. Limitalo ad azioni e domini necessari. Se l'agenzia segue più aziende, l'integrazione di un cliente deve operare soltanto sulle sue risorse.

Contano anche i diritti di chi autorizza. Non può dare al programma più poteri di quelli che possiede. La guida ai permessi API descrive autorizzazioni e limiti dei piani.

Conserva la chiave nella configurazione lato server dell'integrazione. Non mostrarla nel modulo di registrazione e non inviarla nell'email di benvenuto. All'utente serve un risultato chiaro: indirizzo creato e modalità di primo accesso.

Organizza la sequenza di creazione

Ricava il dominio consentito dai tuoi dati cliente. Un identificativo inviato dal browser non dimostra che il dominio gli appartenga.

Controlla poi se l'indirizzo esiste già e se i limiti disponibili bastano. Se la casella è presente, verifica se appartiene alla stessa richiesta. Un secondo clic non dovrebbe lasciare un risultato ambiguo.

Dopo la creazione imposta l'inoltro, se previsto. Per una casella completa, decidi prima se conservare una copia locale. Se la persona si aspetta un archivio lì, non lasciare questa scelta a un valore casuale.

Se la casella esiste ma l’inoltro fallisce, registra il risultato parziale e correggi quel passaggio. Segna come pronto dopo aver verificato consegna e copia locale.

La panoramica dell'API TrekMail descrive metodi e formati. Usala come specifica per lo sviluppatore mantenendo semplice il percorso dell'utente.

Prevedi ripetizioni ed errori

Per un’operazione documentata come idempotente, conserva la stessa Idempotency-Key per richiesta e contenuto identici. Salva l’ID della casella e controlla separatamente le altre regole di ripetizione.

Negli altri casi, l'integrazione deve prima verificare se la risorsa è stata creata. Non ripetere indiscriminatamente la creazione dopo una risposta poco chiara. Mantieni il legame fra richiesta e risultato per ripartire dal punto corretto.

Gestisci separatamente spazio insufficiente, limite esaurito e accesso negato. Ripetere la stessa chiamata non risolve queste cause. È più utile spiegare il problema e chi può correggerlo che mostrare «Creazione casella» senza fine.

Nelle attivazioni in blocco non promettere lo stesso tempo per tutte. Mostra lo stato individuale e un elenco dei casi che richiedono attenzione.

Prova su un dominio

Comincia da un dominio di test e pochi indirizzi. Verifica creazione normale, ripetizione della richiesta e tentativo di accesso a un dominio fuori dall'ambito consentito.

Invia poi un messaggio all'indirizzo creato. Se è previsto un inoltro, controlla il destinatario finale e la copia locale nella modalità scelta. Una risposta API riuscita non sostituisce la prova del percorso email.

Prima dell'avvio concorda chi vedrà gli errori e potrà correggerli a mano. Conserva un registro delle richieste senza chiavi o password. Quando il piccolo processo è prevedibile, inseriscilo nell'attivazione di collaboratori o clienti.

Usa la guida API. Creare infrastruttura non richiede la lettura dei messaggi del nuovo utente: concedi solo i diritti necessari.

Da leggere

Condividi questo articolo

Accedi a TrekMail

Accedi alla tua dashboard, alle caselle di posta e al DNS.

12 caratteri

Email di reimpostazione inviata

Se esiste un account per questa email, abbiamo inviato le istruzioni per reimpostare la password.

Continuando, accetti i Termini e l' Informativa sulla privacy di TrekMail.