Mail API

1. Авторизация

Получите ключ у владельца. Передавайте его только заголовком и только по HTTPS:

Authorization: Bearer YOUR_API_KEY

Не вставляйте ключ в URL, публичный код или форму на этой странице. Здесь нет поля для ввода ключа. Для безопасной копии документации используйте HTTPS-страницу.

2. Три запроса

• GET /v1/me — имя ключа, привязанный ящик, scope и срок.
• GET /v1/emails?limit=20 — список входящих (1–50 на страницу). Ответ: data и next_cursor.
• GET /v1/emails/EMAIL_ID — отправитель, тема, дата и безопасный текст письма этого ящика.

curl 'https://mail.ivann.fun/v1/me' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://mail.ivann.fun/v1/emails?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://mail.ivann.fun/v1/emails/EMAIL_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

3. Следующая страница

Если next_cursor не null, передайте его в ?limit=20&cursor=NEXT_CURSOR. Курсор действует час и связан с ключом. Иногда data пуст, но курсор есть: продолжайте листать — за один запрос проверяется не более 500 записей Resend.

4. Ограничения

• 12 запросов в минуту на ключ, есть общий и IP-лимит. Ключ действует 90 дней.
• Только входящие в пределах хранения Resend; отдельный архив не создаётся.
• Ящик задаётся при выпуске ключа. Параметра для выбора другого ящика нет.
• Нет отправки, удаления, поиска по всем ящикам, скачивания вложений или исходного MIME. Вложения — только имена, размеры и типы.
• Ответ — JSON; HTML письма не исполняется. Скрытые адресаты и исходные заголовки не выдаются.

5. Ошибки и отзыв

400 — неверный параметр/курсор; 401 — ключ неверен, отозван или истёк; 404 — письмо недоступно этому ящику; 429 — подождите; 503 — временно недоступен Resend. Методы записи запрещены.

Владелец управляет ключами в теме Telegram «API»: /keys, /revoke KEY_ID, /rotate KEY_ID. Полный секрет показывается один раз, повторно его получить нельзя. При утечке отзовите ключ. Ротация сразу отключает старый.