Hướng Dẫn API - Lấy Danh Sách mail

Lấy Danh Sách Domain

API này cho phép bạn lấy danh sách các domain hợp lệ đã được cấu hình MX records phù hợp với server hiện tại. Nếu sử dụng tham số api, bạn có thể lấy danh sách domain riêng tư của tài khoản.

Endpoint

GET https://mail.theloi.io.vn/api/get_domains.php

Tham Số

api (tùy chọn): API Key của tài khoản để lấy danh sách domain riêng tư. Ví dụ: 21e30177f39325eb8ee0f1ed5a94987b. Nếu không cung cấp, API sẽ trả về danh sách domain công khai.

Ví Dụ Yêu Cầu

Gửi yêu cầu GET để lấy danh sách domain riêng tư:

https://mail.theloi.io.vn/api/get_domains.php?api=21e30177f39325eb8ee0f1ed5a94987b

Định Dạng Phản Hồi

API trả về dữ liệu dạng JSON với các trường sau:

status: Trạng thái yêu cầu (boolean: true nếu thành công, false nếu thất bại).
message: Thông báo kết quả (chuỗi).
data: Mảng chứa danh sách các domain hợp lệ (chuỗi). Nếu sử dụng api, trả về domain riêng tư của tài khoản.

Ví Dụ Phản Hồi

Phản hồi khi lấy danh sách domain công khai:

    {
        "status": true,
        "user": null,
        "message": "Lấy danh sách domain thành công",
        "data": [{
            "domain": "example.com",
            "date": "2025-04-09",
            "expiration": "2025-09-20"
        }]
    }

Lưu ý: Nếu không có domain hợp lệ nào, data sẽ là mảng rỗng. Nếu api không hợp lệ, API sẽ trả về mã lỗi 403 với status là false và message là thông báo lỗi (ví dụ: "API Key không hợp lệ").

Thông Tin API

API này cho phép bạn lấy danh sách mail dựa trên địa chỉ mail đích (to_field). Dữ liệu trả về bao gồm thông tin mail và mã số (nếu có) được trích xuất từ tiêu đề hoặc nội dung mail.

Endpoint

GET https://mail.theloi.io.vn/api/get_mail.php

Tham Số

email (bắt buộc): Địa chỉ mail đích để lọc danh sách mail. Ví dụ: user@example.com
apikey (bắt buộc): Sử dụng Apikey Free: 21e30177f39325eb8ee0f1ed5a94987b Tổng số lượt Request còn lại trong ngày là: 383 lần
hour (tùy chọn): Giới hạn email được trả về trong số giờ gần nhất. Ví dụ: hour=1 để lấy email trong 1 giờ gần nhất.
day (tùy chọn): Giới hạn email được trả về trong số ngày gần nhất. Ví dụ: day=1 để lấy email trong 1 ngày gần nhất.

Lưu ý: Nếu cả hour và day đều được cung cấp, API sẽ ưu tiên hour. Nếu không cung cấp, API sẽ trả về 10 email mới nhất.

Ví Dụ Yêu Cầu

Gửi yêu cầu GET

https://mail.theloi.io.vn/api/get_mail.php?apikey=21e30177f39325eb8ee0f1ed5a94987b&email=user@example.com

Định Dạng Phản Hồi

API trả về dữ liệu dạng JSON với các trường sau:

status: Trạng thái yêu cầu (boolean: true nếu thành công, false nếu thất bại).
message: Thông báo kết quả (chuỗi).
data: Mảng chứa danh sách mail, mỗi mail bao gồm:
- uid: ID duy nhất của mail (chuỗi UUID).
- subject: Tiêu đề mail.
- from_field: Địa chỉ mail người gửi.
- date: Thời gian nhận mail (định dạng YYYY-MM-DD HH:MM:SS).
- html_content: Nội dung mail dạng HTML.
- status: Trạng thái mail (ví dụ: unseen).
- code: Code 5-8 số được trích xuất từ tiêu đề hoặc nội dung.

