Die onbetroubare weergawe van 'n e-pos toets is kort: skep 'n adres, wag vir vyf sekondes, lees die eerste boodskap, en hoop dit behoort tot hierdie uitvoering.
Die betroubare weergawe is steeds eenvoudig, maar dit hanteer aflewering as asinkroon. Dit skep 'n unieke adres, registreer 'n begin tyd, peil binne 'n sperdatum, pas die beoogde boodskap, valideer die produkaksie, en rapporteer genoegsame konteks wanneer iets misluk.
Hou die API-sleutel uit die URL
Stuur die GPTMail-sleutel in die X-API-Key-kop. Plaas dit nie in ?api_key=-navraagparameters nie. URL's word gereeld gestoor in die blaaiergeskiedenis, toeganglogboeke, moniteringsisteme en verwysingsdata.
X-API-Key: YOUR_API_KEYStoor die sleutel in jou CI-geheimebestuurder en maskeer dit in logboeke. 'n Publieke daaglikse sleutel is gerieflik vir verkenning; beheerde outomatiese suites moet 'n sleutel gebruik waarvan jy die kwota en gebruik kan opspoor.
Die huidige eindpunte en reaksie-voorbeelde word onderhou op die GPTMail API-dokumentasieblad.
Een adres per uitvoering
Genereer 'n nuwe adres vir elke onafhanklik uitvoerbare toets. Ontlei nie korrekheid uit 'n inboks wat deur die hele toetsstel gedeel word nie.
Registreer die adres, scenario-ID, omgewing, en toetsbegin tyd. Hierdie waardes laat jou toe om verouderde boodskappe te verwerp en botsings te diagnoseer sonder om boodskapgeheimnisse te log.
Peil teen 'n sperdatum, nie 'n vaste wag nie
E-pos afleweringstyd wissel. 'n Vaste vyfsekonde wag is beide vermors wanneer aflewering vinnig is en onbetroubaar wanneer dit stadig is.
Gebruik 'n begrensde lus:
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)Die sperdatum behoort tot die toetskontrak. 'n Wagwoordherstelvloei mag 'n ander limiet benodig as 'n massa-nuusbriefvoorskou. Hou die limiet eksplisiet sodat 'n stadige afhanklikheid nie stilweg die hele CI-taak verleng nie.
Pas presies
“Eerste boodskap in die inboks” is nie 'n nuttige selector nie. Pas verskeie seine:
- ontvanger is gelyk aan die adres wat vir hierdie uitvoering geskep is;
- skeppingstyd is later as die trigger-tijd;
- afsender behoort tot die verwagte diens;
- onderwerp of boodskaptipe pas by die vloei;
- die boodskap-ID is nog nie gebruik nie.
Wanneer die afsender verskeie kodes kan uitreik, kies die nuutste passende boodskap. Bewaar die ID daarvan in die toetsuitset sodat herprobeering dit nie per ongeluk hergebruik nie.
Lees slegs na 'n lyspassing
Inboks-lys moet die goedkoop ontdekkingsstap wees. Verkry die volledige boodskap slegs vir die gekose kandidaat. Dit verminder onnodige werk en vermy die ontleding van ongerelateerde promosie-e-pos.
Valideer die besigheidsuitkoms, nie net die teenwoordigheid van 'n ses-syfer string nie. Dien die kode in of open die verwagte skakel, en bevestig dan dat die rekening die korrekte toestand bereik.
Hanteer tempo-beperkings as 'n sein
As die API 'n kwota- of tempo-beperkingsreaksie teruggee, stop die huidige poging en bring die herstel-inligting na vore. Agressiewe herprobeeringe draai 'n duidelike kapasiteitsein in geraas en kan ongerelateerde toetse vertraag.
Beperk gelyktydigheid by die toetsuitvoerder, veral wanneer 'n suite baie adresse tegelyk skep. 'n Klein werkerpoel is makliker om te ontfout as honderde gelyktydige peilinglusies.
Opruim sonder om mislukkings te verberg
Opruiming moet loop nadat bewys vasgelê is. By sukses, verwyder boodskappe of laat kort bewaartermyn hulle hanteer. By mislukking, behou die adres en boodskap-ID in beskermde CI-artefakte lank genoeg vir ondersoek, en verwyder dit dan.
Druk nooit verifikasiekodes, private skakels, of volledige HTML-lêers in openbare boulogboeke nie.
Maak herprobeeringe idempotent
Herprobeer die toets as 'n nuwe uitvoering met 'n nuwe adres. Veronderstel nie dat die herhaling van dieselfde versoek teen dieselfde rekening en inboks vanaf 'n skoon toestand begin nie. Die afsender kan ou kodes ongeldig maak, herhaalde versoeke beperk, of duplikaat-uitnodigings verwerp.
As 'n netwerkversoek tydsverstreke, onderskei “geen reaksie ontvang nie” van “operasie het nie plaasgevind nie.” Kontroleer die waarneembare toestand voordat jy 'n vernietigende herprobeering uitvoer.
Rapporteer die punt van mislukking
'n Nuttige outomatiseringsmislukking identifiseer een van hierdie stadiums:
- adresgenerering het misluk;
- produkaksie het misluk voordat e-pos in die waglys geplaas is;
- geen passende boodskap het voor die sperdatum arriveer nie;
- boodskap het arriveer maar inhoud het nie gepas nie;
- verifikasie-aksie het misluk;
- opruiming het misluk.
Daardie klassifikasie verander 'n intermitterende “e-pos toets misluk” in werk wat 'n span kan eiena.
Vir die groter toetsmatriks, lees 'n Werklike E-pos Toetsplan. Vir afleweringsdiagnose, gebruik Verifikasie-e-pos kom nie aan nie: Vind die gebreekte stap.