sk

Spoľahlivá automatizácia API dočasnej schránky

Vytvorte deterministické testy registrácie a resetovania hesla s jedinečnými adresami, ohraničeným dotazovaním, presným zhodovaním správ, bezpečným spracovaním kľúča a užitočnými dôkazmi o zlyhaní.

17. 7. 2026

Kompaktná automatizačná slučka na generovanie, prijímanie, kontrolu a čistenie schránky

Nespolehlivá verzia testu e‑mailu je krátka: vytvoríte adresu, počkáte päť sekúnd, prečítate prvú správu a dúfate, že patrí k tomuto spusteniu.

Spoľahlivá verzia je stále jednoduchá, ale považuje doručenie za asynchrónne. Vytvorí jedinečnú adresu, zaznamená čas spustenia, dotazuje sa do termínu, nájde požadovanú správu, overí akciu produktu a pri zlyhaní poskytne dostatok kontextu.

Neumisťujte kľúč API do URL

Pošlite kľúč GPTMail v hlavičke X-API-Key. Nepokládejte ho do dotazových parametrov ?api_key=. URL sa bežne ukladajú v histórii prehliadača, prístupových logoch, monitorovacích systémoch a v referenčných údajoch.

X-API-Key: YOUR_API_KEY

Uložte kľúč do správcu tajomstiev vášho CI a maskujte ho v logoch. Verejný denní kľúč je pohodlný na skúmanie; kontrolované automatizované sady by mali používať kľúč, ktorého kvótu a použitie môžete sledovať.

Aktuálne koncové body a príklady odpovedí sú udržiavané na stránke dokumentácie GPTMail API.

Jedna adresa na spustenie

Vygenerujte novú adresu pre každý samostatne spustiteľný test. Neodvíjajte správnosť od schránky zdieľanej celým testovacím balíkom.

Zaznamenajte adresu, ID scenára, prostredie a čas spustenia testu. Tieto hodnoty vám umožnia odmietnuť zastarané správy a diagnostikovať kolízie bez logovania tajomstiev správ.

Dotazujte do termínu, nie s pevnou prestávkou

Čas doručenia e‑mailu sa líši. Pevná päťsekundová prestávka je zbytočná, keď je doručenie rýchle, a krehká, keď je pomalé.

Použite ohraničenú slučku:

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)

Termín patrí do zmluvy testu. Tok resetovania hesla môže vyžadovať iný limit než prehľad hromadného newsletteru. Udržujte limit explicitný, aby pomalá závislosť nepredlžovala ticho celý CI job.

Zhodujte presne

„Prvá správa v schránke“ nie je užitočný selektor. Zhodujte viacero signálov:

  • príjemca sa rovná adrese vytvorenej pre toto spustenie;
  • čas vytvorenia je neskorší ako čas spustenia;
  • odosielateľ patrí očakávanej službe;
  • predmet alebo typ správy zodpovedá toku;
  • ID správy ešte nebolo spotrebované.

Keď odosielateľ môže vydávať viacero kódov, vyberte najnovšiu zhodnú správu. Uchovajte jej ID v výstupe testu, aby opakovania nemohli náhodne použiť rovnakú správu.

Čítajte len po zhode zoznamu

Zoznam schránky by mal byť lacným krokom objavovania. Plnú správu načítajte len pre vybranú kandidátnu správu. Tým sa zníži zbytočná práca a vyhnete sa parsovaniu nesúvislej propagačnej pošty.

Overte obchodný výsledok, nie len prítomnosť šesťciferného reťazca. Odoslať kód alebo otvoriť očakávaný odkaz, potom overte, že účet dosiahol správny stav.

Riešte limity rýchlosti ako signál

Ak API vráti odpoveď o kvóte alebo limite rýchlosti, zastavte aktuálny pokus a zobrazte informáciu o resetovaní. Agresívne opakovania premenia jasný signál kapacity na šum a môžu oddialiť nesúvisiace testy.

Obmedzte súbežnosť v testovacom bežcovi, najmä keď sada vytvára veľa adries naraz. Malý pracovný pool je ľahšie debugovateľný než stovky simultánnych dotazovacích slučiek.

Upratujte bez skrývania chýb

Upratovanie by malo prebehnúť po zachytení dôkazov. Pri úspechu odstráňte správy alebo nechajte ich krátkodobo uchovávať. Pri zlyhaní zachovajte adresu a ID správy v chránených artefaktoch CI dostatočne dlho na vyšetrovanie, potom ich odstráňte.

Nikdy nevypisujte overovacie kódy, súkromné odkazy ani kompletné HTML telo do verejných logov zostavovania.

Urobte opakovania idempotentnými

Opakujte test ako nové spustenie s novou adresou. Nepredpokladajte, že opakovaním rovnakého požiadavku proti rovnakému účtu a schránke začnete v čistom stave. Odosielateľ môže neplatnosť starých kódov, obmedziť opakované požiadavky alebo odmietnuť duplicitné pozvánky.

Ak sieťová požiadavka vyprší, rozlíšte „nebola prijatá žiadna odpoveď“ od „operácia sa neuskutočnila“. Skontrolujte pozorovateľný stav pred vykonaním deštruktívneho opakovania.

Nahláste bod zlyhania

Užitočné zlyhanie automatizácie identifikuje jeden z týchto štádií:

  1. generovanie adresy zlyhalo;
  2. akcia produktu zlyhala pred zaradením e‑mailu do fronty;
  3. žiadna zhodná správa nedorazila pred termínom;
  4. správa dorazila, ale jej obsah nezodpovedá;
  5. akcia overenia zlyhala;
  6. upratovanie zlyhalo.

Táto klasifikácia mení prechodné „test e‑mailu zlyhal“ na prácu, ktorú môže tím prevziať.

Pre väčšiu testovaciu maticu si prečítajte Skutočný testovací plán e‑mailu. Pre diagnostiku doručenia použite Overovací e‑mail nedorazil: nájdite porušený krok.

GPTMail