Ключи API временной почты для автоматического тестирования писем

Список активных публичных доменов

Возвращает доступные для создания адресов домены. Ключ не требуется, квота не расходуется. Приватные домены GPTMail исключены.

curl -sS "https://cleantempmail.com/api/domains?limit=100"

{
  "success": true,
  "data": {
    "domains": ["domain-one.example", "domain-two.example"],
    "total": 1832,
    "offset": 0,
    "limit": 100
  }
}

Создать временный почтовый адрес

GET создаёт адрес со сгенерированным префиксом и случайным активным доменом. POST позволяет выбрать префикс, домен или оба. Итоговый адрес всегда возвращается в data.email.

curl -sS \
  -H "X-API-Key: ct-test" \
  "https://cleantempmail.com/api/generate-email"

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"prefix":"qa.user","domain":"your-active-domain.com"}' \
  "https://cleantempmail.com/api/generate-email"

Если запрошенный домен уже неактивен, API возвращает HTTP 409, а не подменяет его другим.

Список писем в ящике

Возвращает до 500 последних писем публичного адреса CleanTempMail. Для нового или пустого ящика возвращаются emails: [] и count: 0.

curl -sS -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails"

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "66c123example",
        "email_address": "[email protected]",
        "from_address": "[email protected]",
        "subject": "Your verification code",
        "content": "Your code is 123456",
        "html_content": "<p>Your code is <b>123456</b></p>",
        "has_html": true,
        "attachments": [
          {
            "id": "attachment-id",
            "filename": "receipt.pdf",
            "content_type": "application/pdf",
            "size": 48231
          }
        ],
        "timestamp": 1787702400,
        "raw_size": 51984,
        "created_at": "2026-08-25T12:00:00Z"
      }
    ],
    "count": 1
  },
  "usage": { "daily_limit": 100, "used_today": 2, "remaining_today": 98, "total_limit": 1000, "total_used": 2, "remaining_total": 998 }
}

Получить полное письмо

По id из /api/emails возвращает письмо: текст/HTML, заголовки, время и метаданные вложений. Содержимое вложений в JSON не включается.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

Основные поля письма

Скачать вложение

Скачивает вложение как двоичный файл. Используйте id письма и attachments[].id из GET /api/email/{id}. Каждое скачивание расходует 1 запрос API.

curl -fL -OJ \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example/attachment/attachment-id"

Тело ответа — сам файл. Сервер задаёт Content-Type, Content-Length и Content-Disposition. curl -OJ сохраняет безопасное имя файла, указанное сервером. Ошибки вложений возвращаются обычным текстом.

Удалить письмо

Безвозвратно удаляет письмо по id. Сначала получите ID через /api/emails. Отменить действие нельзя.

curl -sS -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/email/66c123example"

{"success":true,"data":{"message":"Email deleted"},"usage":{"daily_limit":100,"used_today":4,"remaining_today":96,"total_limit":1000,"total_used":4,"remaining_total":996}}

Очистить ящик

Безвозвратно удаляет все сохранённые письма указанного публичного ящика и возвращает число удалённых. Отменить действие нельзя.

curl -sS -X DELETE -G \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://cleantempmail.com/api/emails/clear"

{"success":true,"data":{"message":"Deleted 3 emails","count":3},"usage":{"daily_limit":100,"used_today":5,"remaining_today":95,"total_limit":1000,"total_used":5,"remaining_total":995}}

Эндпоинты статистики

Возвращает кэшированную публичную статистику сервиса. Каждый путь — отдельный защищённый запрос, расходующий 1 запрос. Почта приватных доменов в статистику не входит.

curl -sS \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/stats"

{
  "success": true,
  "data": {
    "total_emails": 1250000,
    "today_emails": 32000,
    "emails_24h": 41000,
    "unique_subjects": 8600,
    "active_domains": 1832
  },
  "usage": { "daily_limit": 100, "used_today": 6, "remaining_today": 94, "total_limit": 1000, "total_used": 6, "remaining_total": 994 }
}

Проверка квоты API-ключа

Возвращает статус и расход купленного, созданного вручную, исчерпанного или общего тестового ключа. Квоту не расходует. Передайте ключ в X-API-Key или JSON-поле api_key; предпочтителен заголовок.

curl -sS -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://cleantempmail.com/api/api-key/usage"

curl -sS -X POST \
  -H "Content-Type: application/json" \
  --data '{"api_key":"ct-test"}' \
  "https://cleantempmail.com/api/api-key/usage"

{
  "success": true,
  "data": {
    "masked_key": "••••••••wxyz",
    "status": "active",
    "is_active": true,
    "daily_limit": 100,
    "used_today": 6,
    "remaining_today": 94,
    "total_limit": 1000,
    "total_used": 6,
    "remaining_total": 994
  }
}

status принимает active, exhausted или inactive. Исчерпанные купленные ключи остаются доступны для проверки. Полный ключ и метаданные Stripe/клиента никогда не возвращаются.