Единый источник почтовых ящиков + кодов/ссылок подтверждения для регистраторов (ElevenLabs, ChatGPT и др.). Арендуешь готовый ящик под сервис → забираешь из него код или verify-ссылку. Аренда бесплатна, списание — только за успешно прочитанный код/ссылку.
base URL: https://mailcode.37-27-106-243.sslip.io/v1 цена за код: $0.0015 авторизация: Bearer-токен
/apikey). Это твой Bearer.GET /v1/quantity?service=elevenlabs.io.POST /v1/order {"service":"elevenlabs.io"} → получишь email.email аккаунт на целевом сайте (твой регер).GET /v1/message?email=…&want=link|code (сервер сам поллит ~2.5 мин)./v1/balance, пополнение — в боте /topup.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 -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"
Тот же цикл — поменяй service на домен сайта (напр. chatgpt.com) и
want/sender под письмо. want=code достаёт цифровой код,
want=link — URL подтверждения. Параметры sender/subject сужают поиск письма.
Готовый 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 | проверка живости |
Тело: {"service":"elevenlabs.io", "domain":"inbox.lv"?, "note":"..."?}.
service — домен целевого сайта (обязателен). domain — предпочитаемый домен почты (опц.).
Заголовок Idempotency-Key (опц.) — повтор запроса не арендует второй ящик.
Ответ: {"ok":true,"email":"…","provider":"…","domain":"…","mail_ref":"…"} либо
409 no_stock, если свободных нет.
Параметры: 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).
?service=elevenlabs.io → {"ok":true,"domains":{"icloud.com":7,"inbox.lv":161}}.
Для сервиса с гейтом доменов показываются только пригодные (ниже).
Некоторые сайты «мертвят» аккаунты на части доменов. Для таких сервисов ящики выдаются ТОЛЬКО с доверенных доменов:
| Сервис | Доверенные домены почты |
|---|---|
elevenlabs.io | icloud.com, inbox.lv |
/v1/order) — бесплатно./v1/message с результатом)./v1/balance, пополнение — бот /topup <сумма> (CryptoBot, 1 USDT = $1).| HTTP | error | смысл |
|---|---|---|
| 401 | unauthorized | нет/неверный токен |
| 400 | service_required / bad_request | не указан service / плохой запрос |
| 409 | no_stock | нет свободных ящиков под сервис/домен |
| 429 | per_user_pending_exceeded / per_user_daily_exceeded | лимит активных/суточных аренд |
| 503 | temporary / provider_down | временная ошибка — повторить позже |
Самообслуживание для людей: аренда ящика, код/ссылка, баланс, пополнение, выдача API-ключа.
Команды: /start, /apikey, /quantity <service>, /order <service>,
/code <email>, /link <email>, /balance, /history, /topup <сумма>.
Mail Service · единый пул почт (iCloud / inbox.lv / onet / резерв) на одном Postgres.