Для работы с приватным API необходима аутентификация с использованием секретного ключа выпущенного администратором в разделе "Настройки приложения" — "Настройка приватного API" — "Секретный ключ". Секретный ключ необходимо отправлять в HTTP заголовке "X-Authorization". Аутентификация может быть произведена с использованием нескольких разных ключей. Работа с API подразумевает отправку POST запроса на URL адрес нужного метода.
Вы можете полностью закрыть доступ или отключить некоторые методы приватного API в разделе "Настройки приложения" — "Настройка приватного API".
Пример успешного ответа:
{
"success": true,
"result": [
"data"
]
}
Пример неуспешного ответа:
{
"success": false,
"message": "Текст ошибки",
"result": false
}
Для смены локализации добавьте параметр "language" с двухбуквенный кодом языка в качестве значения. По умолчанию используется язык, который установлен в разделе "Настройки приложения" — "Настройка языка".
При использовании приватного API, скрипт перезаписывает стандартные значения заголовков сервера, устанавливая секретный ключ вместо IP адреса с которого был отправлен запрос, код страны будет содержать значение "API".
Метод:
/private-api-create-order
Пример запроса:
curl -X POST 'https://demo.exchanger-cms.com/private-api-create-order' \
--header 'X-Authorization: **********' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'slug=eth-usdt' \
--data-urlencode 'send_amount=0.25' \
--data-urlencode 'receive_detail=0x470487bcB944B0aB2daD52832ba9816EB45F7E40' \
--data-urlencode '[email protected]'
Параметры запроса:
| Параметр | Описание |
|---|---|
| slug | Строка идентификатор направления обмена |
| send_amount | Отдаваемая сумма |
| send_detail | Реквизиты отдаваемой валюты |
| receive_detail | Реквизиты получаемой валюты |
| destination_tag | Тег назначения |
| first_name | Имя |
| middle_name | Среднее имя |
| last_name | Фамилия |
| Электронная почта | |
| phone | Номер телефона |
| passport | Номер паспорта |
| country | Страна |
| city | Город |
| adress | Адрес |
| passphrase | Кодовая фраза |
| url | URL адрес |
| comment | Комментарий |
| date | Дата |
| time | Время |
| telegram | Telegram |
| skype | Skype |
| viber | Viber |
| messenger | Messenger |
| discord | Discord |
| snapchat | Snapchat |
Необходимо отправлять только обязательные к заполнению поля для конкретного направления обмена.
Пример ответа:
{
"success": true,
"result": [
"d1452741b566ac680fc93d297435b0e0",
"0xea674fdde714fd979de3edf0f56aa9716b898ec8"
]
}
Обработка ответа:
| # | Описание |
|---|---|
| 0 | Токен |
| 1 | Реквизиты или ссылка для оплаты |
Метод:
/private-api-create-reserve-request
Пример запроса:
curl -X POST 'https://demo.exchanger-cms.com/private-api-create-reserve-request' \
--header 'X-Authorization: **********' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'currency_id=52' \
--data-urlencode 'amount=1000' \
--data-urlencode '[email protected]'
Параметры запроса:
| Параметр | Описание |
|---|---|
| currency_id | Идентификатор валюты |
| amount | Сумма |
| Электронная почта |
Пример ответа:
{
"success": true,
"result": [
22
]
}
Обработка ответа:
| # | Описание индекса |
|---|---|
| 0 | Идентификатор |
Метод:
/private-api-create-review
Пример запроса:
curl -X POST 'https://demo.exchanger-cms.com/private-api-create-review' \
--header 'X-Authorization: **********' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'name=Роман' \
--data-urlencode 'text=Спасибо за быстрый обмен!' \
--data-urlencode '[email protected]'
Параметры запроса:
| Параметр | Описание |
|---|---|
| name | Имя пользователя |
| text | Текст |
| Электронная почта |
Пример ответа:
{
"success": true,
"result": [
123
]
}
Обработка ответа:
| # | Описание |
|---|---|
| 0 | Идентификатор |
Метод:
/private-api-create-user
Пример запроса:
curl -X POST 'https://demo.exchanger-cms.com/private-api-create-user' \
--header 'X-Authorization: **********' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'login=user' \
--data-urlencode '[email protected]' \
--data-urlencode 'password=qwerty123456' \
--data-urlencode 'api=1'
Параметры запроса:
| Параметр | Описание |
|---|---|
| login | Логин (необязательно) |
| Электронная почта | |
| password | Пароль |
| api | Выпустить токен для API пользователя (необязательно, 1 - да, 0 - нет) |
Пример ответа:
{
"success": true,
"result": [
4,
"1a4b3e3c6bebceebf8a86d2f006b9a3b",
"7544d0a932d14a402ac07595e15edb35"
]
}
Обработка ответа:
| # | Описание |
|---|---|
| 0 | Идентификатор |
| 1 | Токен подтверждения регистрации |
| 2 | Токен API пользователя |