فهرست و دریافت

GET /emails، تازه‌ترین اول. با status (جداشده با کاما) و from فیلتر کنید. صفحه‌بندی کلیدمبناست، نه offsetی: همان nextCursor را که به شما داده شده پس بفرستید. صفحه‌بندی offsetی وقتی همین‌طور که صفحه می‌زنید پیام‌های تازه می‌رسند، بی‌سروصدا از روی ردیف‌ها می‌پرد.

{ "object": "list", "data": [ … ], "hasMore": true, "nextCursor": "msg_01j8…" }

ردیفی که ردیابی شده، یک شیء فشردهٔ tracking هم با خود دارد: opens، clicks، opened، clicked، openCount، clickCount، firstOpenAt. ردیفی که ردیابی نشده اصلاً کلید tracking ندارد: openCount: 0 روی پیامی که هرگز پیکسلی نداشته یعنی «کسی بازش نکرد»، و این ادعایی است که ما در جایگاه گفتنش نیستیم.

GET /emails/{id} پیام را با وضعیت تحویل به‌ازای هر گیرنده برمی‌گرداند، و گزارش کاملِ ردیابی را به‌جای خلاصهٔ فهرست، چون یک دریافت از پسِ تفکیک به‌ازای هر گیرنده و پیوندها برمی‌آید. شناسه‌ای که وجود ندارد 404 می‌گیرد، نه موفقیتی ساختگی.

GET /emails/{id}/events رد پیام را برمی‌گرداند، قدیمی‌ترین اول: email.accepted، email.queued، email.scheduled، email.sent، email.failed، email.cancelled، email.rescheduled، و روی یک پیام ردیابی‌شده، email.opened، email.clicked و email.downloaded همین‌طور که رخ می‌دهند. برای اینکه به شما گفته شود به‌جای آنکه نظرسنجی کنید، یک webhook ثبت کنید.