CASHDESK API:Авторизация на сервере ЖКХ: различия между версиями

Текущая версия на 12:53, 1 июня 2022

CASHDESK API

API (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.

Для работы с API сервиса Касса ЖКХ, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2.

Авторизация на сервере ЖКХ

Для начала работы в приложении Касса ЖКХ необходимо прописать на сервере учетную запись.

Запрос	POST
URL: https://<URL-адрес сервера>/OAuth/token	https://<URL-адрес сервера>/OAuth/token

Request Body

type: x-www-form-urlencoded

grant_type: передать значение "password"'
username: логин учетной записи, передается в формате 7xxxxxxxxxx
password: пароль, передается в виде зашифрованного хэш -> SHA-256 -> base64 urlencoded
client_id: передать значение "communal-rest-client"
client_secret: передать значение "communal-rest-client"

 "grant_type" : "password",
 "username" : "7xxxxxxxxxx",
 "password" : "asdaldfkhj34o.......kljslkfas=",
 "client_id" : "communal-rest-client",
 "client_secret" : "communal-rest-client"

Обратите внимание

Пароль передается в виде хэш суммы. Необходимо зашифровать пароль при помощи алгоритма SHA256 и затем закодировать полученные данные по стандарту Вase64 urlencoded.
При вводе пароля, в конце поставить знак = (без пробела), без этого запрос будет считаться неверным.

@@ Строка 3: / Строка 3: @@
 '''API''' (Application Programming Interface или интерфейс программирования приложений) — это совокупность инструментов и функций в виде интерфейса для создания новых приложений, благодаря которому одна программа будет взаимодействовать с другой.
-Для работы с API сервиса БИФИТ Касса, пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2. С инструкцией авторизации по API можно ознакомиться <b>[https://kassa.bifit.com/wiki/index.php?title=ИНСТРУКЦИИ:Авторизация_при_интеграции_по_API здесь]</b>.
+Для работы с API сервиса '''Касса ЖКХ''', пользователю необходимо получить токен доступа. Генерация токена происходит по правилам авторизации OAuth2.
 == Авторизация на сервере ЖКХ ==
@@ Строка 10: / Строка 9: @@
 Для начала работы в приложении Касса ЖКХ необходимо прописать на сервере учетную запись.
-Подготовьте POST запрос следующего вида:
+{{ProductTable-2
+|title-left='''Запрос'''
- base URL: https://<URL-адрес сервера SharePoint>/OAuth/token
+|title-right='''POST'''
+|content-left= URL: https://<URL-адрес сервера>/OAuth/token
-body запроса должно передаваться как Content-Type: x-www-form-urlencoded и содержать следующие значений KEY/VALUE:
+|content-right=
+<syntaxhighlight>
+https://<URL-адрес сервера>/OAuth/token
+</syntaxhighlight>
+|}}<br>
+{{ProductTable-2
+|title-left= Request Body
+|title-right= type: '''x-www-form-urlencoded'''
+|content-left=&nbsp;
+* '''grant_type''': передать значение ''"password"'
+* '''username''': логин учетной записи, передается в формате '''7xxxxxxxxxx'''
+* '''password''': пароль, передается в виде зашифрованного хэш -> '''SHA-256 -> base64 urlencoded'''
+* '''client_id''': передать значение ''"communal-rest-client"''
+* '''client_secret''': передать значение ''"communal-rest-client"''
+|content-right=&nbsp;
 <syntaxhighlight lang="JSON">
   "grant_type" : "password",
-  "username" : номер телефона (вводится как 7xxxxxxxxxx),
+  "username" : "7xxxxxxxxxx",
-  "password" : пароль -> SHA-256 -> base64 urlencoded,
+  "password" : "asdaldfkhj34o.......kljslkfas=",
   "client_id" : "communal-rest-client",
   "client_secret" : "communal-rest-client"
 </syntaxhighlight>
+|}}<br>
-{{Note|'''Обратите внимание'''
+{{Note|'''Обратите внимание'''<br>
-Пароль передается в виде хэш суммы. Необходимо зашифровать пароль при помощи алгоритма '''SHA256''' и затем закодировать полученные данные по стандарту '''Вase64 urlencoded'''.|
+* Пароль передается в виде хэш суммы. Необходимо зашифровать пароль при помощи алгоритма '''SHA256''' и затем закодировать полученные данные по стандарту '''Вase64 urlencoded'''.
-}}
+* При вводе пароля, в конце поставить знак {{Знак равенства}} (без пробела), без этого запрос будет считаться неверным.
+|700}}

CASHDESK API:Авторизация на сервере ЖКХ: различия между версиями

Текущая версия на 12:53, 1 июня 2022

CASHDESK API

Авторизация на сервере ЖКХ

Навигация

Поиск