AutoGRAPH.NET Service Login — различия между версиями

Материал из TK
Перейти к: навигация, поиск
Строка 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:8300/Login]</code>
+
<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&nbsp;''<small><span style="background-color:#FFFF00;">протокол устарел и не рекомендуется к использованию. Будет удалён с 01.06.2020</span></small>'' ==
 
== WCF&nbsp;''<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