Tài liệu API gửi

Một API để gửi email đăng ký, đặt lại mật khẩu và thông báo từ website — không cần SMTP.

Lấy khóa API

Hiện có sẵn Quyền sở hữu, MX, SPF, DKIM và DMARC được xác minh riêng. Khi sẵn sàng, gửi bằng khóa API và theo dõi trên bảng điều khiển kết quả theo người nhận: đã gửi, thất bại, đang xử lý.

Bắt đầu nhanh

  1. 1

    Gắn tên miền

    Thêm tên miền gửi trong Gửi cho website.

  2. 2

    Xác minh DNS

    Thêm bản ghi SPF / DKIM / DMARC và TXT xác minh, rồi xác minh một chạm.

  3. 3

    Tạo khóa

    Tạo khóa te_live_ — văn bản chỉ hiện một lần, hãy lưu ngay.

Gửi email

Yêu cầu POST với khóa te_live_ trong header Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Trường yêu cầu

from Địa chỉ người gửi, phải thuộc tên miền đã xác minh
to Địa chỉ người nhận (đơn hoặc mảng)
subject Chủ đề email
html / text Nội dung email (HTML hoặc văn bản thuần)
Idempotency-Key Header tùy chọn; dùng lại giá trị khi thử lại để tránh gửi trùng

Yêu cầu được chấp nhận trả HTTP 202 với id và trạng thái accepted. Với cùng khóa, GET /api/sending/messages/{id} trả kết quả theo người nhận: đã gửi, thất bại, đang chờ hoặc không rõ.

Lỗi & giới hạn

401 Khóa không hợp lệ hoặc đã thu hồi — tạo lại khóa te_live_
403 Tên miền người gửi chưa xác minh, hoặc địa chỉ không thuộc tên miền đã xác minh
429 Vượt tốc độ gửi; phản hồi kèm retry_after — thử lại sau theo hướng dẫn
503 Bộ máy email tạm thời không khả dụng; thử lại với cùng Idempotency-Key

Số người nhận, kích thước nội dung và tốc độ đều có giới hạn bảo vệ. Chỉ tính sau khi xác thực nên yêu cầu không hợp lệ không tiêu tốn hạn mức.

Sẵn sàng tích hợp?

Lấy khóa API Xem câu hỏi thường gặp