Mail Service API

Единый источник почтовых ящиков + кодов/ссылок подтверждения для регистраторов (ElevenLabs, ChatGPT и др.). Арендуешь готовый ящик под сервис → забираешь из него код или verify-ссылку. Аренда бесплатна, списание — только за успешно прочитанный код/ссылку.

base URL: https://mailcode.37-27-106-243.sslip.io/v1 цена за код: $0.0015 авторизация: Bearer-токен

Быстрый старт (регистрация аккаунта)

1.
Получи API-токен в телеграм-боте: кнопка 🔑 API-ключ (или /apikey). Это твой Bearer.
2.
Проверь сток: GET /v1/quantity?service=elevenlabs.io.
3.
Арендуй ящик: POST /v1/order {"service":"elevenlabs.io"} → получишь email.
4.
Зарегистрируй этим email аккаунт на целевом сайте (твой регер).
5.
Забери код/ссылку: GET /v1/message?email=…&want=link|code (сервер сам поллит ~2.5 мин).
6.
Списывается $0.0015 только при успешном чтении. Баланс — /v1/balance, пополнение — в боте /topup.

Python (полный цикл)

import requests, time
BASE = "https://mailcode.37-27-106-243.sslip.io"
TOKEN = "ВАШ_API_ТОКЕН"            # из бота: кнопка «🔑 API-ключ»
H = {"Authorization": "Bearer " + TOKEN}

# 1) арендовать ящик под сервис (бесплатно)
r = requests.post(f"{BASE}/v1/order", headers=H, json={"service": "elevenlabs.io"}).json()
assert r.get("ok"), r
email = r["email"]
print("mailbox:", email)

# 2) ... ваш регистратор создаёт аккаунт elevenlabs.io на этот email ...

# 3) забрать verify-ссылку (сервер поллит сам; при таймауте вернёт ok:false)
m = requests.get(f"{BASE}/v1/message", headers=H,
                 params={"email": email, "want": "link", "sender": "eleven"}).json()
if m.get("ok"):
    print("verify link:", m["result"])     # <- открыть/дёрнуть ссылку = подтвердить
else:
    print("письмо не пришло:", m.get("msg"))

curl

# заказать ящик
curl -X POST https://mailcode.37-27-106-243.sslip.io/v1/order \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"service":"elevenlabs.io"}'

# забрать код (want=code) или ссылку (want=link)
curl "https://mailcode.37-27-106-243.sslip.io/v1/message?email=$EMAIL&want=code&sender=openai" \
  -H "Authorization: Bearer $TOKEN"

ChatGPT и другие сервисы

Тот же цикл — поменяй service на домен сайта (напр. chatgpt.com) и want/sender под письмо. want=code достаёт цифровой код, want=link — URL подтверждения. Параметры sender/subject сужают поиск письма.

SDK и спека

Готовый python-клиент — mailcode_client.py (класс MailCode: order / read / read_async / balance / create_key). Машиночитаемая спека — /v1/openapi.json (импорт в Postman, генерация клиентов). Долгое чтение без удержания HTTP: POST /v1/message/async → job_id → GET /v1/message/job/<id>.

Авторизация

Каждый запрос — с заголовком Authorization: Bearer <токен> (альтернатива — ?token=). Токен привязан к пользователю; лимиты и баланс считаются на пользователя, а не на ключ (несколько ключей не обходят лимит). Токен выдаёт бот (🔑 API-ключ).

Эндпоинты

МетодПутьНазначение
POST/v1/orderарендовать ящик под сервис
POST/v1/order/batchарендовать N ящиков одним запросом
GET/v1/messageзабрать код/ссылку из ящика
GET/v1/quantityсколько свободных ящиков по доменам
GET/v1/balanceбаланс
GET/v1/historyистория операций
POST/v1/pay/invoiceсоздать инвойс на пополнение (CryptoBot)
GET/v1/healthпроверка живости

POST /v1/order

Тело: {"service":"elevenlabs.io", "domain":"inbox.lv"?, "note":"..."?}. service — домен целевого сайта (обязателен). domain — предпочитаемый домен почты (опц.). Заголовок Idempotency-Key (опц.) — повтор запроса не арендует второй ящик.
Ответ: {"ok":true,"email":"…","provider":"…","domain":"…","mail_ref":"…"} либо 409 no_stock, если свободных нет.

GET /v1/message

Параметры: email (обяз.), want=code|link (деф. code), sender, subject, service, link_re (своя regex ссылки).
Ответ: {"ok":true,"result":"…","want":"…","mail_url":"…"}; если письма нет — {"ok":false,"msg":"…"}; временная ошибка провайдера — 503.
mail_url (если доступно) — ссылка на HTML-копию письма (точная копия, открыть в браузере): удобно, когда код в кнопке/картинке или нужна ссылка внутри письма. Живёт ограниченное время (TTL).

GET /v1/quantity

?service=elevenlabs.io → {"ok":true,"domains":{"icloud.com":7,"inbox.lv":161}}. Для сервиса с гейтом доменов показываются только пригодные (ниже).

Пригодность доменов (born-dead гейт)

Некоторые сайты «мертвят» аккаунты на части доменов. Для таких сервисов ящики выдаются ТОЛЬКО с доверенных доменов:

СервисДоверенные домены почты
elevenlabs.ioicloud.com, inbox.lv

Биллинг

Коды ошибок

HTTPerrorсмысл
401unauthorizedнет/неверный токен
400service_required / bad_requestне указан service / плохой запрос
409no_stockнет свободных ящиков под сервис/домен
429per_user_pending_exceeded / per_user_daily_exceededлимит активных/суточных аренд
503temporary / provider_downвременная ошибка — повторить позже

Телеграм-бот

Самообслуживание для людей: аренда ящика, код/ссылка, баланс, пополнение, выдача API-ключа. Команды: /start, /apikey, /quantity <service>, /order <service>, /code <email>, /link <email>, /balance, /history, /topup <сумма>.


Mail Service · единый пул почт (iCloud / inbox.lv / onet / резерв) на одном Postgres.