Перед началом
Добро пожаловать в официальную документацию Exchange24Crypto_bot API.
Что бы использовать API, Вам нужен API key. Свяжитесь с нами https://t.me/official_support24crypto что бы его получить.
Авторизация
Exchange24Crypto_bot API ожидает получить в параметрах каждого вашего запроса apiKey.
apiKey - ваш публичный ключ;
Пример кода на Python:
import requests
params = {
'apiKey': 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
}
response = requests.post('https://barbaris100.online/api/?balance', params=params)
Пример Curl command:
curl 'https://barbaris100.online/api/?balance' \
--data 'apiKey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
В ответ, Вам всегда возвращается JSON строка, в которой имеется обьязательные поля:
status может быть ok и error
При статусе ok возвращается поле data в котором находится ответ на запрос
{
"status":"ok",
"data":{
"id":1
}
}
При статусе error возвращается полеerror в котором находится сообщение об ошибке
{"status":"error","error":"Order already processed"}
Проверка баланса
Чтобы узнать баланс, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?balance
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
Ответ data
| Поле | Тип | Описание |
|---|---|---|
| balance | Integer | Баланс |
Создание заявки с криптовалютой
Чтобы создать новую заявку, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?new-order-crypto
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
| amount | Integer | Да | Сумма обмена. |
| type_fiat | String | Да | Тип оплаты (CARD, SBP) |
| cryptocurrency | String | Да | Криптовалюта (BTC, LTC) |
| cryptocurrency_wallet | String | Да | Крипто-адрес. |
| callback_url | String | Нет | На этот адрес вы получите пустой GET запрос как только средства будут зачислены |
Ответ data
| Поле | Тип | Описание |
|---|---|---|
| orderId | Integer | ID Вашей заявки в системе. |
| amountExc | Integer | Сумма которую нужно первести |
| amountCrypto | Float | Сумма которую получите в криптовалюте |
| paymentData | Long | Реквизиты. |
| bank | String | Банк (Возвращается , когда type_fiat равен SBP) |
Создание заявки (Баланс ЛК)
Чтобы создать новую заявку, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?new-order
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
| amount | Integer | Да | Сумма обмена. |
| type_fiat | String | Да | Тип оплаты (CARD, SBP) |
| callback_url | String | Нет | На этот адрес вы получите пустой GET запрос как только средства будут зачислены |
Ответ data
| Поле | Тип | Описание |
|---|---|---|
| orderId | Integer | ID Вашей заявки в системе. |
| amountExc | Integer | Сумма которую нужно первести |
| paymentData | Long | Реквизиты. |
| bank | String | Банк (Возвращается , когда type_fiat равен SBP) |
Получение списка заявок
Чтобы получить список заявок, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?get-orders
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
| status | String | Нет |
Статуст заявки: waiting: Заявка ожидает оплаты или подвержденияconfirmed: Заявка подтвержденаdeclined: Заявка отклонена
|
| offset | Integer | Нет | Отступ, пропуск указанного количества строк |
Ответ data
| Поле | Тип | Описание |
|---|---|---|
| id | Integer | ID заявки |
| type | String | Тип заявки |
| status | String | Статус заявки |
| amount_exchange | Integer | Сумма к получению |
| amount_without_com | Integer | Сумма без комиссии |
| amount_with_com | Integer | Сумма с комиссией |
| date | String | Дата создание заявки |
| date_processing | String | Дата обработки заявки |
Проверка статуса заявки
Чтобы проверить заявку, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?check-order
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
| orderId | Integer | Да | ID Вашей заявки |
Ответ data
| Поле | Тип | Описание |
|---|---|---|
| status | String | Статус заявки |
| Cтатус | Описание |
|---|---|
| waiting | Заявка ожидает оплаты или подверждения |
| confirmed | Заявка подтверждена |
| declined | Заявка отклонена |
| timeout | Вышло время на оплату заявки |
| error | Ошибка |
Отмена заявки
Чтобы отменить заявку, Вам нужно сделать вызов следующего адреса, с параметрами (POST) :
https://barbaris100.online/api/?cancel-order
Параметры
| Поле | Тип | Обьязательный | Описание |
|---|---|---|---|
| apiKey | String | Да | Ваш API key. |
| orderId | Integer | Да | ID Вашей заявки |
Ответ status
| Поле | Тип | Описание |
|---|---|---|
| status | String | Статус заявки (ok или error) |
Ошибки
Вы можете получить следующий текст ошибок
| Текст ошибки | Описание |
|---|---|
| Api Key field is empty |
Вы не передали API ключ
|
| Api key invalid |
Некорректный API ключ
|
| Api key disabled |
API ключ отключён
|
| Method disabled | Метод отключён |
| Invalid amount | Некорректная сумма обмена |
| Invalid type fiat | Некорректная тип оплаты |
| Minimum exchange amount {amount} | Сумма обмена меньше, чем минимальный порог |
| Maximum exchange amount {amount} | Сумма обмена больше, чем максимальный порог |
| No requisites available | Нет доступных реквизитов |
| Error creating order | Ошибка при создании заявки |
| Invalid crypto currency | Неверная криптовалюта |
| Invalid crypto address | Неверный крипто-адрес |
| Invalid callback URL | Некорректный callback URL |
| Invalid ID | Некорректный ID заявки |
| Access is denied | Доступ закрыт |
| Order already processed | Заявка уже обработана |
| No data | Данных нет |