http://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&sender=$SENDER®ex=$REGEX&token=$TOKEN&soft=$SOFT_ID&investor=$INVESTOR&no_search=$NO_SEARCH
Обратите внимание, что обязательными являются параметры $TOKEN,$SITE.
$SITE - Сайт, для которого вам нужна почта.
Можно указать несколько сайтов, через запятую (пример: vasya.ru,petya.com). С вас будет списана х2 сумма за ящик. Например вы берёте mail.ru для двух сайтов и платите не 5 коп, а 10 коп.
$MAIL_TYPE - Укажите тип почты (mail.ru, например), которую хотите получить. Если оставить пустым (или написать ALL) - будут выдаваться рандомные почты из НАШИХ ДОМЕНОВ.
$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 - Ваш токен, найти его можно в личном кабинете.
$INVESTOR - Укажите 1, если вам необходимо, чтобы почты брались не из общей базы, а из ваших собственных заливов (через Telegram бота.
ИЗМЕНЕНИЯ ОТ 22.02.2021
$NO_SEARCH - Укажите 1, если вам необходимо, чтобы поиск письма не начинался. Такое действие убережёт вашу "Карму" и не будет, в случае отмены, привязывать ящик к вам. Нужно в тех случаях, когда сайт может отвергнуть ваш email ещё до отправки письма и вы об этом узнаете. Для активации поиска воспользуйтесь этим запросом.
✅ Ответ:
{"status":"OK","id":$TASK_ID,"mail":"$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
Недостаточно средств для совершения операции.
Где $BALANCE - ваш баланс, а $COST - сколько необходимо заплатить.
Нет почты с такими настройками. Попробуйте изменить $MAIL_TYPE или напишите в поддержку - попробуем добавить ящики.
{"status":"ERROR","value":"Закончились почты \/\/ This domain is out of stock."}
Активация данного сайта ЗАПРЕЩЕНА на нашем сервисе (угадайте, какой сайт)
{"status":"ERROR","value":"This site is forbidden on our service."}
Количество отправителей не соответствует количеству регулярных выражений.
{"status":"ERROR","value":"count(aSenders) != count(aSites)"}
Это означает, что вы во первых указали два или более сайтов в $SITE, более того вы не хотите использовать настройки парсинга письма по умолчанию (отправитель / регулярное выражение). В таком случае вам НЕОБХОДИМО прописать такую настройку для каждого сайта соответственно (см. выше объяснения параметров $REGEX и $SENDER).
Количество регулярных выражений не соответствует количеству отправителей (см. объяснение выше).
{"status":"ERROR","value":"count(aRegexes) != count(aSites)"}
ИЗМЕНЕНИЯ ОТ 06.12.20
Системная ошибка. Попробуйте ещё раз (но лучше о такой сообщить в поддержку).
{"status":"ERROR","value":"ERROR_TRY_AGAIN"}
Сайт введён в неверном формате. Сделайте так: example.com
{"status":"ERROR","value":"Wrong site format. Do like 'example.com'!"}
Достигнут лимит заказов почт в секунду (относится к специальным тарифам), необходимо расширить тариф и ошибка уйдет.
{"status":"ERROR","value":"TIME_LIMIT_EXCEED"}
Разобрались? Скорее пробовать :)