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

Fetch Domain List

This API allows you to fetch the list of valid domains configured with MX records matching the current server. If the api parameter is used, you can retrieve the private domains of the account.

Endpoint

GET https://vndya.com/api/get_domains.php

Parameters

api (optional): Account API Key to fetch private domain list. Example: . If not provided, the API returns the public domain list.

Request Example

Request Example GET:

https://vndya.com/api/get_domains.php?api=

Response Format

The API returns data in JSON format with the following fields:

status: Request status (boolean: true for success, false for failure).
message: Result message (string).
data: Array containing the list of valid domains (strings). If api is used, returns the account’s private domains.

Response Example

Response when fetching the public domain list.:

    {
        "status": true,
        "user": null,
        "message": "Successfully fetched domain list",
        "data": [{
            "domain": "example.com",
            "date": "2025-04-09",
            "expiration": "2025-09-20"
        }]
    }

Note: If no valid domains are available, data will be an empty array. If api is invalid, the API will return a 403 error with status as false and message as an error message (e.g., "Invalid API Key").

API Information

This API allows you to fetch a list of emails based on the destination email address (to_field). The returned data includes email information and codes (if any) extracted from the subject or content.

GET https://vndya.com/api/get_mail.php

Parameters

email (required): Destination email address to filter the email list. Example: user@example.com
apikey (required): Use the free API key: 21e30177f39325eb8ee0f1ed5a94987b Total remaining requests for the day: requests
hour (optional): Limit emails returned to the most recent hours. Example: hour=1 to fetch emails from the last hour.
day (optional): Limit emails returned to the most recent days. Example: day=1 to fetch emails from the last day.

Note: If both hour and day are provided, the API prioritizes hour. If neither is provided, the API returns the 10 most recent emails.

Request Example

Request Example GET:

https://vndya.com/api/get_mail.php?apikey=21e30177f39325eb8ee0f1ed5a94987b&email=user@example.com

Response Format

The API returns data in JSON format with the following fields:

status: Request status (boolean: true for success, false for failure).
message: Result message (string).
data: Array containing the list of emails, each email includes:
- uid: Unique ID of the email (UUID string).
- subject: Email subject.
- from_field: Sender’s email address.
- date: Email receipt time (format: YYYY-MM-DD HH:MM:SS).
- html_content: Email content in HTML format.
- status: Email status (e.g., unseen).
- code: 5-8 digit code extracted from the subject or content.

Each successful request results in status: true. The total number of requests will decrease by 1.

Response Example

The API returns JSON data:

{
    "status": true,
    "message": "Successfully fetched email list",
    "data": [
        {
            "uid": "da1398df-0719-41a9-96db-6e3ca418c0ab",
            "subject": "456",
            "from_field": "chanquadya@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": "chanquadya@gmail.com",
            "date": "2025-04-04 17:05:16",
            "html_content": "<!DOCTYPE HTML PUBLIC \"-\/\/W3C\/\/DTD HTML...",
            "status": "unseen",
            "code": "543684"
        }
    ]
    "remaining_requests": 994
}

Note: The html_content is truncated in the example. Actual data will include the full HTML of the email. If no emails are found, data will be an empty array and status will be false.

Using the API with C#

Example using HttpClient in C# to call the API and extract the code:

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://vndya.com/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"]);
        }
    }
}

JSON data is retrieved, and the code is printed to the console if the request is successful.

Note: Ensure you have installed the Newtonsoft.Json package. You can install it via NuGet with the command: dotnet add package Newtonsoft.Json.

Using the API with Python

Example using requests in Python to call the API and extract the code:

import requests

email = "user@example.com"
apikey = "21e30177f39325eb8ee0f1ed5a94987b"
response = requests.get(f"https://vndya.com/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']}")

JSON data is retrieved, and the code is printed as a list if the request is successful.

Note: Ensure you have installed the requests library. You can install it via pip with the command: pip install requests.

API Guide - Fetch Domains and Read Mail

Fetch Domain List

Endpoint

Parameters

Request Example

Response Format

Response Example

API Information

Parameters

Request Example

Response Format

Response Example

Using the API with C#

Using the API with Python

Notification