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.

Endpoint

GET https://mailao.net/api/get_domains.php

Tham Số

Không yêu cầu tham số đầu vào.

Ví Dụ Yêu Cầu

Gửi yêu cầu GET

https://mailao.net/api/get_domains.php

Đị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).

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 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. API yêu cầu xác thực bảo mật nội bộ, nếu thất bại sẽ trả về mã lỗi 403 với status là false.

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://mailao.net/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à: 987 lần

Ví Dụ Yêu Cầu

Gửi yêu cầu GET

https://mailao.net/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://mailao.net/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://mailao.net/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

Chú ý