Правильная ссылка на эту статью: |
Интерфейсы сервиса Cash Exchanger
Интерфейс для секции P-2-P Exchanger¶
Метод ListActive - Получение списка активных заявок¶
Метод позволяет получить список заявок опубликованных на бирже p2p.exchanger.ru, с учетом параметров для фильтрации
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=ListActive
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+transportId+wmidSigner |
transportId | ID типа обмена | 1- wire, 2- sdp, 3 - reserved, 4 - p2p |
directionId | ID направления обмена | 1 - WMZ=>USD, 2 - WMR=>RUB, 5 - WMB=>BYR, 6 - WME=>EUR, 7 - USD=>WMZ, 8 - RUB=>WMR, 11 - BYR=>WMB, 12 - EUR=>WME |
cityId | ID города | |
amountGreater | сумма обмена не меньше чем amountGreater | null или -1 если не задан |
rateDirectGreater | прямой курс не меньше чем rateDirectGreater | null или -1 если не задан |
rateReverseGreater | обратный курс не меньше чем amountGreater | null или -1 если не задан |
out resultList | список заявок, выходной параметр | |
out error | описание ошибки, выходной параметр |
- возвращает true - если успешно завершен
Метод ListOwn - Получение списка своих заявок¶
Метод позволяет получить список собственных заявок на бирже p2p.exchanger.ru
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=ListOwn
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber + wmidSigner + status |
status | статус заявок для получения | [-1] - все заявки |
out resultList | список заявок, выходной параметр | |
out error | описание ошибки, выходной параметр |
- возвращает true - если успешно завершен
Метод New - Создание новой заявки (без публикации)¶
Создает новую заявку в секции p2p биржи Cash Exchanger, но не публикует в списках обмена
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=New
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+directionId+purseNum+amount+amountWant+insPrem+wmidSigner |
directionId | ID направления обмена | |
purseNum | кошелек | |
amount | сумма есть | |
amountWant | сумма надо | |
insPrem | сумма страхового взноса | |
maxTimeForExchange | время в течении которого должен произойти обмен | (24 часа по умолчанию) |
meetDateTime | время встречи | не меньше чем текущее время + 1 час, формат yyyyMMddHHmm |
address | место встречи, адрес | |
metro | место встречи, станция метро | |
cityId | ID города | |
description | дополнительная информация | |
out error | описание ошибки, выходной параметр | |
out offer | публичная оферта, выходной параметр | |
out uniqId | номер созданной заявки, выходной параметр |
- возвращает true - если успешно завершен
Метод Publish - Опубликовать заявку в списках¶
Публикация заранее созданной заявки в списках обмена
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=Publish
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+uniqId+wmidSigner |
uniqId | WMID подписчика | |
out error | описание ошибки, выходной параметр | |
out cmdGuid | GUID команды, выходной параметр (используется для проверки результата) |
- возвращает true - если успешно завершен
Метод PublishResult - Получить результаты публикации заявки¶
Получение результатов публикации
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=PublishResult
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+uniqId+cmdGuid+wmidSigner |
---|---|---|
uniqId | WMID подписчика | |
cmdGuid | GUID команды возвращенной методом Publish | |
out error | описание ошибки, выходной параметр | |
out validationErrors | ошибки публикации, выходной параметр | |
out status | статус заявки, выходной параметр |
- возвращает true - если успешно завершен
Метод GetIntentionsList - Получить список намерений на обмен по номеру заявки¶
Получить список намерений на обмен по выбранной заявке
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=GetIntentionsList
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber + appUniqId + wmidSigner |
---|---|---|
appUniqId | уникальный номер прямой заявки | |
out error | описание ошибки | |
out result | список намерений на обмен |
- возвращает true - если успешно завершен
Метод SendIntensions - Подать намерение на обмен¶
Подача намерения на обмен
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=SendIntensions
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+appUniqId+purseNumber+wmidSigner |
appUniqId | уникальный номер прямой заявки, на основе которой подается встречная | |
purseNumber | номер кошелька контрагента | |
out error | описание ошибки | |
out guid | guid команды на подачу встречной заявки |
- возвращает true - если успешно завершен
Метод CounterTrade - Инициализировать обмен на основе выбранного намерения¶
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=CounterTrade
Инициализация обмена на основе выбранного намерения на обмен (объединение прямой заявки и намерения)
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+appId+purseNumber+wmidSigner |
---|---|---|
appUniqId | уникальный номер прямой заявки, на основе которой подается встречная | |
purseNumber | номер кошелька контрагента | |
out error | описание ошибки | |
out guid | guid команды на подачу встречной заявки |
- возвращает true - если успешно завершен
Метод CounterTradeResult - Проверка результатов инициализации обмена¶
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=CounterTradeResult
название | описание | примечание |
reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
wmidSigner | WMID подписчика | |
sign | цифровая подпись | reqNumber+appId+purseNumber+wmidSigner |
---|---|---|
cmdGuid | GUID команды на подачу встречной заявки | |
uniqId | номер заявки | |
out error | описание ошибки | |
out status | статус заявки |
- возвращает true - если успешно завершен
Использование интерфейса для работы с секцией P-2-P Exchanger¶
Регистрация обменного пункта на сервисе Cash Exchanger¶
Чтобы использовать библиотеку или web-сервис, нужно иметь аттестат не ниже формального.
Также необходима регистрация на сервисе Cash Exchanger. Для этого нужно посетить одну из секций http://cash.exchanger.ru, авторизоваться своим WMID и добавить кошельки (предоставить доверие для WMID сервиса).
Генерация ключа для работы с тестовым приложением¶
После регистрации, необходимо сформировать XML-ключ на основе ключа от вашего Keeper WinPro.
Скачайте приложение для генерации ключа тут или на сайте разработчика.
Более подробно об использовании приложения, читайте в разделе WMSignerFX
В результате будет получен XML-ключ в следующем виде:
<RSAKeyValue> <Modulus>KEY PART 1</Modulus> <D>KEY PART 2</D> </RSAKeyValue>
Далее, необходимо данный XML-ключ сохранить в файле key.xml, который в дальнейшем будет указан для тестового приложения.
Тестовое приложение для работы с секцией p2p.exchanger.ru¶
Тестовое приложение, с открытыми исходными кодами доступно для скачивания на странице. В данном тестовом приложении приведены основные способы вызова веб-методов, для:
- получения списка доступных заявок
- получения списка своих заявок
- добавления намерения на обмен
- инициирования обмена на основе намерения