ps

د باور وړ لنډمهاله بکس API خودکار کول

د یکتا پتې، محدود پولنګ، دقیق پیغام سمون، خوندي کلید مدیریت، او ګټور د ناکامۍ شواهدو سره د ټاکلي ثبت او پاسورډ-بیا تنظیم ازموینې جوړ کړئ.

Jul 17, 2026

د بکس د جوړولو، ترلاسه کولو، چک کولو، او پاکولو لپاره یو لنډ خودکار حلقه

د ایمیل ازموینې ناپایدار نسخه لنډه ده: یو پته جوړ کړئ، پنځه ثانیې ویده شئ، لومړی پیغام ولولئ، او هیله وکړئ چې دا د دې چلند پورې اړه ولري.

د باور وړ نسخه لا هم ساده ده، خو تحویل ته غیر همزمان چلند ورکوي. دا یو یکتا پته جوړوي، د پیل وخت ثبتوي، د ټاکلي وخت دننه پولنګ کوي، هدفمند پیغام سره سمون خوري، د محصول عمل تصدیقوي، او کله چې څه ناکام شي کافي زمینه راپور ورکوي.

د API کلید URL نه بهر وساتئ

د GPTMail کلید په X-API-Key سرلیک کې واستوئ. دا په ?api_key= پوښتنې پارامترونو کې مه ایښئ. URLونه په منظم ډول د براوزر تاریخچه، لاسرسي لاګونو، نظارتي سیسټمونو، او ریفرر معلوماتو کې ذخیره کېږي.

X-API-Key: YOUR_API_KEY

کلید په خپل CI پټ مدیریت کې ذخیره کړئ او په لاګونو کې پټ یې کړئ. د عامه ورځني کلید کارول د سپړنې لپاره مناسب دي؛ کنټرول شوي خودکار سوټونه باید داسې کلید وکاروي چې د کوټا او کارونې تعقیب یې کولای شئ.

اوسني پای ټکیان او د ځواب مثالونه په د GPTMail API اسنادو پاڼه کې ساتل کېږي.

هر چلند لپاره یوه پته

د هر خپلواک اجرا کیدونکي ازموینې لپاره نوې پته جوړه کړئ. د ټوله سوټ له شریکه بکس څخه د سمون استنتاج مه کوئ.

پته، سناریو ID، چاپېریال، او د ازموینې پیل وخت ثبت کړئ. دا ارزښتونه تاسو ته اجازه درکوي چې زړې پیغامونه رد کړئ او د ټکرونو تشخیص وکړئ پرته له دې چې د پیغام رازونه لاګ کړئ.

د ټاکلي وخت پر ضد پولنګ وکړئ، نه ثابت خوب

د ایمیل تحویل وخت مختلف وي. ثابت پنځه ثانیې خوب هم کله چې تحویل چټک وي ضایع کېږي او هم کله چې ورو وي ناپایدار.

د محدود حلقې کار واخلئ:

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)

د ټاکلي وخت محدودیت د ازموینې قرارداد دی. د پاسورډ-بیا تنظیم بهیر ممکن د لوی خبرلیک مخکتنې څخه مختلف حد ته اړتیا ولري. حد واضح وساتئ څو سستې انحصارونه په چوپتیا سره د ټول CI کار نه غځوي.

دقیقاً سمون وکړئ

"لومړی پیغام په بکس کې" یو ګټور selector نه دی. څو سیګنالونه سمون کړئ:

  • ترلاسه کوونکی د دې چلند لپاره جوړې شوې پتې سره برابر وي؛
  • د جوړولو وخت د ټریګر وخت نه وروسته وي؛
  • استونکی د تمه شوې خدمت پورې اړه ولري؛
  • موضوع یا د پیغام ډول د جریان سره سمون خوري؛
  • د پیغام ID لا دمخه نه وي کارول شوی.

