zu

Ukuzimela Kwe-API Yokusebenza Nge-Inbox Yesikhashana

Yakha ukuhlolwa kokubhalisa nokusetha kabusha iphasiwedi okungaguquki ngokusebenzisa amakheli ayingqayizivele, ukuhluza okulinganiselwe, ukuhambisana kwemiyalezo ngokunembile, ukuphatha okhiye ngokuphephile, kanye nobufakazi obuwusizo bokuhluleka.

Jul 17, 2026

Umjikelezo omfushane wokuzisebenzela wokukhiqiza, ukuthola, ukuhlola, nokuhlanza ibhokisi le-imeyili

Uhlelo olungathembekile lokuhlola i-imeyili lufushane: dala ikheli, lalela imizuzwana emihlanu, funda umyalezo wokuqala, bese uthemba ukuthi uhlobene nalokhu kuqhuba.

Uhlelo oluthembekile lusasebenza kalula, kodwa luthatha ukulethwa njengokungahambisani. Ludala ikheli eliyingqayizivele, libhala isikhathi sokuqala, luhlola ngaphakathi kwesikhathi esinqunyiwe, luhambisana nomyalezo ohlosiwe, liqinisekisa isenzo somkhiqizo, futhi libika umongo owanele uma kukhona okuhlulekile.

Gcina ukhiye we-API ngaphandle kwe-URL

Thumela ukhiye we-GPTMail ku-X-API-Key header. Ungawufaki ku-?api_key= ezicelweni zemibuzo. Ama-URL agcinwa njalo kumlando wesiphequluli, ama-log wokufinyelela, izinhlelo zokubheka, kanye nedatha yabathumeli.

X-API-Key: YOUR_API_KEY

Gcina ukhiye kumphathi wakho wemfihlo we-CI futhi uwafihle kumalogi. Ukhiye womphakathi wansuku zonke ulula ekucwaningeni; ama-suite okuzenzakalela alawulwayo kufanele asebenzise ukhiye onomkhawulo nokusetshenziswa ongakulandela.

Amaphuzu wokuphela namasampula wempendulo akhona agcinwa ekhasini le-ikhasi le-GPTMail API documentation.

Ikheli elilodwa ngalinye ukuqhuba

Dala ikheli elisha kuwo wonke umkhiqizo wokuhlola ongazimele. Ungathathi ukunemba kusuka ebhokisini le-imeyili elabelwe i-suite yonke yokuhlola.

Bhala ikheli, i-ID yesimo, indawo, nesikhathi sokuqala sokuhlola. Lezi zilinganiso zikuvumela ukuthi wenqabe imiyalezo endala futhi ubone ukushayisana ngaphandle kokuloga imfihlo yomlayezo.

Hlola ngaphakathi kwesikhathi esinqunyiwe, hhayi ukulala okungashintshi

Isikhathi sokulethwa kwe-imeyili siyahluka. Ukulala imizuzwana emihlanu okungashintshi kuyachitha uma ukulethwa kusheshayo futhi kuyaphazamiseka uma kucotha.

Sebenzisa umjikelezo onomkhawulo:

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)

Isikhathi esinqunyiwe siyinxenye yesivumelwano sokuhlola. Ukuhamba kokusetha kabusha iphasiwedi kungadinga umkhawulo ohlukile kunokubuka kwenewsletter enkulu. Gcina umkhawulo ucacile ukuze ukuncika okucothayo kungandleni isikhathi sonke somsebenzi we-CI.

Hambisa ngokunembile

“Umyalezo wokuqala ebhokisini le-imeyili” akusiyo inkomba ewusizo. Hambisa izimpawu eziningana:

  • umamukeli ulingana nekheli elidalwe kulokhu kuqhuba;
  • isikhathi sokudala sibe sesiphakade kunesikhathi sokuvula;
  • umthumeli ungowesevisi elindelekile;
  • isihloko noma uhlobo lomlayezo luhambisana nokuhamba;
  • i-ID yomlayezo ayikathathiwe kakade.