Mỗi 1 lần Request thành công kết quả status: true. Tổng số lần request sẽ giảm đi 1.

Ví Dụ Phản Hồi

API trả về dữ liệu dạng JSON như sau:

{
    "status": true,
    "message": "Lấy danh sách email thành công",
    "data": [
        {
            "uid": "da1398df-0719-41a9-96db-6e3ca418c0ab",
            "subject": "456",
            "from_field": "theloi194@gmail.com",
            "date": "2025-04-04 17:05:28",
            "html_content": "<!DOCTYPE HTML PUBLIC \"-\/\/W3C\/\/DTD HTML...",
            "status": "unseen",
            "code": "35976135"
        },
        {
            "uid": "09f6e3af-2751-4396-bbec-ce8f140d5771",
            "subject": "123",
            "from_field": "theloi194@gmail.com",
            "date": "2025-04-04 17:05:16",
            "html_content": "<!DOCTYPE HTML PUBLIC \"-\/\/W3C\/\/DTD HTML...",
            "status": "unseen",
            "code": "543684"
        }
    ]
    "remaining_requests": 994
}

Lưu ý: Nội dung html_content đã được rút gọn trong ví dụ. Dữ liệu thực tế sẽ bao gồm toàn bộ HTML của mail. Nếu không có mail nào, data sẽ là mảng rỗng và status sẽ là false.

Sử Dụng API với C#

Ví dụ sử dụng HttpClient trong C# để gọi API và trích xuất mã số:

using Newtonsoft.Json.Linq;

class Program
{
    static async Task Main()
    {
        var email = "user@example.com";
        var apikey = "21e30177f39325eb8ee0f1ed5a94987b";
        var client = new HttpClient();
        var response = await client.GetStringAsync("https://mail.theloi.io.vn/api/get_mail.php?apikey=" + apikey + "&email=" + email);
        var jsonResponse = JObject.Parse(response);

        if (jsonResponse["Status"].Value<bool>())
        {
            var latestEmail = jsonResponse["Data"][0];
            var code = latestEmail["Code"];
            Console.WriteLine("Mã số của thư mới nhất: " + code);
        }
        else
        {
            Console.WriteLine("Lỗi: " + jsonResponse["Message"]);
        }
    }
}

Dữ liệu JSON được truy xuất và mã số code được in ra console nếu yêu cầu thành công.

Lưu ý: Đảm bảo bạn đã cài đặt gói Newtonsoft.Json. Bạn có thể cài đặt qua NuGet bằng lệnh: dotnet add package Newtonsoft.Json.

Sử Dụng API với Python

Ví dụ sử dụng requests trong Python để gọi API và trích xuất mã số:

import requests

email = "user@example.com"
apikey = "21e30177f39325eb8ee0f1ed5a94987b"
response = requests.get(f"https://mail.theloi.io.vn/api/get_mail.php?apikey={apikey}&email={email}")
data = response.json()

if data["status"]:
    latest_mail = data["data"][0]
    code = latest_mail["code"]
    print(f"Mã số của thư mới nhất: {code}")
else:
    print(f"Lỗi: {data['message']}")

Dữ liệu JSON được truy xuất và mã số code được in ra dưới dạng danh sách nếu yêu cầu thành công.

Lưu ý: Đảm bảo bạn đã cài đặt thư viện requests. Bạn có thể cài đặt qua pip bằng lệnh: pip install requests.

Hướng Dẫn API - Lấy Danh Sách, Đọc Mail

Lấy Danh Sách Domain

Endpoint

Tham Số

Ví Dụ Yêu Cầu

Định Dạng Phản Hồi

Ví Dụ Phản Hồi

Thông Tin API

Endpoint

Tham Số

Ví Dụ Yêu Cầu

Định Dạng Phản Hồi

Ví Dụ Phản Hồi

Sử Dụng API với C#

Sử Dụng API với Python

Thông báo