API Documentation

Base URL: https://cc.randomgiare.vn/ (default)

Global Features

CORS: Enabled for all origins (*). Allowed methods: GET, POST, DELETE, OPTIONS.
Rate Limiting: 60 requests per minute per IP.
Response Format: JSON.
Errors: Standard structure { "error": "description" }.

📧 Core Resources

1. Create Random Email

Generate a new random email address.

POST /api/random_mail

2. Check Mail

Get all emails for an email address.

Try URL Generator

/api/check_mail

POST /api/check_mail

Response Example

{
  "success": true,
  "emails": [
    {
      "from": "[email protected]",
      "from_email": "[email protected]",
      "subject": "Hello",
      "date": "2026-01-27 11:28:50",
      "body": "Email content",
      "body_html": "<html>...</html>",
      "message_id": "msg-123"
    }
  ],
  "count": 1,
  "email": "[email protected]"
}

3. Reply Mail

Send a reply email.

POST /api/reply_mail

4. Read Code

Extract 6-8 digit codes from emails.

POST /api/read_code

🌐 Configuration & Stats

Allowed Domains

GET /api/domains

Returns list of supported domains.

System Statistics

GET /api/stats

Email count and system status.

🛠 Operation & Monitoring

GET

/healthz Liveness probe

GET

/readyz Readiness probe

GET

/metrics System metrics