API Page

API Documentation

This guide explains how to use two of our JSON-based APIs: list_domain.php, checkmail.php, checkmail.php.

1) list_domain.php

Endpoint: GET /list_domain.php

Example JSON (Success):

        {
          "success": true,
          "domains": [
            "mydomain.com",
            "example.org"
          ]
        }

Example JSON (Error):

        {
          "success": true,
          "emails": [],
          "message": "No new emails found."
        }

2) checkmail.php

Endpoint: GET /checkmail.php
Parameters:

?mail=RECIPIENT_EMAIL (required)

Example Request:

        GET https://mail-temp.site/checkmail.php?mail=example@mail-temp.site

Example JSON (Success):

        {
            "success": true,
            "emails": [
                {
                    "id": 123456,
                    "from": "admin@mail-temp.site",
                    "to": "example@mail-temp.site",
                    "subject": "Example subject",
                    "date": "2025-01-21 00:33:34"
                }
            ]
        }

Example JSON (Error):

        {
          "success": false,
          "error": "Error requests",
        }

3) viewmail.php

Endpoint: GET /viewmail.php
Parameters:

?id=id_mail (optional)

Example Request:

        GET https://mail-temp.site/viewmail.php?id=123456

Example JSON (Success):

        {"success":true,
        "email":
            {
                "from":"admin@mail-temp.site",
                "to":"example@mail-temp.site",
                "subject":"Example subject",
                "date":"2025-01-21 00:33:34",
                "body": Example body"
            }
        }

Example JSON (Error):

        {
          "success": false,
          "error": "Error requests",
        }

Replace parameters such as Mail with your actual values.