wmkapi::SimpleAuth
Методы сервиса позоволяют создать сессию для работы с WmkApi и получить SharedSecret для клиентского приложения.
The following operations are supported. For a formal definition, please review the Service Description.
-
Authenticate
Аутентификация указанной сессии пользователем login при помощи своих password и SharedSecret (нужно получить при первом запуске приложения и сохранить).
- authHash = MD5.GetHash(login.ToLower() + ":" + sharedSecret.ToLower() + ":" sessionId.ToLower())
-
AuthenticateWebApp
authHash = WmSign(serviceWmid + ";" + loginTicket) -
AuthenticateWebAppEx
authHash = WmSign(serviceWmid + ";" + loginTicket+ ";" + userHostAddress) -
AuthenticateWithOptions
Аутентификация (с опциями) указанной сессии пользователем login при помощи своих password и SharedSecret (нужно получить при первом запуске приложения и сохранить).
- authHash = MD5.GetHash(login.ToLower() + ":" + sharedSecret.ToLower() + ":" sessionId.ToLower())
Опции
- Locale: 1049 - ru-RU, 1033 - en-US и так далее
- Version: для 1.9.2 будет 1902
- Tag: можно передать что-то дополнительно
-
EndSession
Завершение существующей сессии
- ExpireSession
-
GetSharedSecret
Получение «общего секрета», без него нельзя будет создать рабочую сессию для использования WmkApi
Применять:
- Для вызова метода Authenticate
Параметры:
- sessionId – должен быть получен методом NewSessionWithCaptcha или NewSessionWithCaptchaEx
- code – значение, присланное в SMS-сообщении, после вызова успешного выполнения метода RequestActivationCode
-
GetWmidsToAttach
Если список не пустой, то в нем содержится один или более Wmid (найденных по переданному ранее логину), которые еще не управляются этим API, но которым отправлено WM-сообщение с ссылкой на активацию приложения. -
NewSession
Создание новой сессии для работы с WmkApi
Применять:
- Для вызова метода Authenticate
-
NewSessionForServerApp
Создает новую сессию для серверного приложения
Применять:
- Для вызова метода RequestActivationCodeForServerApp или RequestSignUpCodeForServerApp
-
NewSessionWithCaptcha
Создает новую сессию и возвращает Captcha-картинку (*.png) как массив байт в Base64
Применять:
- Для вызова метода RequestActivationCode
Параметры:
- width – ширина картинки
- height – высота картинки
-
NewSessionWithCaptchaEx
Создает новую сессию и возвращает Captcha-картинку (*.png) как массив байт в Base64
Применять:
- Для вызова метода RequestActivationCode
Параметры:
- width – ширина картинки
- height – высота картинки
- bgcolor– цвет фона в ARGB()
-
RequestActivationCode
Запрос OTP-кода для получения SharedSecret (см. метод GetSharedSecret)
Параметры:
- sessionId — должен быть получен методом NewSessionWithCaptcha или NewSessionWithCaptchaEx
- captcha значение, введенное пользователем
Как обрабатывать код возврата:
- 0 - все прошло успешно:
- Код активации будет прислан в SMS-сообщении на номер телефона, указанный в аккануте WebMoney Keeper Mini
- Когда код получен можно вызывать метод GetSharedSecret
- Другие значения:
- Получить описание ошибки при помощи метода GetErrorDesc
-
RequestActivationCodeForServerApp
Запрос OTP-кода для получения SharedSecret (см. метод GetSharedSecret)
Параметры:
- sessionId — должен быть получен методом NewSessionForServerApp
- sign - hash(string.Format("{0}:{1}:{2}", login, appSecret, sessionId).ToLower())
Как обрабатывать код возврата:
- 0 - все прошло успешно:
- Код активации будет прислан в SMS-сообщении на номер телефона, указанный в аккануте WebMoney Keeper Mini
- Когда код получен можно вызывать метод GetSharedSecret
- Другие значения:
- Получить описание ошибки при помощи метода GetErrorDesc