✉️ ABS Mail

⚡ Fast • 🔒 Private • 🚀 Developer-Friendly Disposable Email API

Create temporary inboxes instantly, receive emails in real time, extract OTP codes automatically, and delete everything when you're done.

🌐 API v9 • 📚 Documentation • 🚀 Quick Start • 🛠️ API Reference

---

✨ Overview

ABS Mail is a fast, privacy-focused and developer-friendly disposable email platform.

Create a temporary mailbox instantly, copy the generated address, receive messages in real time, automatically detect OTP and verification codes, and permanently delete your inbox when finished.

Perfect for:

• 🧪 API Testing
• 👨‍💻 Development Projects
• 🔐 OTP & Verification Testing
• 📧 Temporary Email Workflows
• 🤖 Automation
• 🛠️ Developer Tools

---

🚀 Highlights

Feature	Description
⚡ Instant Inbox	Create a temporary email address instantly
📥 Real-Time Messages	Receive incoming emails quickly
🔐 Token Security	Secure mailbox access with unique tokens
🔢 OTP Detection	Automatically extract verification codes
🗑️ Inbox Purge	Delete mailbox and messages permanently
🌐 CORS Enabled	Browser-friendly API access
📱 Responsive	Works on mobile, tablet and desktop
🌙 Theme Ready	Modern interface with theme support
🧩 No Framework	Pure HTML, CSS and JavaScript
☁️ Easy Deploy	GitHub Pages, Vercel and Netlify ready

---

📄 Included Pages

Page	Description
🏠 Home	Generate and manage temporary inboxes
⚙️ How It Works	Step-by-step mailbox workflow
📚 API Docs	Interactive API documentation
❓ FAQ	Common questions and answers
ℹ️ About	ABS Mail project information
🔄 Alternatives	Disposable email comparison
📬 Contact	Frontend contact page
🔒 Privacy Policy	Privacy information
📜 Terms of Service	Usage terms
🍪 Cookie Policy	Cookie information

---

🌐 Official API

API Base URL

https://mail.abdullah.nyc.mn/api/v9

The ABS Mail frontend is configured to use the official REST API throughout the project.

---

📊 API Information

Property	Value
🏷️ API Version	v9.0.0
📦 Response Format	JSON (UTF-8)
🔐 Authentication	Bearer Token
🌐 CORS	Enabled
⚡ Preflight	OPTIONS → 204 No Content

---

⚡ Quick Start

1️⃣ Clone the Repository

git clone YOUR_REPOSITORY_URL
cd abs-mail

Because this project uses plain HTML, CSS and JavaScript, you can open index.html locally or deploy it directly.

💡 No npm install required. No build process required.

---

🔧 API Configuration

The main API configuration is located in:

js/site.js

const API_BASE = "https://mail.abdullah.nyc.mn/api/v9";

To use another compatible backend, simply change the API_BASE value.

---

📨 API Reference

1️⃣ API Root

Endpoint

GET /api/v9

Returns API metadata and the available endpoint map.

cURL

curl -X GET "https://mail.abdullah.nyc.mn/api/v9" \
  -H "Accept: application/json"

---

🟢 2️⃣ Health Check

Endpoint

GET /api/v9/health

Checks whether the ABS Mail service is operational.

cURL

curl -X GET "https://mail.abdullah.nyc.mn/api/v9/health" \
  -H "Accept: application/json"

📦 Example Response

{
  "status": "ok",
  "success": true,
  "service": "ABS Mail API",
  "version": "9.0.0"
}

---

📧 3️⃣ Create Temporary Inbox

Endpoint

POST /api/v9/inbox

Creates a new disposable email address.

📥 Optional Request Body

{
  "customName": "tester99",
  "domain": "namesgeneratorhub.com"
}

🚀 cURL Request

curl -X POST "https://mail.abdullah.nyc.mn/api/v9/inbox" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"customName":"tester99"}'

📦 Example Response

{
  "success": true,
  "address": "tester99@namesgeneratorhub.com",
  "mailbox": "tester99@namesgeneratorhub.com",
  "token": "YOUR_INBOX_TOKEN",
  "domain": "namesgeneratorhub.com",
  "status": "ready"
}

🔐 Important: Save the returned token. It is required to read messages and permanently delete the mailbox.

---

📬 4️⃣ List Inbox Messages

Endpoint

GET /api/v9/messages

🔐 Authorization Required

Authorization: Bearer YOUR_INBOX_TOKEN

🚀 cURL Request

curl -X GET "https://mail.abdullah.nyc.mn/api/v9/messages" \
  -H "Authorization: Bearer YOUR_INBOX_TOKEN"

📦 Example Response

{
  "success": true,
  "count": 1,
  "messages": [
    {
      "id": "msg_example",
      "subject": "Your verification code",
      "verificationCode": "601625",
      "text": "Your verification passcode is 601625."
    }
  ]
}

