Kopeechka.com REST API

https://api.blockchain.com/v3/exchange/specification.yaml

Introduction

Welcome to BKopeechka.com's API and developer documentation.
These documents detail and give examples of various functionality offered by the API such as receiving real time market data, requesting balance information and performing trades.

To Get Started

Create or log into your existing Blockchain.com Exchange account
Select API from the drop down menu
Fill out form and click “Create New API Key Now”
Once generated you can view your keys under API Settings.
Please be aware that the API key can only be used once it was verified via email.

Servers
Версия АПИ:
Тип ответа с сервера:

Базовые запросы

GET /запрос баланса
http://api.kopeechka.store/user-balance?token=$TOKEN&type=&TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$TYPE - What type of response do you expect to see (JSON/TEXT) ((by default JSON)

Responses

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Result of your request will be here

Server possible responses

Success✅ Description
OK

Success

Media type
{"status":"OK","balance":YOUR_BALANCE}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}

Работа с почтой

GET /запрос почты
http://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&sender=$SENDER&regex=$REGEX&token=$TOKEN&soft=$SOFT_ID&investor=$INVESTOR&type=$ANSWER_TYPE&subject=$SUBJECT&clear=$CLEAR&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$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


Виды почт, цены

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$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 - используется разработчиками в реферальной программе.

