AutoGRAPH.NET Service Login — различия между версиями
Admin (обсуждение | вклад) (Новая страница: «Если в .config-файле указаны параметры users-directory и devices-directory -…») |
Admin (обсуждение | вклад) |
||
(не показано 13 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
+ | Метод Login аутентифицирует пользователя по логину/паролю и возвращает токен, который используется во всех последующих запросах. |
||
− | Если в .config-файле указаны параметры [[AutoGRAPH.NET_Service|users-directory]] и [[AutoGRAPH.NET_Service|devices-directory]] - работа сервиса немного видоизменяется. Основные отличия приведены ниже. |
||
+ | == JSON == |
||
+ | Вызов: |
||
+ | <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] |
||
+ | |||
+ | Также возможно использование метода GET: |
||
+ | |||
+ | <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> |
||
+ | |||
+ | == WCF == |
||
+ | |||
+ | Определение: <code>string Login(string userName, string password, int? UTCOffset)</code> |
||
+ | |||
+ | *UTCOffset - смещение от UTC в минутах для расчётов (null - UTC) |
||
+ | |||
+ | Результат: |
||
+ | |||
+ | *в случае успешной аутентификации возвращается строка-токен |
||
+ | *в случае ошибочной аутентификации передается исключение UnauthorizedAccessException |
Текущая версия на 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