Kalo te dokumentacioni
Baza e njohurive

API e emailit

Dërgoni një mesazh ose njëqind për thirrje, tani ose më vonë, dhe riprovoni pa dërguar dy herë.

Hollësi

  • POST /emails dërgon një mesazh dhe POST /emails/batch deri në 100 të pavarur. Një grup nuk është kurrë gjithçka ose asgjë: një adresë e gabuar te elementi 7 dështon elementin 7, të tjerët nisen gjithsesi dhe përgjigjja raporton për çdo element më vete.
  • Përmbajtja vjen nga një burim i vetëm: html dhe/ose text, një shabllon i ruajtur sipas id-së ose slug-ut (fiksoni versionin kur teksti është i dikujt tjetër) ose një draft ekzistues. Deri në 10 etiketa shoqërojnë mesazhin dhe kthehen në çdo lexim.
  • scheduledAt e mban një mesazh deri në 365 ditë, si çast ISO 8601 ose kohëzgjatje si PT1H. cancellableForSeconds i jep një dërgimi të menjëhershëm dritare zhbërjeje deri në 900 sekonda. Të dyja mund të anulohen, dhe një dërgim i planifikuar të riplanifikohet, derisa të niset.
  • Çdo dërgim mbart një Idempotency-Key që rezervohet para se të nisë gjë, ndaj një riprovë pas skadimit të kohës kthen rezultatin e parë me Idempotency-Replayed: true. I njëjti çelës me përmbajtje tjetër refuzohet si idempotency_key_reuse.
  • Çdo dërgim ka një id msg_ që nga çasti kur pranohet. GET /emails/{id} e lexon, /events jep gjurmën për çdo marrës dhe /tracking hapjet e klikimet.
  • Shtoni translate dhe mesazhi dorëzohet në gjuhën e marrësit. Përkthehet kur pranohet kërkesa, ndaj një dërgim i planifikuar mbart tekstin që miratuat, dhe një përkthim që nuk mund të bëhet e refuzon dërgimin në vend që të kthehet te origjinali.
  • Bashkëngjitjet: deri në 20 skedarë, të ngulitur gjithsej deri në 5 MB. Një skedar më i madh dërgohet duke treguar id-në e një skedari të hapësirës së punës dhe udhëton si lidhje shkarkimi.
  • Çfarë mungon: ende nuk ka modalitet testimi, ndaj çdo çelës dorëzon vërtet, dhe rreshti i dërgimit nuk ka gjendje kthimi. Një kthim etiketohet te biseda dhe ngrihet si webhook email.bounced, ndërsa GET /emails vazhdon të tregojë sent.
  • Lista e ndalimit, Adresat e bllokuara te Cilësimet, gjendet edhe në API. GET /suppressions e lexon me një kërkim dhe një filtër sipas arsyes, POST /suppressions bllokon një adresë me dorë dhe DELETE /suppressions/{id} e lejon sërish një adresë, përveç një kthimi të përhershëm, që mbetet. SDK-ja dhe serveri MCP bëjnë të njëjtën gjë, dhe çdo ndryshim nis webhook-un suppression.added ose suppression.removed.