$INVESTOR - Укажите 1, если вам необходимо, чтобы почты брались не из общей базы, а из ваших собственных заливов (через Telegram бота.

$ANSWER_TYPE - Какой тип ответа желаете получить (JSON/TEXT) (по умолчанию JSON)

$SUBJECT - Укажите, если хотите получить письмо с определенной темой (достаточно одного слова). Является приоритетным. Если указанного слова в теме не будет - письмо НЕ ВЫДАСТ! Например: тема "Для регистрации аккаунта Facebook", в параметре укажите "регистрации" - найдет нужное письмо. Если вы укажете в параметре "активации" - письмо не выдаст

$CLEAR - Укажите в параметре 1, если хотите получать почтовые ящики, которые не содержат в себе знаки: - . _ .

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Code Details
--
Response body
Result of your request will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","id":$TASK_ID,"mail":"$MAIL"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
BAD_SITE

Вы неверно указали сайт

Media type
{"status":"ERROR","value":"BAD_SITE"}
BAD_DOMAIN

Такого домена/доменной зоны у нас нет

Media type
{"status":"ERROR","value":"BAD_DOMAIN"}
BAD_BALANCE

Недостаточно средств для совершения операции

Media type
{"status":"ERROR","value":"BAD_BALANCE"}
OUT_OF_STOCK

Нет почты с такими настройками. Попробуйте изменить $MAIL_TYPE или напишите в поддержку - попробуем добавить ящики

Media type
{"status":"ERROR","value":"OUT_OF_STOCK"}
SYSTEM_ERROR

Неизвестная, системная ошибка. Обратитесь в поддержку - поможем!

Media type
{"status":"ERROR","value":"SYSTEM_ERROR"}
TIME_LIMIT_EXCEED

Достигнут лимит заказов почт в секунду (относится к специальным тарифам), необходимо расширить тариф.

Media type
{"status":"ERROR","value":"TIME_LIMIT_EXCEED"}
GET /запрос письма
http://api.kopeechka.store/mailbox-get-message?full=$FULL&id=$TASK_ID&token=$TOKEN&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$FULL - Укажите 1, если вам нужно вернуть полное сообщение, а не только ссылку (иногда нужно для экономии трафика).

$TASK_ID - ID активации, к которой мы должны получить сообщение.

$TYPE - Укажите, в каком виде отдать вам письмо (JSON (по умолчанию) / TEXT (тело письма в чистом виде) )

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","value":"ВАША_ССЫЛКА","fullmessage":"ПОЛНОЕ_СООБЩЕНИЕ(ПО_ЗАПРОСУ)"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
WAIT_LINK

Письмо ещё не получено

Media type
{"status":"ERROR","value":"WAIT_LINK"}
NO_ACTIVATION

Неверно указали $TASK_ID активации

Media type
{"status":"ERROR","value":"NO_ACTIVATION"}
ACTIVATION_CANCELED

Почта была отменена

Media type
{"status":"ERROR","value":"ACTIVATION_CANCELED"}
GET /отменить почту
http://api.kopeechka.store/mailbox-cancel?id=$TASK_ID&token=$TOKEN&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TASK_ID - ID активации, к которой мы должны получить сообщение.

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
ACTIVATION_CANCELED

Активация уже отменена. Закажите повторно

Media type
{"status":"ERROR","value":"ACTIVATION_CANCELED"}
NO_ACTIVATION

Неверно указали $TASK_ID активации

Media type
{"status":"ERROR","value":"NO_ACTIVATION"}
GET /повторный запрос активации с этой почтой
http://api.kopeechka.store/mailbox-reorder?site=$SITE&email=$EMAIL&regex=$REGEX&token=$TOKEN&type=$TYPE&subject=$SUBJECT&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$SITE - Сайт, с которым вы работаете

$EMAIL - Почта, для которой нужно получить повторное письмо

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$REGEX - Укажите регулярное выражение, чтобы спарсить информацию, если вам не нужно всё письмо

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

$SUBJECT - Укажите, если хотите получить письмо с определенной темой (достаточно одного слова). Является приоритетным. Если указанного слова в теме не будет - письмо НЕ ВЫДАСТ! Игнорирует время доставки письма (не актуально для собственных доменов). Вы сначала можете отправить письмо, а потом только сделать запрос. Например: тема "Для регистрации аккаунта Facebook", в параметре укажите "регистрации" - найдет нужное письмо, даже если оно было отправлено сильно раньше запроса. Если вы укажете в параметре "активации" - письмо не выдаст!

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","id":$TASK_ID,"mail":"$MAIL"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
NO_ACTIVATION

Активация не найдена

Media type
{"status":"ERROR","value":"NO_ACTIVATION"}
ACTIVATION_NOT_FOUND

Не получено первое письмо, повторная активация невозможна

Media type
{"status":"ERROR","value":"Activation not found"}
BAD_EMAIL

Запрашиваемая почта получила бан, стала неактивной

Media type
{"status":"ERROR","value":"BAD_EMAIL"}
SYSTEM_ERROR

Неизвестная, системная ошибка. Обратитесь в поддержку - поможем!

Media type
{"status":"ERROR","value":"SYSTEM_ERROR"}
GET /узнать ID активации по почте и сайту
http://api.kopeechka.store/mailbox-get-fresh-id?token=$TOKEN&site=$SITE&email=$EMAIL&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$SITE - Сайт, на который была направлена активация

$EMAIL- Почта в активации

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","id":"$TASK_ID"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
NO_ACTIVATION

Активация не найдена

Media type
{"status":"ERROR","value":"NO_ACTIVATION"}
GET /установить комментарий к заказанной почте
http://api.kopeechka.store/mailbox-set-comment?token=$TOKEN&id=$TASK_ID&comment=$TEXT&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$TASK_ID - ID активации, к которой добавляем комментарий.

$TEXT - Текст комментария (обязательно делаем URLENCODE, дабы предотвратить искажение данных)

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
NO_ACTIVATION

Активация не найдена

Media type
{"status":"ERROR","value":"NO_ACTIVATION"}
BAD_COMMENT

Активация не найдена

Media type
{"status":"ERROR","value":"BAD_COMMENT"}
GET /поиск активации ящика по параметрам
http://api.kopeechka.store/mailbox-get-bulk?token=$TOKEN&count=$COUNT&comment=$TEXT&email=$EMAIL&site=$SITE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

$COUNT - Количество возвращаемых активаций (по умолчанию 1).

$TEXT - Текст вашего комментария (обязательно делать URLENCODE, дабы избежать потерю данных).

$EMAIL - Почта, которую хотите найти.

$SITE - Сайт, по которому хотите найти почты.

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","count":$COUNT,"items":[{"id":$TASK_ID,"service":"$SERVICE","email":"$EMAIL","date":$DATE,"status":"$STATUS","value":$LINK,"comment":"$COMMENT"}]}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}

Работа с черными списками

GET /добавить домен в чёрный список
http://api.kopeechka.store/domain-add-blacklist?token=$TOKEN&domain=$DOMAIN&site=$SITE&expire=$EXPIRE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$EXPIRE - Если вам нужно, чтобы домен не выдавался какое-то время, а потом автоматически снова появился в выдаче - в параметре $EXPIRE укажите время в UNIXTIME, когда нам его удалить.

$SITE - Сайт, к которому относится чёрный список.

$DOMAIN - Домен, который добавляем в чёрный список.

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
BAD_SITE

Вы неверно указали сайт.

Media type
{"status":"ERROR","value":"BAD_SITE"}
BAD_DOMAIN

Такого домена/доменной зоны у нас нет.

Media type
{"status":"ERROR","value":"BAD_DOMAIN"}
GET /удалить домен из чёрного список
http://api.kopeechka.store/domain-exclude-blacklist?token=$TOKEN&domain=$DOMAIN&site=$SITE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$SITE - Сайт, к которому относится чёрный список.

$DOMAIN - Домен, который хотим удалить из чёрного списка.

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
BAD_SITE

Вы неверно указали сайт.

Media type
{"status":"ERROR","value":"BAD_SITE"}
BAD_DOMAIN

Такого домена/доменной зоны у нас нет.

Media type
{"status":"ERROR","value":"BAD_DOMAIN"}
BAD_DOMAIN

Данный домен не в чёрном списке.

Media type
{"status":"ERROR","value":"DOMAIN_NOT_IN_BLACK_LIST"}
GET /получить чёрный список
http://api.kopeechka.store/blacklist-get-service?token=$TOKEN&site=$SITE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$SITE - необязателен и указывается в случае, если вам нужно получить информацию по конкретному сайту, а не всё сразу.

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK"}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
BAD_SITE

Неверно указан сайт

Media type
{"status":"ERROR","value":"BAD_SITE"}

Работа со списками доменов

GET /получить список всех доменов сервиса
http://api.kopeechka.store/mailbox-get-domains?token=$TOKEN&site=$SITE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

$SITE - указывается в случае, если вам нужно получить список доменов исключив из него чёрный список по конкретному сайту.

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","count":3,"domains":["joiket.space","hurentio.site","jkejoket.space"]}
Errors❌ Description
BAD_TOKEN

Неверно указан токен

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
GET /получить популярные домены и зоны
http://api.kopeechka.store/mailbox-get-domains?token=$TOKEN&site=$SITE&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$TOKEN - Ваш API-ключ с сервиса kopeechka.store

Укажите параметр popular=1, если хотите получить все популярные домены с ценами.

Параметр zones=1 покажет вам все доменные зоны (с ценами), доступные для заказа на нашем сервисе.

Responses

Request URL

http://api.kopeechka.store/user-balance?token=&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","zones":[{"name":"host","cost":5},{"name":"icu","cost":5},{"name":"site","cost":5}]}
GET /узнать срок жизни домена
http://api.kopeechka.store/domain-get-alive?domain=$DOMAIN&type=$TYPE&api=2.0

Parameters
Обязательные параметры: Description

Let's create your request

$DOMAIN- Домен, срок жизни которого вы хотите узнать

$TYPE - Какой тип ответа желаете получить (JSON (по умолчанию) / TEXT)

Доменные зоны ML, TK, GQ, CF, GK, GA не имеют чётких сроков окончания и могут слететь в любой момент. Имейте это ввиду и берите их только для разовых активаций, как временную почту!

Responses

Request URL

http://api.kopeechka.store/domain-get-alive?domain=$DOMAIN&type=$TYPE&api=2.0

Server response

Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","alive":$ALIVE}
Errors❌ Description
BAD_DOMAIN

Домен указан неверно

Media type
{"status":"ERROR","value":"BAD_DOMAIN"}