📖 DEVELOPER PORTAL

jmail API

RESTful endpoints for instant disposable mail creation & real-time message retrieval

GET /api/config

Fetch public mail domain configuration and server metadata.

curl -s https://mail.atiku.web.id/api/config
GET /api/session

Get or initialize anonymous session token. Pass x-session-id header for persistence.

curl -s https://mail.atiku.web.id/api/session
GET /api/inboxes

List all active disposable email addresses linked to the session.

curl -s https://mail.atiku.web.id/api/inboxes \ -H "x-session-id: YOUR_SESSION_ID"
POST /api/inboxes

Create custom or random disposable email address.

FieldTypeDescription
localPartstring (optional)Custom prefix (e.g. "mytest"). Random if omitted.
domainstring (optional)Select domain (e.g. "atiku.web.id").
curl -s -X POST https://mail.atiku.web.id/api/inboxes \ -H "x-session-id: YOUR_SESSION_ID" \ -H "Content-Type: application/json" \ -d '{"localPart": "testuser", "domain": "atiku.web.id"}'
GET /api/inboxes/:address/messages

Retrieve incoming emails for specific address.

curl -s "https://mail.atiku.web.id/api/inboxes/testuser%40atiku.web.id/messages" \ -H "x-session-id: YOUR_SESSION_ID"
DELETE /api/inboxes/:address

Unlink disposable email address from session.

curl -s -X DELETE "https://mail.atiku.web.id/api/inboxes/testuser%40atiku.web.id" \ -H "x-session-id: YOUR_SESSION_ID"
GET /api/stats

Retrieve global usage statistics (inbox count, message count, active domains).

curl -s https://mail.atiku.web.id/api/stats
GET /api/health

Service health check & uptime monitoring status.

curl -s https://mail.atiku.web.id/api/health