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