Usaldusväärne ajutise postkasti API automatiseerimine

Ebakindel e-posti testi versioon on lühike: loo aadress, maga viis sekundit, loe esimene sõnum ja looda, et see kuulub käesolevasse jooksu.

Usaldusväärne versioon on siiski lihtne, kuid käsitleb kohaletoimetamist asünkroonselt. See loob unikaalse aadressi, salvestab algusaja, teeb päringuid tähtaega arvestades, sobitab soovitud sõnumi, valideerib toote toimingu ja annab piisava konteksti, kui midagi ebaõnnestub.

Hoia API võti URL-i väljas

Saada GPTMail võti X-API-Key päises. Ära pane seda ?api_key= päringuparameetritesse. URL-e salvestatakse regulaarselt brauseri ajaloos, juurdepääsulogides, monitoorimissüsteemides ja viitajaandmetes.

X-API-Key: YOUR_API_KEY

Salvesta võti oma CI saladuste haldurisse ja maskeeri see logides. Avalik igapäevane võti on mugav uurimiseks; kontrollitud automatiseeritud komplektid peaksid kasutama võtit, mille kvooti ja kasutust saad jälgida.

Praegused lõpp-punktid ja vastuse näited on säilitatud GPTMail API dokumentatsiooni lehel.

Üks aadress iga jooksu kohta

Genereeri uus aadress iga iseseisvalt käivitatava testi jaoks. Ära tugine õigsusele postkasti, mida jagab kogu testikomplekt.

Salvesta aadress, stsenaariumi ID, keskkond ja testi algusaja. Need väärtused võimaldavad lükata kõrvale vananenud sõnumeid ja diagnoosida kokkupõrkeid ilma sõnumi saladusi logides.

Päringu tsükkel tähtaega, mitte fikseeritud ootamist

E-posti kohaletoimetamise aeg varieerub. Fikseeritud viie sekundi ooteaeg on raiskav, kui kohaletoimetamine on kiire, ja ebastabiilne, kui see on aeglane.

Kasuta piiratud tsüklit:

deadline = now + 90 seconds
delay = 2 seconds

while now < deadline:
  messages = list inbox
  candidate = newest message matching sender, subject, and start time
  if candidate exists:
    read candidate and continue the product test
  wait delay with a small random jitter
  delay = min(delay * 1.5, 10 seconds)

Tähtaeg kuulub testi lepingusse. Paroolilähtestuse voog võib vajada teistsugust limiiti kui masspostituste eelvaade. Hoia limiit selge, et aeglane sõltuvus ei venita vaikimisi CI tööaega.

Sobita täpselt

„Esimene sõnum postkastis“ ei ole kasulik valik. Sobita mitu signaali:

• saaja võrdub selle jooksu jaoks loodud aadressiga;
• loomisaeg on hilisem kui käivitamise aeg;
• saatja kuulub oodatud teenusesse;
• teema või sõnumi tüüp vastab voole;
• sõnumi ID ei ole juba kasutatud.

Kui saatja võib väljastada mitu koodi, vali uusim sobiv sõnum. Säilita selle ID testitulemuste hulgas, et kordused ei saaks kogemata seda uuesti kasutada.

Loe ainult pärast loendi sobitamist

Postkasti loendamine peaks olema odav avastamise samm. Võta täiskirje ainult valitud kandidaadi jaoks. See vähendab tarbetut tööd ja väldib seostamata reklaammailide parseldamist.

Valideeri äriline tulemus, mitte ainult kuue‑numbrilise stringi olemasolu. Esita kood või ava oodatud link, seejärel kinnita, et konto jõuab õige olekuni.

Käsitle kiirusepiiranguid signaalina

Kui API tagastab kvoodi või kiirusepiirangu vastuse, peata praegune katse ja näita lähtestamise infot. Aggressiivsed kordused muudavad selge võimekuse signaali müraks ja võivad viivitada teiste teste.

Piira samal ajal testijooksija koonduslikkust, eriti kui komplekt loob korraga palju aadresse. Väike tööjõupool on lihtsamini siluda kui sadu samaaegseid päringutsükleid.

Puhastamine ilma tõrkeid varjamata

Puhastamine peaks toimuma pärast tõendite kogumist. Edu korral eemalda sõnumid või lase lühikese säilimisega need kaduda. Ebaõnnestumise korral säilita aadress ja sõnumi ID kaitstud CI artefaktides piisavalt kaua, et uurida, seejärel kustuta need.

Ära kunagi prindi kinnituskoodid, privaatseid linke ega täispikka HTML‑sisu avalikesse ehituslogidesse.

Tee kordused idempotentsed

Korda testi uue jooksuna uue aadressiga. Ära eelda, et sama päringu kordamine samal kontol ja postkastis algab puhtalt. Saatja võib vanad koodid kehtetuks muuta, piirata korduvaid päringuid või keelduda duplikaat‑kutsetest.

Kui võrgupäring aegub, erista „vastust ei saadud“ ja „operatsioon ei toimunud“. Kontrolli vaadeldavat olekut enne, kui teed hävitava korduse.

Raporteeri tõrke punkt

Kasulik automatiseerimise tõrge tuvastab ühe järgmistest etappidest:

1. aadressi genereerimine ebaõnnestus;
2. toote toiming ebaõnnestus enne e-posti järjekorda lisamist;
3. sobivat sõnumit ei saabunud enne tähtaega;
4. sõnum saabus, kuid sisu ei vastanud;
5. kinnitustegevus ebaõnnestus;
6. puhastamine ebaõnnestus.

See klassifikatsioon muudab juhusliku „e-posti test ebaõnnestus“ tööks, mida meeskond saab omandada.

Suurema testmaatriksi jaoks loe Tõeline e-posti testiplaan. Kohaletoimetamise diagnoosimiseks kasuta Kinnituse e-kiri ei saabunud: Leia katkine samm.