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

Материал из Касса
Перейти к навигации Перейти к поиску

CASHDESK API

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

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

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

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

Подготовьте POST запрос следующего вида:

base URL: https://<URL-адрес сервера SharePoint>/OAuth/token

body запроса должно передаваться как Content-Type: x-www-form-urlencoded и содержать следующие значений KEY/VALUE:

 "grant_type" : "password",
 "username" : номер телефона (вводится как 7xxxxxxxxxx),
 "password" : пароль -> SHA-256 -> base64 urlencoded =,
 "client_id" : "communal-rest-client",
 "client_secret" : "communal-rest-client"

Note.svg Обратите внимание

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