邮箱

Authorization: Bearer YOUR_API_KEY

POST /api/v1/emails/create

{
  "email": "myemail@ig.do",
  "tag": "个人"
}

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "myemail@ig.do",
    "tag": "个人",
    "like": false,
    "pin": false,
    "createdAt": "2025-12-07T12:00:00.000Z"
  }
}

{
  "success": false,
  "error": "Missing API key. Provide it via Authorization header (Bearer token) or ?key= query parameter"
}

{
  "success": false,
  "error": "Invalid or expired API key: [error details]"
}

{
  "success": false,
  "error": "Invalid request data",
  "details": [
    {
      "path": ["email"],
      "message": "Invalid email format"
    }
  ]
}

{
  "success": false,
  "error": "Email prefix length must be between 4 and 64 characters"
}

{
  "success": false,
  "error": "The provided email prefix is reserved. Please choose another one."
}

{
  "success": false,
  "error": "You don't have permission to use the domain \"kfc.sh\". Premium domains require an active Pro subscription or Lifetime plan."
}

{
  "success": false,
  "error": "An email address with this address already exists"
}

curl -X POST https://your-domain.com/api/v1/emails/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "myemail@ig.do",
    "tag": "个人"
  }'

const response = await fetch('https://your-domain.com/api/v1/emails/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 

import requests

url = 'https://your-domain.com/api/v1/emails/create'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
}
data =