Simail / РазработчикамAPI-консоль ↗

ВРЕМЕННАЯ ПОЧТА ДЛЯ АВТОМАТИЗАЦИИ

Письма и коды.
Через один API.

Создайте адрес, дождитесь письма и получите код подтверждения. Выбирайте домен сами или оставьте выбор сервису.

BASE URLhttps://api.apmw.net
20 минутСрок жизни по умолчанию
Bearer tokenДоступ по API-ключу
JSONЕдиный формат ответа

Три шага до первого кода

  1. Создайте ящик

    POST /api/mailbox с телом {}. Сохраните data.id и data.email.

  2. Получите OTP

    Опросите GET /api/mailbox/{id}/otp?silent=true. Пока кода нет, ответ содержит data: null.

  3. Удалите ящик

    Вызовите DELETE /api/mailbox/{id} либо дождитесь истечения срока.

curl -X POST 'https://api.apmw.net/api/mailbox' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"ikkyo.net","ttl":1200}'

Пример выше — для Bash/WSL. YOUR_API_KEY замените своим ключом.

Пример для PowerShell

$headers = @{ Authorization = "Bearer YOUR_API_KEY" }
$body = @{ domain = "ikkyo.net"; ttl = 1200 } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "https://api.apmw.net/api/mailbox" -Headers $headers -ContentType "application/json" -Body $body

ДОСТУП

Авторизация

Все методы работы с почтой требуют действующий ключ. Передавайте его в одном из заголовков:

Authorization: Bearer YOUR_API_KEY
# Альтернативный заголовок:
X-API-Key: YOUR_API_KEY
Документация и GET /api/health доступны без ключа. Ключ даёт доступ ко всем ящикам этого сервиса; отдельных пользовательских кабинетов и разграничения ящиков нет.

Не включайте ключ в публичный код сайта. Старый способ передачи ?api_key=… пока поддерживается для совместимости, но в новых клиентах используйте заголовок: URL может попасть в историю и журналы.

СПРАВОЧНИК

Методы API

Нажмите на метод, чтобы посмотреть параметры и пример ответа. Вместо {id} можно передать адрес email; кодируйте его через encodeURIComponent.

ЖИВОЙ ЗАПРОС

Попробовать API

Запрос отправляется на этот сервер. Ключ используется только в текущей странице и не сохраняется в браузере.

Ответ появится здесь.

C# · ZENNOPOSTER

Готовый клиент

Класс использует встроенный ZennoPoster.HTTP.Request. Добавьте его в «Общий код» проекта и подключите сборки ZennoLab.CommandCenter, ZennoLab.InterfacesLibrary и Newtonsoft.Json.

Скачать SimailClient.cs ↓ · Скачать инструкцию ↓

var mail = new SimailExamples.SimailClient(project.Variables["simail_api_key"].Value);
string[] domains = mail.GetDomains();
var mailbox = mail.CreateMailbox(); // Случайный домен
// Для выбора: mail.CreateMailbox(domain: "ikkyo.net");
project.Variables["mailbox_id"].Value = mailbox.Id;
project.Variables["mailbox_email"].Value = mailbox.Email;

После отправки письма целевым сайтом вызовите mail.WaitForOtp(id). Ключ храните в переменной проекта simail_api_key. Ожидание по умолчанию — 120 секунд, опрос каждые 2,5 секунды.

Готовые кубики: создание ящика, ожидание OTP, удаление ящика.

Сигнатуры проверены по DLL ZennoPoster 7.9.2.0; класс и кубики скомпилированы с установленными сборками. Выполнение внутри ProjectMaker пока не проверено.

ПОВЕДЕНИЕ СЕРВИСА

Ошибки и ограничения

СтатусЧто означает
200Запрос выполнен. При silent=true OTP или письмо могут ещё отсутствовать.
201Ящик создан; данные находятся в data.
400Неверный JSON, недоступный домен, некорректный prefix или ttl.
401Ключ отсутствует, неверен, сменён или отозван.
404Письмо или OTP ещё не получены либо запрошенный метод не существует.
413JSON запроса превышает 64 КиБ.
500 / 503Ошибка сервиса / нет доступных доменов. Повторите позже.