Etibarlı Müvəqqəti-Poçt Qutusu API Avtomatlaşdırması

E‑poçt testinin etibarsız versiyası qısadır: bir ünvan yaradın, beş saniyə gözləyin, ilk mesajı oxuyun və onun bu icraata aid olmasını ümid edin.

Etibarlı versiya hələ də sadədir, lakin çatdırmanı asinxron kimi qəbul edir. O, unikal bir ünvan yaradır, başlanğıc vaxtını qeyd edir, son tarix daxilində sorğulama aparır, nəzərdə tutulan mesajı uyğunlaşdırır, məhsul əməliyyatını təsdiqləyir və bir şey səhv olduqda kifayət qədər kontekst təqdim edir.

API açarını URL‑dən çıxarın

GPTMail açarını X-API-Key başlığında göndərin. ?api_key= sorğu parametrlərində yerləşdirməyin. URL‑lər tez-tez brauzer tarixçəsində, giriş jurnallarında, monitorinq sistemlərində və yönləndirən məlumatlarda saxlanılır.

X-API-Key: YOUR_API_KEY

Açarı CI gizli menecerinizdə saxlayın və jurnallarda maskalayın. İctimai gündəlik açar araşdırma üçün rahatdır; nəzarət olunan avtomatlaşdırılmış dəstlər isə kvotası və istifadəsi izlənilə bilən açardan istifadə etməlidir.

Cari son nöqtələr və cavab nümunələri GPTMail API sənədləşdirmə səhifəsində saxlanılır.

Hər icra üçün bir ünvan

Hər müstəqil icra edilə bilən test üçün yeni ünvan yaradın. Bütün test dəsti tərəfindən paylaşılan bir poçt qutusundan düzgünlüyü çıxarmağa çalışmayın.

Ünvanı, ssenari ID‑ni, mühiti və testin başlanğıc vaxtını qeyd edin. Bu dəyərlər köhnəlmiş mesajları rədd etməyə və mesaj məxfiliklərini jurnal etmədən toqquşmaları diaqnoz etməyə imkan verir.

Sabit gözləmə yerinə son tarixə qarşı sorğulama edin

E‑poçt çatdırılma vaxtı dəyişkəndir. Sabit beş saniyə gözləmə çatdırılma sürətli olduqda israf, yavaş olduqda isə etibarsızdır.

Məhdud döngüdən istifadə edin:

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)

Son tarix test müqaviləsinə aiddir. Şifrə sıfırlama axını toplu xəbər bülleteni ön baxışından fərqli limit tələb edə bilər. Limiti aydın saxlayın ki, yavaş asılılıq bütün CI işini səssizcə uzatmasın.

Dəqiq uyğunlaşdırın

“Poçt qutusundakı ilk mesaj” faydalı seçimçi deyil. Bir neçə siqnala uyğunlaşın:

• alıcı bu icra üçün yaradılan ünvana bərabərdir;
• yaradılma vaxtı tetikleme vaxtından sonra olur;
• göndərən gözlənilən xidmətə aiddir;
• mövzu və ya mesaj növü axına uyğun gəlir;
• mesaj ID‑si artıq istifadə edilməyib.

Göndərən bir neçə kod verə bilirsə, ən yeni uyğun mesajı seçin. Onun ID‑sini test çıxışında saxlayın ki, təkrar cəhdlər təsadüfən onu yenidən istifadə etməsin.

Siyahı uyğunluğundan sonra yalnız oxuyun

Poçt qutusu siyahısı ucuz kəşf addımı olmalıdır. Tam mesajı yalnız seçilmiş namizəd üçün alın. Bu lazımsız işi azaldır və əlaqəsiz reklam poçtunun təhlilindən qaçınır.

Biznes nəticəsini təsdiqləyin, yalnız altı rəqəmli sətirin mövcudluğunu yox. Kodu təqdim edin və ya gözlənilən linki açın, sonra hesabın doğru vəziyyətə çatdığını təsdiqləyin.

Sürət limitlərini siqnal kimi idarə edin

API kvota və ya sürət‑limiti cavabı verərsə, cari cəhdi dayandırın və sıfırlama məlumatını göstərin. Həddindən artıq təkrar cəhdlər aydın tutum siqnalını səs‑küyə çevirir və əlaqəsiz testləri gecikdirə bilər.

Test icraçısında paralellik sayını məhdudlaşdırın, xüsusən də dəst bir anda çoxlu ünvanlar yaradırsa. Kiçik işçi hovuzu yüzlərlə eyni anda sorğulama döngüsündən daha asan debug edilə bilər.

Uğursuzluqları gizlətmədən təmizləyin

Təmizləmə sübutlar toplandıqdan sonra işləməlidir. Uğur halında mesajları silin və ya qısa saxlanma ilə idarə edin. Uğursuzluqda ünvanı və mesaj ID‑ni qorunan CI artefaktlarında kifayət qədər müddət saxlayın, sonra silin.

Heç vaxt təsdiqləmə kodlarını, şəxsi linkləri və ya tam HTML məzmununu ictimai tikinti jurnallarına çap etməyin.

Təkrar cəhdləri idempotent edin

Testi yeni ünvanla yeni icra kimi təkrar edin. Eyni hesab və poçt qutusu üzərində eyni sorğunu təkrarlamağın təmiz vəziyyətdən başladığını düşünməyin. Göndərən köhnə kodları etibarsız edə, təkrar sorğuları məhdudlaşdıra və ya təkrarlanan dəvətləri rədd edə bilər.

Şəbəkə sorğusu vaxt aşımına düşərsə, “cavab alınmadı” ilə “əməliyyat baş vermədi” arasındakı fərqi ayırın. Zərərli təkrar cəhd etməzdən əvvəl görünən vəziyyəti yoxlayın.

Uğursuzluq nöqtəsini bildirin

Faydalı avtomatlaşdırma uğursuzluğu bu mərhələlərdən birini müəyyən edir:

1. ünvan yaradılması uğursuz oldu;
2. məhsul əməliyyatı e‑poçt növbəyə alınmadan əvvəl uğursuz oldu;
3. son tarixdən əvvəl uyğun mesaj gəlmədi;
4. mesaj gəldi, lakin məzmun uyğun gəlmədi;
5. təsdiqləmə əməliyyatı uğursuz oldu;
6. təmizləmə uğursuz oldu.

Bu təsnifat aralıq “e‑poçt testi uğursuz oldu” mesajını komandanın üzərinə götürə biləcəyi işə çevirir.

Daha geniş test matrisası üçün Real Email Test Plan məqaləsini oxuyun. Çatdırılma diaqnozu üçün isə Təsdiq E-poçtu Gəlmir: Pozulmuş Addımı Tapın istifadə edin.