Kopeechka.com REST API

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

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.

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

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

GET /запрос баланса
https://api.kopeechka.store/user-balance?token=$TOKEN&cost=$COST&type=&TYPE&api=2.0
Обязательные параметры: Description

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

required

$COST - выберите удобную валюту (RUB (by default) / USD)

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

Responses

https://api.kopeechka.store/user-balance?token=$TOKEN&cost=$COST&type=&TYPE&api=2.0
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 /запрос почты
https://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&token=$TOKEN&password=$PASSWORD&regex=$REGEX&subject=$SUBJECT&investor=$INVESTOR&soft=$SOFT_ID&type=$TYPE&api=2.0

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

Let's create your request

$SITE - Сайт, для которого вам нужна почта.

required

$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

required

$PASSWORD - Укажите 1, если вам нужен пароль к почте для

WEBMAIL

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

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

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

$SOFT_ID - используется разработчиками в реферальной программе.

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

Responses

Request URL

https://api.kopeechka.store/mailbox-get-email?site=$SITE&mail_type=$MAIL_TYPE&token=$TOKEN&password=$PASSWORD&regex=$REGEX&subject=$SUBJECT&investor=$INVESTOR&soft=$SOFT_ID&type=$TYPE&api=2.0
Code Details
Response body
Result of your request will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","id":$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 /запрос письма
https://api.kopeechka.store/mailbox-get-message?id=$ID&token=$TOKEN&full=$FULL&type=$TYPE&api=2.0

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

Let's create your request

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

required

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

required

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

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

Responses

Request URL

https://api.kopeechka.store/mailbox-get-message?id=$ID&token=$TOKEN&full=$FULL&type=$TYPE&api=2.0
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

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

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

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

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

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

Let's create your request

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

required

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

required

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

Responses

Request URL

https://api.kopeechka.store/mailbox-cancel?id=$ID&token=$TOKEN&type=$TYPE&api=2.0
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

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

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

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

Let's create your request

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

required

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

required

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

required

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

$PASSWORD - Укажите 1, если вам нужен пароль к почте для

WEBMAIL

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

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

Responses

Request URL

https://api.kopeechka.store/mailbox-reorder?site=$SITE&email=$EMAIL&token=$TOKEN&password=$PASSWORD&subject=$SUBJECT&regex=$REGEX&type=$TYPE&api=2.0
Parameters Details
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","id":$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 активации по почте и сайту
https://api.kopeechka.store/mailbox-get-fresh-id?site=$SITE&email=$EMAIL&token=$TOKEN&type=$TYPE&api=2.0

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

Let's create your request

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

required

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

required

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

required

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

Responses

Request URL

https://api.kopeechka.store/mailbox-get-fresh-id?site=$SITE&email=$EMAIL&token=$TOKEN&type=$TYPE&api=2.0
Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

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

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

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

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

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

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

GET /Получить наши домены
https://api.kopeechka.store/mailbox-get-domains

Responses

Request URL

https://api.kopeechka.store/mailbox-get-domains
Parameters Details
--
Response body
Parametersrequest will be here
Success✅ Description
OK

Success

Media type
{"status":"OK","count":39,"domains":["casiwo.info","gijurob.info","jukeiot.xyz"]}
Errors❌ Description
BAD_TOKEN

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

Media type
{"status":"ERROR","value":"BAD_TOKEN"}
GET /Получить популярные домены
https://api.kopeechka.store/mailbox-zones?popular=1&site=$SITE&cost=$COST

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

Let's create your request

$COST - выберите удобную валюту (RUB (by default) / USD)

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

Responses

Request URL

https://api.kopeechka.store/mailbox-zones?popular=1&site=$SITE&cost=$COST
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}]}