¶ Добавление и автоматическое подключение услуги "Умный домофон" (устарело)
Created by Сергей Куличков, last modified on июл. 07, 2020
Для обеспечения возможности звонка из домофона в мобильное приложение, квартиру необходимо подключить к аккаунту.
Автоматически будут добавлены все ключи и камеры соответствующего адреса. Как минимум, ключ для открытия домофона и камера для показа при вызове с домофона.
API позволяет более гранулированную настройку списков камер, ключей и квартир. В данном примере показан самый распространенный случай.
В запрос необходимо вставить <access_token> (был получен при авторизации), идентификатор аккаунта <account_id> (был получен при создании аккаунта), а так же точный адрес в формате город/улица/строение/подъезд/квартира (city/street/house/entrance/flat). Рекомендуется использовать справочники КЛАДР или ФИАС. При заполнении информации об улице достаточно указать либо КЛАДР либо ФИАС, в этом случае город указывать необязательно. Если номер подъезда не указан, то его поиск будет производиться по вхожденю номера квартиры в указанный диапазон. Таким образом, минимальный набор полей адреса (например):
"address": {
"flat": <номер квартиры>,
"house": {
"number": "<номер дома>"
},
"entrance": {
"number": ""
},
"street": {
"codeKladr": "код КЛАДР улицы"
}
}
Если в квартире не установлена физическая трубка, то необходимо так же установить параметр virtual в значение true.
Из ответа необходимо запомнить id - это идентификатор услуги <service_id>, он потребуется для следующих запросов.
Запрос
POST https://rdba.rosdomofon.com/abonents-service/api/v1/accounts/<account_id>/services/software_intercoms
Content-Type: application/json
Authorization: "Bearer <access_token>"
Body:
{
"address": {
"city": "string",
"entrance": {
"flatEnd": 0,
"flatStart": 0,
"number": "string"
},
"flat": 0,
"house": {
"block": "string",
"building": "string",
"housing": "string",
"number": "string"
},
"street": {
"codeFias": "string",
"codeKladr": "string",
"name": "string"
}
},
"virtual": true
}
Ответ
Code: 200 OK
Body:
{
...
"id": <service\_id>
...
}
Тест
- Вход в мобильное приложение по номеру телефона абонента <phone_number>
- Наличие ключа/камера/истории вызовов (квартиры)