Русский
EnglishТочка входа: https://ваш_домен/api/userapi/v1/ + метод API
Для авторизации, необходимо отправлять в заголовках запросов к API информацию, полученную ранее в разделе "API":
API-LOGIN — API-логин
API-KEY — API-ключ
API-LANG — необязательный параметр языка. Пример: ru_RU, en_US.
Параметры запроса отправляются методом POST, ответ возвращается в формате json.
Пример ответа на запрос:
Array
(
[error] => 0 //код ошибки
[error_text] => //текст ошибки
[data] => Array
(
//данные
)
)
Точка входа: https://ваш_домен/api/userapi/v1/ + метод API
Методы работы с API:
test
Tестовый метод для проверки работы API.
Параметры запроса:
—
Ответ:
ip — ваш ip-адрес
user_id — id пользователя (если обращается система — id = 0)
get_direction_currencies
Получение списка валют, доступных для обмена
Параметры запроса:
currency_id_give — id валюты отдаю (фильтр, необязательный параметр)
currency_id_get — id валюты получаю (фильтр, необязательный параметр)
Ответ:
В ответе 2 списка:
give — список валют отдаю
get — список валют получаю
В каждом списке содержатся следующие данные:
id — id валюты в обменнике
title — название валюты в обменнике
logo — ссылка на логотип валюты
get_directions
Получение списка направлений обменов, доступных для обмена
Параметры запроса:
currency_id_give — id валюты отдаю (фильтр, необязательный параметр)
currency_id_get — id валюты получаю (фильтр, необязательный параметр)
Ответ:
В ответе список направлений обмена, в нем:
direction_id — id направления обмена в обменнике
currency_give_id — id валюты отдаю в обменнике
currency_give_title — название валюты отдаю в обменнике
currency_give_logo — логотип валюты отдаю в обменнике
currency_get_id — id валюты получаю в обменнике
currency_get_title — название валюты получаю в обменнике
currency_get_logo — логотип валюты получаю в обменнике
get_direction
Получение информации о направлении обмена
Параметры запроса:
direction_id — id направления обмена
Ответ:
id — id направления обмена в обменнике
url — ссылка на страницу обмена
currency_span_give — код валюты отдаю
currency_span_get — код валюты получаю
reserve — резерв
course_give — курс отдаю
course_get — курс получаю
sum_give — сумма отдаю
sum_give_com — сумма отдаю с комиссией
sum_get — сумма получаю
sum_get_com — сумма получаю с комиссией
com_give — текст комиссии отдаю
com_get — текст комиссии получаю
min_give — минимальная сумма отдаю, no — не установлена
max_give — максимальная сумма отдаю, no — не установлена
min_get — макс сумма отдаю, no — не установлена
max_get — макс сумма отдаю, no — не установлена
info
timeline_text — описание обмена
frozen_text — текст замороженного статуса
before_button_text — текст до кнопки оплатить
give_fields — список полей, относящихся к валюте отдаю
get_fields — список полей, относящихся к валюте получаю
dir_fields — список полей направления обмена
Описание поля:
name — название для передачи
type — тип поля
label — описание поля
req — 0 необязательно передавать, 1 обязательно передавать
tooltip — текст подсказки
options — возможные опции, если поле имеет тип sеlect
cd — указатель дополнительных параметров
get_calc
Калькулятор сумм для направления обмена
Параметры запроса:
direction_id — id направления обмена
calc_amount — сумма
calc_action — принадлежность суммы: 1 — сумма отдаю, 2 — сумма получаю, 3 — сумма отдаю с комиссией, 4 — сумма получаю с комиссией
cd — поля из направления обмена, с пометкой cd=1, в одном поле. Поле обработано URL enspan.
Ответ:
currency_span_give — код валюты отдаю
currency_span_get — код валюты получаю
reserve — резерв
course_give — курс отдаю
course_get — курс получаю
sum_give — сумма отдаю
sum_give_com — сумма отдаю с комиссией
sum_get — сумма получаю
sum_get_com — сумма получаю с комиссией
com_give — текст комиссии отдаю
com_get — текст комиссии получаю
min_give — минимальная сумма отдаю, no — не установлена
max_give — максимальная сумма отдаю, no — не установлена
min_get — макс сумма отдаю, no — не установлена
max_get — макс сумма отдаю, no — не установлена
changed — флаг изменения вводимой суммы: 0 — не нужно изменять, 1 — нужно изменить
get_exchanges
Вывод заявок, созданных данным ключом
Параметры запроса:
start_time — unix-время с которого выводить заявки (фильтр, необязательный параметр)
end_time — unix-время до которого выводить заявки (фильтр, необязательный параметр)
ip — ip-адрес (фильтр, необязательный параметр)
id — id заявки (фильтр, необязательный параметр)
api_id — id, переданное в API (фильтр, необязательный параметр)
status_history — выводить ли историю статусов: 0 — нет, 1 — да (фильтр, необязательный параметр)
limit — количество выводимых заявок (фильтр, необязательный параметр)
Ответ:
items — список заявок
id — id заявки
api_id — id, переданное в API
time — время изменения статуса
date — дата изменения статуса
psys_give — ПС отдаю
psys_get — ПС получаю
currency_span_give — код валюты отдаю
currency_span_get — код валюты получаю
course_give — курс отдаю
course_get — курс получаю
amount_give — сумма отдаю
amount_get — сумма получаю
exchange_success — 0 — заявка выполнена, 1 — заявка не выполнена
user_hash — хэш пользователя
user_ip — ip пользователя
status — статус заявки
statuses — список изменения статусов
time — время изменения статуса
date — дата изменения статуса
status — статус заявки
create_bid
Cоздание заявки
Параметры запроса:
direction_id — id направления обмена
partner_id — id партнера (необязательный параметр)
api_id — id заявки в вашей системе (необязательный параметр)
calc_amount — сумма обмена
calc_action — принадлежность суммы: 1 — сумма отдаю, 2 — сумма получаю, 3 — сумма отдаю с комиссией, 4 — сумма получаю с комиссией
account1 — cо счета
cfgive8 — имя владельца карты
account2 — на счет
cf1-99 — кастомные поля
Примеры полей:
cf3 — Фамилия
cf1 — Имя
cf2 — Отчество
cf4 — Телефон
cf6 — E-mail
cf5 — Skype
cf8 — Номер паспорта
cf10 — Регион
cf11 — Telegram
Ответ:
url — ссылка на страницу обмена
id — id заявки
hash — hash заявки
status — статус
api_actions — опции
type — тип оплаты
cancel — способ отмены заявки
api — методом апи
disabled — отключено
ссылка на отмену
pay — способ оплаты
api — методом апи
disabled — отключено
ссылка на отмену
instruction — инструкция по оплате
cancel_bid
Отмена заявки
Параметры запроса:
hash — хэш заявки
Ответ:
статус заявки
pay_bid
Отметка заявки оплаченной
Параметры запроса:
hash — хэш заявки
Ответ:
статус заявки
