مرجع API
همهی اندپوینتهایی که با کلید API میتوانید فراخوانی کنید، برگرفته از سند OpenAPI در MailLand.
این مرجع همهی اندپوینتهایی را فهرست میکند که یک یکپارچهسازی میتواند با کلید API فراخوانی کند. این فهرست از سند OpenAPI خودِ API ساخته میشود و فقط اندپوینتهایی را نگه میدارد که کلید API را میپذیرند. اندپوینتهای خودِ پنل مشتری (ورود، حساب، تیم، صورتحساب) بخشی از API عمومی نیستند و اینجا نیامدهاند. توضیح هر اندپوینت به انگلیسی است.
آدرس پایه و احراز هویت
همهی درخواستها به https://api.mail.land فرستاده میشوند و کلید شما را در سرآیند X-API-Key دارند:
curl https://api.mail.land/v1/transactional/send \
-H "X-API-Key: ml_pet_..." \
-H "Content-Type: application/json" \
-d '{"from":{"email":"[email protected]"},"to":[{"email":"[email protected]"}],"subject":"Hello","htmlContent":"<p>Hello</p>"}'کلیدهای ارسالِ محیط عملیاتی با ml_pet_ (تراکنشی) یا ml_pem_ (بازاریابی) شروع میشوند. کلیدهای sandbox با ml_set_ یا ml_sem_، کلیدهای دریافت با ml_pi_ و کلیدهای اعتبارسنجی با ml_pv_ شروع میشوند. کلیدهای API را ببینید.
کلید API را هرگز بهصورت Authorization: Bearer نفرستید و هرگز آن را در کدی که در مرورگر اجرا میشود قرار ندهید.
بخشها
ارسال
ارسال، ارسال گروهی، ارسال زمانبندیشده، گزارش ایمیلها، پیگیریها.
قالبها
قالبها و نسخههای آنها.
دامنهها
دامنههای ارسال و رکوردهای DNS آنها.
فهرست عدم ارسال و بازگشتها
فهرست عدم ارسال و ایمیلهای بازگشتی.
وبهوکها
اندپوینتهای وبهوک و تحویلها.
ایمیل ورودی
دامنههای ورودی، مسیرها و پیامها.
تحلیل و تحویلپذیری
آمار و گزارشهای تحویلپذیری.
اعتبارسنجی ایمیل
اعتبارسنجی تکی و گروهی.
بازاریابی
فهرستها، مشترکان، بخشها، کمپینها، اتوماسیونها.
خطاها و محدودیتها برای همهی اندپوینتها برقرارند: کدهای خطا و محدودیتهای نرخ را ببینید. تعهد سازگاری /v1 در سازگاری API آمده است.