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

Материал из TK
Перейти к: навигация, поиск
(Новая страница: «Если в .config-файле указаны параметры users-directory и devices-directory -…»)
 
 
(не показано 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>
Все методы, которые используют&nbsp;
 
  +
  +
В формате 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