http://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&sender=$SENDER®ex=$REGEX&token=$TOKEN&soft=$SOFT_ID&investor=$INVESTOR&type=$ANSWER_TYPE&subject=$SUBJECT&clear=$CLEAR&api=2.0
Обратите внимание, что обязательными являются параметры $TOKEN,$SITE.
$SITE - Сайт, для которого вам нужна почта.
$MAIL_TYPE - Укажите тип почты (mail.ru, например), которую хотите получить. Если оставить пустым (или написать ALL) - будут выдаваться случайные почты из НАШИХ ДОМЕНОВ. Напишите REAL, если вам нужны только почты на популярных доменах (mail.ru, outlook.com, gmail.com и т.д.).
Для удобства, можно использовать целые группы почт:
mail_type=YANDEX (берутся домены Yandex)
mail_type=OUTLOOK (берутся только домены outlook / hotmail)
mail_type=MAILCOM (берутся домены mail.com)
mail_type=MAILRU (берутся домены mail.ru)
mail_type=RAMBLER (берутся домены Rambler)
mail_type=GMX (берутся домены GMX)
*mail_type=mine (берутся все Ваши привязанные домены, которые привязали с помощью https://t.me/kopeechka_bot)
mail_type=ALL,mail.ru
$SENDER - используется, если в адресе отправителя (от кого ждём письмо) нет $SITE (в 98% случаев он есть и вводить не нужно).
Если вы указываете более 2 и более сайтов и хотите указать отправителя - то вписывайте отправителя для каждого сайта соответственно. Например вы указали site=vasya.com,petya.ru, тогда необходимо указывать отправителей так: vasya,petya и никак иначе, или вы получите ошибку / письмо не дойдет.
$REGEX - предназначен для Вашего регулярного выражения, чтобы мы сами нашли Вам информацию и выдали только её.
Если вы указываете более 2 и более сайтов и хотите указать рег. выражение - то вписывайте его для каждого сайта соответственно, через разделитель |,|. Например вы указали site=vasya.com,petya.ru, тогда regex=.*|,|\d{1} , где .* - выражение для vasya.com, а \d{1} - выражение для petya.ru
$SOFT_ID - используется разработчиками в реферальной программе.
$TOKEN - Ваш API-ключ с сервиса kopeechka.store
$INVESTOR - Укажите 1, если вам необходимо, чтобы почты брались не из общей базы, а из ваших собственных заливов (через Telegram бота.
$ANSWER_TYPE - Какой тип ответа желаете получить (JSON/TEXT) (по умолчанию JSON)
$SUBJECT - Укажите, если хотите получить письмо с определенной темой (достаточно одного слова). Является приоритетным. Если указанного слова в теме не будет - письмо НЕ ВЫДАСТ!
Например: тема "Для регистрации аккаунта Facebook", в параметре укажите "регистрации" - найдет нужное письмо. Если вы укажете в параметре "активации" - письмо не выдаст
$CLEAR - Укажите в параметре 1, если хотите получать почтовые ящики, которые не содержат в себе знаки: - . _ .
✅ Ответ:
JSON
{"status":"OK","id":$TASK_ID,"mail":"$MAIL"}
TEXT
OK|$TASK_ID|$MAIL
$TAKS_ID - по этому параметру необходимо делать дальнейшие запросы к сервису kopeechka.store. Это номер вашей активации.
$MAIL - Почта с сервиса.
❌ Возможные ошибки:
Неверно указан токен
JSON
{"status":"ERROR","value":"BAD_TOKEN"}
TEXT
ERROR|BAD_TOKEN
Вы неверно указали сайт.
JSON
{"status":"ERROR","value":"BAD_SITE"}
TEXT
ERROR|BAD_SITE
Такого домена/доменной зоны у нас нет.
JSON
{"status":"ERROR","value":"BAD_DOMAIN"}
TEXT
ERROR|BAD_DOMAIN
Недостаточно средств для совершения операции.
JSON
{"status":"ERROR","value":"BAD_BALANCE"}
TEXT
ERROR|BAD_BALANCE
Нет почты с такими настройками. Попробуйте изменить $MAIL_TYPE или напишите в поддержку - попробуем добавить ящики.
JSON
{"status":"ERROR","value":"OUT_OF_STOCK"}
TEXT
ERROR|OUT_OF_STOCK
Неизвестная, системная ошибка. Обратитесь в поддержку - поможем!
JSON
{"status":"ERROR","value":"SYSTEM_ERROR"}
TEXT
ERROR|SYSTEM_ERROR
Достигнут лимит заказов почт в секунду (относится к специальным тарифам), необходимо расширить тариф.
JSON
{"status":"ERROR","value":"TIME_LIMIT_EXCEED"}
TEXT
ERROR|TIME_LIMIT_EXCEED
Разобрались? Скорее пробовать :)