Dispoil API

RESTful API for disposable email service

GET /api/generate

Generate a random username for a new email address.

Response:

{ "username": "happy-panda-123" }
GET /api/messages/:username

Get all messages for a specific username.

Response:

{
  "messages": [
    {
      "id": "abc123",
      "from": "sender@example.com",
      "subject": "Hello",
      "body": "Message content",
      "bodyHTML": "<p>Message content</p>",
      "timestamp": 1705220000000
    }
  ],
  "count": 1
}
DELETE /api/messages/:username/:messageId

Delete a specific message.

Response:

{ "success": true }
POST /api/validate-username

Validate a custom username.

Request Body:

{ "username": "my-custom-name" }

Response:

{ "valid": true }
← Back to Dispoil