Uma umthumeli ekwazi ukuhlinzeka amakhodi amaningi, khetha umyalezo omusha ohambisanayo. Gcina i-ID yawo ekuphumeni kokuhlola ukuze ama-retry angawasebenzisi ngokungahlosile.

Funda kuphela ngemva kokuhambisana koluhlu

Ukubhalisa ibhokisi le-imeyili kufanele kube isinyathelo esishibhile sokuthola. Landa umyalezo ophelele kuphela kumfakisicelo okhethiwe. Lokhu kwehlisa umsebenzi ongadingekile futhi kugwema ukuhlaziya i-imeyili yokukhangisa engahlangene.

Qinisekisa umphumela webhizinisi, hhayi nje ubukhona bezinhlamvu ezinezinombolo ezingu-6. Thumela ikhodi noma uvule isixhumanisi esilindelekile, bese uqinisekisa ukuthi i-akhawunti ifinyelela esimweni esifanele.

Phatha imikhawulo yokusheshisa njengophawu

Uma i-API ibuyisela impendulo yomkhawulo noma ye-rate-limit, yeka umzamo wamanje futhi uveze ulwazi lokusetha kabusha. Ama-retry anokushesha adala uphawu lokusebenza olucacile lube umsindo futhi kungabambezela ukuhlola okungahlangene.

Nciphisa ubuningi bokusebenza kumgijimi wokuhlola, ikakhulukazi uma i-suite idala amakheli amaningi ngesikhathi esisodwa. Iphuli elincane labasebenzi kulula ukulixazulula kunamakhulu ama-loop okuhlola ngasikhathi sinye.

Hlanza ngaphandle kokufihla ukwehluleka

Ukucoca kufanele kwenziwe ngemva kokuthatha ubufakazi. Ngokuphumelela, susa imiyalezo noma uvumele isikhathi esifushane sokugcina sikwazi ukuwaphatha. Ngokwehluleka, gcina ikheli ne-ID yomlayezo ezinhlelweni ezivikelwe ze-CI isikhathi esanele sokuphenya, bese uzisusa.

Ungalokothi uphrinte amakhodi okuqinisekisa, izixhumanisi ezizimele, noma imizimba ye-HTML ephelele kumalogi womsebenzi avulekile.

Yenza ama-retry abe yi-idempotent

Phinda ukuhlola njengokusebenza okusha ngekheli elisha. Ungacabangi ukuthi ukuphinda isicelo esifanayo ku-akhawunti efanayo nebhoskisi le-imeyili kuqala kusuka esimweni esihlanzekile. Umthumeli angase avimbe amakhodi amadala, anciphise izicelo eziphindaphindiwe, noma alahle izimemo eziphindaphindiwe.

Uma isicelo senethiwekhi siphela isikhathi, hlukanisa “akukho impendulo etholiwe” kusuka “ukusebenza akwenziwanga.” Bheka isimo esibonakalayo ngaphambi kokwenza i-retry ebhubhisayo.

Bika indawo yokwehluleka

Ukwehluleka kokuzisebenzela okuwusizo kubona esinye salezi zinyathelo:

  1. ukukhiqizwa kwekheli kuhlulekile;
  2. isenzo somkhiqizo kuhlulekile ngaphambi kokuthi i-imeyili ifakwe ku-queue;
  3. akukho myalezo ohambisanayo ofikile ngaphambi kwesikhathi esinqunyiwe;
  4. umyalezo ufikile kodwa okuqukethwe akuhambisani;
  5. isenzo sokuqinisekisa kuhlulekile;
  6. ukuhlanza kuhlulekile.

Lokhu ukuhlukanisa kushintsha i-“email test failed” engapheliyo ibe umsebenzi ongabanikazi beqembu.

Ukuthola i-matrix enkulu yokuhlola, funda Uhlelo Lweqiniso Lokuhlola I-imeyili. Ukuze ubone isizathu sokulethwa, sebenzisa I-imeyili Yokuqinisekisa Engafiki: Thola Isinyathelo Esiphukile.

GPTMail