Tích hợp MailFlow

Xác thực

Thêm API key vào header của mọi request công khai:

Authorization: Bearer YOUR_API_KEY

/v1/mailboxes

Cấp một Gmail chưa từng được dùng cho dịch vụ chỉ định trên toàn hệ thống.

curl -X POST https://api.rentotps.com/v1/mailboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"instagram"}'

Phản hồi

{
  "success": true,
  "email": "example@gmail.com",
  "token": "transaction_token",
  "expires_in": 600
}

/v1/transactions/check

Kiểm tra xem giao dịch đã nhận được thư hay chưa.

curl -X POST https://api.rentotps.com/v1/transactions/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"transaction_token"}'

/v1/transactions/report-used

Báo Gmail vừa nhận đã được sử dụng cho dịch vụ. IMAP sẽ đóng ngay, Gmail được đánh dấu riêng là reported_used và không tính lượt thành công.

curl -X POST https://api.rentotps.com/v1/transactions/report-used \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"transaction_token"}'

Quy tắc hoạt động

• Token có hiệu lực trong 10 phút.
• Chỉ thư đến sau lúc cấp token mới được chấp nhận.
• Sender có thể là chuỗi như instagram; hệ thống sẽ khớp địa chỉ như noreply@instagram.com.
• Lượt sử dụng chỉ tăng khi nội dung thư được trả thành công.
• Báo email đã dùng không tăng lượt thành công nhưng vẫn khóa cặp Gmail và dịch vụ đó trên toàn hệ thống.
• Một Gmail đã dùng cho một dịch vụ sẽ không được cấp lại cho dịch vụ đó, bất kể người dùng nào gọi API.
• Một thư không được trả trùng ở giao dịch khác.