BYN Integrate API

Email delivery service.

Service này nhận yêu cầu gửi email qua SMTP, lưu email vào queue, xử lý queue theo nhịp an toàn và cung cấp health check để hệ thống bên ngoài giám sát.

Gửi email trực tiếp

Nhận nội dung HTML, CC, BCC và file đính kèm rồi gửi.

Queue email

Lưu email cần gửi để cron hoặc job xử lý sau.

Rate limit khi gửi

Email đầu chờ tối thiểu 1 phút từ lần gửi trước; các email trong queue cách nhau 1.5 phút.

Endpoint

GET /api/health: Kiểm tra service còn hoạt động.
POST /api/mail/send: Gửi email trực tiếp, cần project id và api key.
POST /api/email-queue: Thêm email vào queue, cần project id và api key.
POST /api/email-queue/process: Xử lý email pending trong queue, thường dùng cho cron/job.

Các endpoint gửi mail yêu cầu header x-project-id và x-api-key.