REST API v1

Используйте наш API для автоматизации работы с временными почтовыми ящиками.

🔗 Базовый URL

Все запросы отправляются на следующий адрес:

https://temp.repozis.ru/api/v1

Генерация адреса

Создает новый случайный анонимный почтовый адрес для приёма писем.

GET /api/v1/generate

📤 Пример ответа

{
  "email": "a7kx2m@temp.repozis.ru",
  "expires_at": "2026-04-21T19:00:00Z"
}

💡 Подсказка

Адрес активен в течение ограниченного времени. Сохраните значение email для последующей проверки входящих сообщений.

Список сообщений

Возвращает список полученных писем для указанного временного адреса.

GET /api/v1/messages?email={email}

📋 Параметры

  • email (обязательный) — адрес, полученный из /generate

📤 Пример ответа

[
  {
    "id": "msg_01",
    "from": "noreply@example.com",
    "subject": "Подтверждение регистрации",
    "date": "2026-04-20T18:30:00Z",
    "body": "Ваш код: 482910"
  }
]

💡 Подсказка

Если писем ещё нет — API вернёт пустой массив []. Рекомендуем опрашивать эндпоинт с интервалом 5–10 секунд.

⚠️ Лимиты и ограничения

  • Максимум 60 запросов в минуту с одного IP
  • Временный адрес существует ограниченное время
  • API предназначен для личного и некоммерческого использования
  • Необходимые заголовки: Content-Type: application/json

📚 Статус разработки

Наш API находится в стадии активной разработки. На данный момент доступны базовые функции для интеграции анонимной почты в ваши проекты. В будущем будут добавлены: удаление адресов, вебхуки для новых писем и расширенная фильтрация.