---

📩 5️⃣ Get a Single Message

Endpoint

GET /api/v9/messages/{id}

🚀 cURL Request

curl -X GET "https://mail.abdullah.nyc.mn/api/v9/messages/MESSAGE_ID" \
  -H "Authorization: Bearer YOUR_INBOX_TOKEN"

---

🗑️ 6️⃣ Delete / Purge Inbox

Endpoint

DELETE /api/v9/inbox

🚀 cURL Request

curl -X DELETE "https://mail.abdullah.nyc.mn/api/v9/inbox" \
  -H "Authorization: Bearer YOUR_INBOX_TOKEN"

⚠️ This permanently removes the disposable mailbox and all associated messages.

---

🔐 Authentication Flow

POST /inbox
      │
      ▼
📧 Receive Address + Token
      │
      ▼
GET /messages
Authorization: Bearer TOKEN
      │
      ▼
📩 Read Emails & OTP Codes
      │
      ▼
DELETE /inbox
Authorization: Bearer TOKEN
      │
      ▼
🗑️ Mailbox Permanently Deleted

---

🌍 Public Endpoints

These operations do not require a mailbox token:

GET /api/v9
GET /api/v9/health
POST /api/v9/inbox
GET /api/v9/domains

---

🔒 Protected Endpoints

These require the unique inbox token:

GET /api/v9/messages
GET /api/v9/messages/{id}
DELETE /api/v9/inbox

---

🧠 Frontend Features

The ABS Mail frontend includes:

• ✨ Generate new disposable addresses
• 📋 Copy email addresses with one click
• 🔄 Refresh incoming messages
• ⚡ Automatic inbox polling
• 🔢 OTP detection and display
• 📩 Expandable message cards
• 📨 Individual message handling
• 🗑️ Full inbox deletion
• 📱 Responsive navigation
• 📚 Dedicated documentation pages
• 🔒 Privacy and legal pages

---

🗂️ Suggested Project Structure

abs-mail/
│
├── 🏠 index.html
├── ℹ️ about.html
├── 🔄 alternatives.html
├── 📬 contact.html
├── 🍪 cookies.html
├── 📚 docs.html
├── ❓ faq.html
├── ⚙️ how-it-works.html
├── 🔒 privacy.html
├── 📜 terms.html
│
├── css/
│   └── 🎨 style.css
│
├── js/
│   └── ⚡ site.js
│
├── assets/
│   ├── icons/
│   └── images/
│
├── ▲ vercel.json
├── ◆ netlify.toml
├── ↪️ _redirects
└── 📄 README.md

---

🐙 Deploy on GitHub Pages

1. 🆕 Create a new GitHub repository.
2. 📤 Upload the complete ABS Mail project.
3. ⚙️ Open Repository Settings → Pages.
4. 🌿 Select the branch containing index.html.
5. 💾 Save the settings.

Your static ABS Mail frontend will then be published through GitHub Pages.

---

▲ Deploy on Vercel

1. 🐙 Push the project to GitHub.
2. 📥 Import the repository into Vercel.
3. ⚙️ Select framework preset: Other.
4. 🚫 No build command is required.
5. 🚀 Deploy.

The included vercel.json can be used for static hosting configuration.

---

◆ Deploy on Netlify

1. 🐙 Push the project to GitHub.
2. 📥 Import the repository into Netlify.
3. 📁 Set the publish directory to:

.

4. 🚀 Deploy the site.

The included netlify.toml and _redirects files support static deployment.

---

📱 Browser Compatibility

ABS Mail is designed for modern browsers:

• 🌐 Google Chrome
• 🔷 Microsoft Edge
• 🦊 Mozilla Firefox
• 🧭 Safari
• 📱 Modern Mobile Browsers

---

⚠️ Production Notes

• 📬 The contact form is frontend-only unless connected to a backend.
• 🔐 The mailbox token should be treated as a private credential.
• 🧪 Always test API behavior before production changes.
• 🌐 Public deployments should use HTTPS.
• 🗑️ Deleted mailboxes cannot be recovered.

---

🤝 Contributing

Contributions are always welcome! 💜

1️⃣ Fork the repository
2️⃣ Create a feature branch
3️⃣ Make your changes
4️⃣ Test everything
5️⃣ Submit a pull request

---

🔗 Useful Links

🌐 Official API

https://mail.abdullah.nyc.mn/api/v9

🟢 API Health

https://mail.abdullah.nyc.mn/api/v9/health

📚 API Documentation

https://mail.abdullah.nyc.mn/docs

---

✉️ ABS Mail

⚡ Fast. 🔒 Private. 📧 Disposable.

Built for temporary inboxes, privacy-focused workflows and developer-friendly email testing.

⭐ If you like this project, consider giving it a star!

Made with 💜 for developers and privacy-focused users.