AutoGRAPH.NET Service Login — различия между версиями
Admin (обсуждение | вклад) (→JSON) |
Admin (обсуждение | вклад) |
||
| (не показано 7 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
| − | Если в .config-файле указаны параметры [[AutoGRAPH.NET_Service|users-directory]] и [[AutoGRAPH.NET_Service|devices-directory]] - работа сервиса немного видоизменяется. '''[[AutoGRAPH.NET_Service_Auth|Логика работы описана здесь]]'''. |
||
| − | |||
Метод Login аутентифицирует пользователя по логину/паролю и возвращает токен, который используется во всех последующих запросах. |
Метод Login аутентифицирует пользователя по логину/паролю и возвращает токен, который используется во всех последующих запросах. |
||
| − | == |
+ | == JSON == |
| + | Вызов: |
||
| − | Определение: |
||
| + | |||
| − | <code>string Login(string userName, string password)</code> |
||
| + | <code>[http://localhost/ServiceJSON/Login http://localhost/ServiceJSON/Login]</code> |
||
| + | |||
| + | В формате JSON в тело POST передается логин и пароль (и необязательный параметр UTCOffset, в котором передается с каким смещением от UTC будут возвращаться данные - в минутах): |
||
| + | |||
| + | <code>{"UserName": "demo", "Password":"demo"}</code> |
||
| + | |||
| + | <code>{"UserName": "demo", "Password":"demo", "UTCOffset": 300}</code> |
||
Результат: |
Результат: |
||
*в случае успешной аутентификации возвращается строка-токен |
*в случае успешной аутентификации возвращается строка-токен |
||
| − | *в случае ошибочной аутентификации |
+ | *в случае ошибочной аутентификации возвращается пустая строка и HTTP Status Code = 403. |
| + | Посмотреть пример на [http://dojo.telerik.com/@Denisio/IBaXIZ/3 Kendo UI Dojo] |
||
| − | == JSON == |
||
| + | Также возможно использование метода GET: |
||
| − | Вызов (<span class="marker">внимание! используется метод POST </span>): |
||
| − | <code>http://localhost: |
+ | <code><font face="monospace">[http://localhost/ServiceJSON/Login?UserName=demo&Password=demo http://localhost/ServiceJSON/Login?UserName=demo&Password=demo]</font></code> |
| + | <code><font face="monospace">[http://localhost/ServiceJSON/Login?UserName=demo&Password=demo&UTCOffset=300 http://localhost/ServiceJSON/Login?UserName=demo&Password=demo&UTCOffset=300]</font></code> |
||
| − | В формате JSON в тело POST передается логин и пароль: |
||
| + | == WCF == |
||
| − | <code>{"UserName": "demo", "Password":"demo"}</code> |
||
| + | |||
| + | Определение: <code>string Login(string userName, string password, int? UTCOffset)</code> |
||
| + | |||
| + | *UTCOffset - смещение от UTC в минутах для расчётов (null - UTC) |
||
Результат: |
Результат: |
||
*в случае успешной аутентификации возвращается строка-токен |
*в случае успешной аутентификации возвращается строка-токен |
||
| − | *в случае ошибочной аутентификации |
+ | *в случае ошибочной аутентификации передается исключение UnauthorizedAccessException |
| − | |||
| − | Посмотреть пример на [http://dojo.telerik.com/@Denisio/IBaXIZ/3 Kendo UI Dojo] |
||
Текущая версия на 12:05, 29 мая 2020
Метод Login аутентифицирует пользователя по логину/паролю и возвращает токен, который используется во всех последующих запросах.
JSON
Вызов:
http://localhost/ServiceJSON/Login
В формате JSON в тело POST передается логин и пароль (и необязательный параметр UTCOffset, в котором передается с каким смещением от UTC будут возвращаться данные - в минутах):
{"UserName": "demo", "Password":"demo"}
{"UserName": "demo", "Password":"demo", "UTCOffset": 300}
Результат:
- в случае успешной аутентификации возвращается строка-токен
- в случае ошибочной аутентификации возвращается пустая строка и HTTP Status Code = 403.
Посмотреть пример на Kendo UI Dojo
Также возможно использование метода GET:
http://localhost/ServiceJSON/Login?UserName=demo&Password=demo
http://localhost/ServiceJSON/Login?UserName=demo&Password=demo&UTCOffset=300
WCF
Определение: string Login(string userName, string password, int? UTCOffset)
- UTCOffset - смещение от UTC в минутах для расчётов (null - UTC)
Результат:
- в случае успешной аутентификации возвращается строка-токен
- в случае ошибочной аутентификации передается исключение UnauthorizedAccessException
