Получение информации о клиентах (ЖКХ): различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
Подготовьте POST запрос следующего вида:
== Общие сведения ==
'''API''' (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы на сервер ЖКХ осуществляются при помощи авторотационного токена - '''access_token'''. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.


base URL: https://<URL-адрес сервера>/communal/client/list/read


== Запрос получения клиентов ==


В '''AUTHORIZATION''' укажите значение access_token согласно:
{{ProductTable-2
 
|title-left='''Запрос'''
Bearer token : token <значение '''acces_token'''>
|title-right='''POST'''
 
|content-left= <br>URL: https://<URL-адрес сервера>/communal/client/list/read
|content-right=
<syntaxhighlight>
https://<URL-адрес сервера>/communal/client/list/read
</syntaxhighlight>
|}}<br>


В '''BODY''' запроса передайте данные в формате JSON согласно структуре.
{{Note|'''''Важно!'''''<br>
В '''HEADERS''' укажите значение '''access_token''' согласно:'''authorization''': Bearer <значение '''access_token'''> .|800}}


''Пример JSON:''


{{ProductTable-2
|title-left= '''Request body'''
|title-right= '''raw''' (JSON)
|content-left= <br>
* '''apartment''': Квартира
* '''building''': Корпус
* '''house''': Дом
* '''name''': ФИО Клиента
* '''organizationId''': ID организации
* '''personalAccount''': Номер лицевого счета
* '''street''': Улица
* '''town''': Населенный пункт
|content-right=
<syntaxhighlight lang="JSON">
<syntaxhighlight lang="JSON">
  {
  {
   "apartment": "string",                                     // Квартира
   "apartment": "string",
   "building": "string",                                     // Корпус
   "building": "string",
   "house": "string",                                         // Дом
   "house": "string",  
   "name": "string",                                         // ФИО Клиента
   "name": "string",
   "organizationId": <id организации>,                       // ID организации
   "organizationId": <id организации>,
   "personalAccount": "string",                               // Номер лицевого счета
   "personalAccount": "string",
   "street": "string",                                       // Улица
   "street": "string",
   "town": "string"                                           // Населенный пункт
   "town": "string"
  }
  }
</syntaxhighlight>
</syntaxhighlight>
|}}<br>




''Пример ответа на запрос:''
{{ProductTable-2
 
|title-left= '''Response'''
|title-right=
|content-left= <br>
* '''id''': ID клиента
* '''name''': ФИО Клиента
* '''personalAccount''': Номер лицевого счета
|content-right=
<syntaxhighlight lang="JSON">
<syntaxhighlight lang="JSON">
  {
  {
   "id": <id клиента>,                                       // ID клиента
   "id": <id клиента>,
   "name": "string",                                         // ФИО Клиента
   "name": "string",
   "personalAccount": "string"                               // Номер лицевого счета
   "personalAccount": "string"
  }
  }
</syntaxhighlight>
</syntaxhighlight>
|}}<br>

Текущая версия на 10:48, 8 ноября 2022

Общие сведения

API (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы на сервер ЖКХ осуществляются при помощи авторотационного токена - access_token. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.


Запрос получения клиентов

Запрос POST

URL: https://<URL-адрес сервера>/communal/client/list/read
https://<URL-адрес сервера>/communal/client/list/read


Note.svg Важно!
В HEADERS укажите значение access_token согласно:authorization: Bearer <значение access_token> .


Request body raw (JSON)

  • apartment: Квартира
  • building: Корпус
  • house: Дом
  • name: ФИО Клиента
  • organizationId: ID организации
  • personalAccount: Номер лицевого счета
  • street: Улица
  • town: Населенный пункт
 {
  "apartment": "string",
  "building": "string",
  "house": "string", 
  "name": "string",  
  "organizationId": <id организации>,
  "personalAccount": "string",
  "street": "string",
  "town": "string"
 }



Response

  • id: ID клиента
  • name: ФИО Клиента
  • personalAccount: Номер лицевого счета
 {
  "id": <id клиента>,
  "name": "string",
  "personalAccount": "string"
 }