Kiểm tra thời gian thực cho email

POST/v1/realtime/check/email

Kiểm tra đồng bộ một địa chỉ email với một đến mười sản phẩm email thời gian thực. Engine, hợp đồng thanh toán và dạng phản hồi giống hệt endpoint điện thoại; chỉ khác chuỗi và định dạng định danh.

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
identifier	string	Có	Một địa chỉ email, ví dụ user@example.com.
country	string	Không	Phải bỏ qua với email. Gửi mã quốc gia cùng sản phẩm email sẽ bị từ chối.
product_ids	array<int>	Có	Mảng gồm 1 đến 10 ID sản phẩm email thời gian thực.

country phải để trống

Email không có chiều quốc gia. country là tuỳ chọn ở endpoint điện thoại nhưng không được chấp nhận ở đây — request mang trường này sẽ hỏng validation trước khi có bất cứ thứ gì được gửi đi hoặc bị tính phí.

Bắt buộc idempotency

Idempotency-Key là bắt buộc trong mọi lệnh gọi. Thử lại cùng request với cùng key không bị thu hai lần; đổi payload sẽ trả về 409. Xem Idempotency & thử lại.

Chọn sản phẩm

Sản phẩm email và điện thoại thuộc hai chuỗi khác nhau và không thể kết hợp trong một request. Đọc id của mục có mode là realtime và có chuỗi là email từ Sản phẩm thời gian thực, trang này lấy dữ liệu từ GET /v1/products. Truyền slug không bao giờ hoạt động ở đây, và ID sản phẩm điện thoại trong lệnh gọi email sẽ bị từ chối vì chuỗi không khớp.

Ví dụ phản hồi

{
  "request_id": "b7d2a1c4-9f3e-4a1b-8c5d-2e6f7a8b9c0d",
  "identifier": "user@example.com",
  "series": "email",
  "status": "succeeded",
  "request_status": "completed",
  "replayed": false,
  "total_reserved": 0.004000,
  "total_charged": 0.004000,
  "total_refunded": 0.000000,
  "results": [
    {
      "product_id": 49,
      "product": "insemailvalid-rt",
      "result": "valid",
      "cached": false,
      "billing_status": "charged",
      "charged_amount": 0.002000,
      "refunded_amount": 0.000000,
      "checked_at": "2026-09-13T10:00:00Z",
      "error_code": null
    }
  ]
}

Các giá trị product_id ở trên chỉ là ví dụ — hãy xác nhận ID sản phẩm email hiện tại trên Sản phẩm thời gian thực trước khi gửi request thật. request_id là UUID, và cached nằm trong từng kết quả, không ở cấp cao nhất.

Ví dụ cURL

curl -X POST "https://api.zelnum.com/api/v1/realtime/check/email" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"user@example.com","product_ids":[49]}'

Các lỗi riêng của email

HTTP	code	Ý nghĩa
400	invalid_realtime_request	Địa chỉ sai định dạng, country bị gửi kèm, các ID thuộc chuỗi khác, hoặc không có ID nào được cung cấp. Không có gì được gửi đi và không có gì bị tính phí.
400	idempotency_key_required	Thiếu header Idempotency-Key.
402	insufficient_balance	Số dư không đủ cho khoản tạm giữ; không mục nào bắt đầu.
409	request_in_progress / idempotency_conflict	Cùng key, vẫn đang chạy, hoặc cùng key với payload khác.

Các status code còn lại — 401, 403, 429, 503, 500 — hoạt động đúng như tài liệu ở endpoint điện thoại.