کله چې استونکی څو کوډونه صادرولی شي، نو نوې ترین سمون لرونکی پیغام وټاکئ. د دې ID د ازموینې خروج کې وساتئ څو بیا هڅې تصادفي ډول یې بیا وکاروي نه شي.

یوازې د لیست سمون وروسته ولولئ

د بکس لیست کول باید د ارزانه کشف ګام وي. بشپړ پیغام یوازې د ټاکل شوي کاندید لپاره واخلئ. دا غیر ضروري کار کموي او د نامرتبطو تبلیغاتي ایمیلونو پارس کول مخنیوی کوي.

د سوداګریزې پایلې تصدیق وکړئ، نه یوازې د شپږ عددي سټرینګ شتون. کوډ وسپارئ یا تمه شوی لینک پرانیزئ، بیا تصدیق کړئ چې حساب سم حالت ته رسیږي.

د نرخ محدودیتونه د سیګنال په توګه اداره کړئ

که API د کوټا یا نرخ-محدودیت ځواب ورکړي، اوسنی هڅه ودروئ او د ریسیټ معلومات ښکاره کړئ. تېز بیا هڅې واضح ظرفیت سیګنال په شور بدلوي او ممکن د نامرتبطو ازموینو ځنډ رامنځته کړي.

په ازموینې چلونکي کې همزماني محدود کړئ، په ځانګړې توګه کله چې سوټ په یو وخت کې ډېرې پتې جوړوي. کوچنی کارګر پول د سلګونو همزمان پولنګ حلقو په پرتله اسانه دیبګ کیدل لري.

د ناکامیو پټولو پرته پاکول

پاکول باید د شواهدو د نیولو وروسته اجرا شي. په بریالیتوب کې، پیغامونه حذف کړئ یا د لنډ ساتنې اجازه ورکړئ. په ناکامۍ کې، پته او د پیغام ID په خوندي CI توکو کې د کافي مودې لپاره وساتئ تر څو پلټنه وشي، بیا یې حذف کړئ.

هیڅکله د تصدیق کوډونه، شخصي لینکونه، یا بشپړ HTML بدنونه په عامه جوړولو لاګونو کې چاپ نه کړئ.

بیا هڅې بې بدله (idempotent) کړئ

ازموینه د نوې پتې سره د نوې چلند په توګه بیا هڅه کړئ. دا فرض مه کوئ چې د هماغه حساب او بکس پر ضد د هماغه غوښتنې تکرار د پاک حالت څخه پیل کېږي. استونکی ممکن زړې کوډونه نا معتبر کړي، تکراري غوښتنې محدود کړي، یا د نقل دعوتونه رد کړي.

که د شبکې غوښتنه وخت پای ته ورسیږي، "هیڅ ځواب نه ترلاسه شو" له "عملیه نه ترسره شوه" څخه جلا کړئ. د تخریبي بیا هڅې څخه مخکې د مشاهدې وړ حالت وګورئ.

د ناکامۍ نقطه راپور کړئ

یوه ګټوره خودکار ناکامي له دې مرحلو څخه یوه پیژني:

  1. د پته جوړول ناکام شو؛
  2. د محصول عمل د ایمیل په قطار کې د شاملېدو مخکې ناکام شو؛
  3. د ټاکلي وخت مخکې هیڅ سمون لرونکی پیغام نه رارسېد؛
  4. پیغام رارسېد خو محتوا سمون نه درلود؛
  5. د تصدیق عمل ناکام شو؛
  6. پاکول ناکام شو.

دا طبقه بندي د موقت "ایمیل ازموینه ناکامه شوه" حالت بدلوي په داسې کار ته چې ټیم یې خپل کړي.

د لویې ازموینې میټریکس لپاره، ولولئ د حقیقي ایمیل ازموینې پلان. د تحویل تشخیص لپاره، وکاروئ د تصدیق ایمیل نه رارسېدل: ماته شوې ګام پیدا کول.

GPTMail