MailScope API

API v1Tài liệu tích hợp

Đưa khả năng phân loại Gmail vào ứng dụng của bạn.

Gửi chuỗi dữ liệu ở bất kỳ định dạng nào. MailScope tự lọc Gmail, bỏ trùng, giữ nguyên dòng nguồn và trả kết quả JSON có cấu trúc.

POST/api/v1/check

Bắt đầu nhanh

API dùng HTTPS và JSON. Mỗi yêu cầu hỗ trợ tối đa 5.000 địa chỉ Gmail sau khi lọc và bỏ trùng.

→

Khuyên dùng từ máy chủ đến máy chủ.
Không đặt API key trong JavaScript công khai, ứng dụng di động chưa bảo vệ hoặc kho mã nguồn công cộng.

Xác thực

Gửi key trong header của mọi yêu cầu kiểm tra:

X-API-Key: YOUR_API_KEY

Giữ kín API key.
Quản trị viên cấp key riêng. Tài liệu công khai không hiển thị và không lưu key bạn nhập ở phần thử API.

Dữ liệu gửi lên

Body phải có Content-Type: application/json.

inputBắt buộc

Chuỗi hoặc mảng chuỗi. Có thể chứa email, mật khẩu, ký tự phân cách hoặc dữ liệu khác; hệ thống chỉ lọc địa chỉ Gmail để kiểm tra.

fastTùy chọn

Boolean, mặc định true. Đặt false để dùng SMTP và tách Verify / Disabled chính xác hơn.

dataTên thay thế

Có thể dùng thay cho input để tương thích với hệ thống cũ.

Ví dụ tích hợp

Chọn ngôn ngữ rồi copy mẫu vào dự án của bạn.

Kết quả JSON

Phần summary dùng để thống kê nhanh; results chứa từng dòng đã phân loại.

emailĐịa chỉ Gmail đã chuẩn hóa.

sourceNguyên dòng đầu vào chứa email, gồm cả dữ liệu đi kèm.

status / labelMã nội bộ ổn định và nhãn dễ hiển thị.

detailPhản hồi SMTP hoặc nguyên nhân lỗi, có thể để trống.

{
  "success": true,
  "mode": "fast",
  "total": 1,
  "summary": {
    "live": 1,
    "verify": 0,
    "disabled": 0,
    "unresolved": 0,
    "error": 0
  },
  "results": [{
    "email": "demo@gmail.com",
    "source": "demo@gmail.com|password|recovery@example.com",
    "status": "GOOD",
    "label": "LIVE",
    "detail": ""
  }]
}

Trạng thái

Dùng trường status cho logic chương trình và label để hiển thị.

GOOD

Địa chỉ được Google PeopleStack xác nhận.

VERIFY

Cần xác minh thêm hoặc SMTP chấp nhận địa chỉ.

DISABLE

Hộp thư bị vô hiệu hóa.

NON_EXISTS

Không có bản ghi tương ứng; nhãn trả về là DISABLED.

UNRESOLVED

Chưa thể kết luận do SMTP hoặc đường mạng.

FAILED

Lỗi khi gọi dịch vụ hoặc xử lý địa chỉ.

Thử API

Yêu cầu được gửi trực tiếp tới tên miền này. API key chỉ tồn tại trong ô nhập cho đến khi bạn đóng hoặc tải lại trang.

API keyDữ liệu đầu vào

Fast check

Kết quả sẽ xuất hiện tại đây.

Mã lỗi HTTP

Lỗi luôn có dạng {"success": false, "error": {"code": "...", "message": "..."}}.

HTTP	Ý nghĩa
400	JSON hoặc dữ liệu đầu vào không hợp lệ.
401	Thiếu hoặc sai API key.
409	Một lượt check khác đang chạy; chờ rồi gửi lại.
413 / 415	Body quá lớn hoặc sai Content-Type.
429	Vượt giới hạn 20 yêu cầu trong 60 giây trên mỗi IP.
503	Phiên Google chưa sẵn sàng hoặc đã hết hạn.