Documentation

1. Generate Email

Endpoint: POST /api/generate-email

Description: Generates a new temporary email address for use.

POST /api/generate-email
// Response:
{
  "email": "example12345@ephoria.xyz"
}

2. Fetch Inbox

Endpoint: POST /api/inbox

Description: Retrieves all incoming emails associated with the generated address.

POST /api/inbox
{
  "email": "example12345@ephoria.xyz"
}
// Response:
{
  "emails": [
    {
      "from": "noreply@discord.com",
      "subject": "Your Discord Verification Code",
      "text": "Your verification code is 123456",
      "receivedAt": "2025-03-10T12:34:56Z"
    }
  ]
}

3. Clear Inbox

Endpoint: POST /api/clear-inbox

Description: Deletes all emails from the current inbox associated with the generated address.

POST /api/clear-inbox

1. Example in Python

import requests

# Generate Email
response = requests.post('https://ephoria.xyz/api/generate-email')
generated_email = response.json().get('email')
print(f"Generated Email: {generated_email}")

# Fetch Inbox
response = requests.post('https://ephoria.xyz/api/inbox', json={'email': generated_email})
inbox = response.json()
for email in inbox.get('emails', []):
    print(f"From: {email['from']}, Subject: {email['subject']}")

2. Example in JavaScript (Fetch API)

// Generate Email
fetch('https://ephoria.xyz/api/generate-email', { method: 'POST' })
  .then(response => response.json())
  .then(data => {
    const generatedEmail = data.email;
    console.log('Generated Email:', generatedEmail);

    // Fetch Inbox
    fetch('https://ephoria.xyz/api/inbox', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email: generatedEmail }),
    })
    .then(response => response.json())
    .then(data => console.log('Inbox:', data));
  });

3. Example in Go

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "log"
  "net/http"
)

func main() {
  // Generate Email
  resp, err := http.Post("https://ephoria.xyz/api/generate-email", "application/json", nil)
  if err != nil {
    log.Fatal(err)
  }
  var generatedEmail map[string]string
  json.NewDecoder(resp.Body).Decode(&generatedEmail)
  email := generatedEmail["email"]
  fmt.Println("Generated Email:", email)

  // Fetch Inbox
  inboxPayload := map[string]string{"email": email}
  payloadBytes, _ := json.Marshal(inboxPayload)
  resp, err = http.Post("https://ephoria.xyz/api/inbox", "application/json", bytes.NewBuffer(payloadBytes))
  if err != nil {
    log.Fatal(err)
  }
  var inbox map[string]interface{}
  json.NewDecoder(resp.Body).Decode(&inbox)
  fmt.Println("Inbox:", inbox)
}