Различия

Здесь показаны различия между двумя версиями данной страницы.

--- d24:develop:v2:backend:v2 [2025/11/19 09:45]
anton
+++ d24:develop:v2:backend:v2 [2025/12/19 05:46] (текущий)
anton
@@ Строка 333: / Строка 333: @@
 ^ Название  ^ Тип    ^ Обязательно ^ Описание^
 |cnt_id     | number | да          | Идентификатор юр. лица в базе данных Д24 |
-|cnt_ids     | string | да          | Идентификаторы юр. лица в базе данных Д24, разделены через : |
+|cnt_ids    | string | да         | Идентификаторы юр. лица в базе данных Д24, разделены через : |
+|house_id   | number | нет      | Идентификатор дома |
+|term_id    | number | нет       | Идентификатор услуги |
 Тип ответа: Массив
@@ Строка 341: / Строка 343: @@
 | name| string | да  | Название РСО|
 | svc_id| number| да  | ид РСО|
+| is_configured| string | нет  | статус "настроено" с номерами подъездов, если РСО настроена для дома; иначе null. |
@@ Строка 348: / Строка 351: @@
 //Запрос
 /*
- http://server.ru/v2/ref/contractors_list?cnt_ids=12241:12242
+ http://server.ru/v2/ref/contractors_list?cnt_ids=12241:12242?house_id=55434?term_id=101
 */
@@ Строка 355: / Строка 358: @@
     {
         "name": " ГазУралКомплект",
-        "svc_id": 5484
+        "svc_id": 5484,
+        "is_configured": "настроено"
     },
     {
-        "name": "АО «Екатеринбурггаз»",
+        "name": "ГорГаз",
-        "svc_id": 6451
+        "svc_id": 8,
+        "is_configured": null
     }
 ]
@@ Строка 608: / Строка 613: @@
 |entrance|string|нет|номер подъезда в указанном доме|
 |floor|number|нет|номер этажа в указанном доме|
 Тип ответа: Массив с объектами
@@ Строка 619: / Строка 625: @@
 |floor|number|нет|номер этажа|
 |flat_num|string|да|номер квартиры|
+|order_x|number|да|порядковый номер в списке|
+|rate_avg|number|нет|средняя оценка|
+|rate_count|number|нет|среднее количество|
 **Пример:**
@@ Строка 631: / Строка 640: @@
 [
     {
-        "flat_id": 876841,
+        "flat_id": 1214384,
-        "flat": "кв 1",
+        "flat": "кв sdafsfsdf",
         "flat_type": 1,
-        "flat_num": "1",
+        "flat_num": "sdafsfsdf",
-        "entrance": null,
+        "entrance": "2",
-        "floor": null
+        "floor": 3,
-    },
+        "order_x": 2,
-    {
+        "rate_avg": null,
-        "flat_id": 1069252,
+        "rate_count": null
-        "flat": "оф 2",
-        "flat_type": 4,
-        "flat_num": "2",
-        "entrance": null,
-        "floor": null
     },
     {
-        "flat_id": 876842,
+        "flat_id": 1214428,
-        "flat": "кв 2",
+        "flat": "кв ваыаыывааывааываввыааывваыываывавыа",
         "flat_type": 1,
-        "flat_num": "2",
+        "flat_num": "ваыаыывааывааываввыааывваыываывавыа",
         "entrance": null,
-        "floor": null
+        "floor": null,
+        "order_x": null,
+        "rate_avg": null,
+        "rate_count": null
     },
     {
-        "flat_id": 876843,
+        "flat_id": 1214464,
-        "flat": "кв 3",
+        "flat": "кв ываываываываываыва",
         "flat_type": 1,
-        "flat_num": "3",
+        "flat_num": "ываываываываываыва",
         "entrance": null,
-        "floor": null
+        "floor": null,
-    },
+        "order_x": null,
-    {
+        "rate_avg": null,
-        "flat_id": 876844,
+        "rate_count": null
-        "flat": "кв 4",
-        "flat_type": 1,
-        "flat_num": "4",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 876845,
-        "flat": "кв 5",
-        "flat_type": 1,
-        "flat_num": "5",
-        "entrance": "1",
-        "floor": 2
-    },
-    {
-        "flat_id": 876846,
-        "flat": "кв 6",
-        "flat_type": 1,
-        "flat_num": "6",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 876847,
-        "flat": "кв 7",
-        "flat_type": 1,
-        "flat_num": "7",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 876848,
-        "flat": "кв 8",
-        "flat_type": 1,
-        "flat_num": "8",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 876849,
-        "flat": "кв 9",
-        "flat_type": 1,
-        "flat_num": "9",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 876850,
-        "flat": "кв 10",
-        "flat_type": 1,
-        "flat_num": "10",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 1082244,
-        "flat": "кв 12",
-        "flat_type": 1,
-        "flat_num": "12",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 966663,
-        "flat": "кв 15",
-        "flat_type": 1,
-        "flat_num": "15",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 2774303,
-        "flat": "м/м 321",
-        "flat_type": 3,
-        "flat_num": "321",
-        "entrance": null,
-        "floor": null
-    },
-    {
-        "flat_id": 2617083,
-        "flat": "кв 381",
-        "flat_type": 1,
-        "flat_num": "381",
-        "entrance": null,
-        "floor": null
     }
 ]
@@ Строка 962: / Строка 884: @@
         "resp_id": 28853,
         "status": "Р"
+    },
+    ...
+]
+</code>
+==== Получение списка услуг ====
+GET http://server.ru/v2/ref/ref_terms_list
+Тип ответа: Массив объектов
+Параметры ответа (объектов массива)
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|term_id|number|да|ид услуги|
+|term_name|string|да|наименование услуги|
+|flag_meter|string|да|флаг прибора учета Д \ Н |
+**Пример:**
+<code javascript>
+//Запрос
+/*
+ GET http://server.ru/v2/ref/ref_terms_list
+*/
+// Ответ
+[
+   {
+        "term_id": 121,
+        "term_name": "Безопасность и СКУД",
+        "flag_meter": "Н"
+    },
+    {
+        "term_id": 101,
+        "term_name": "Вентиляция",
+        "flag_meter": "Н"
+    },
+    {
+        "term_id": 141,
+        "term_name": "Видеонаблюдение",
+        "flag_meter": "Н"
+    },
+    {
+        "term_id": 2,
+        "term_name": "Водоотведение",
+        "flag_meter": "Н"
     },
     ...
@@ Строка 1468: / Строка 1437: @@
 ^ Название  ^ Тип    ^ Обязательно ^ Описание^
 |affected_rows|number|да|сколько строк обновилось|
-|info_id|number|да|идентификатор оповещения, которое обновлялось|
+|info_id|string|да|идентификатор оповещения, которое обновлялось|
@@ Строка 1922: / Строка 1891: @@
 |address|string|да|Текстовое представление адреса|
 |house|string|да|Текстовое представление дома|
+|city|string|да|Текстовое представление города|
 |street|string|да|Текстовое представление улицы|
@@ Строка 1941: / Строка 1911: @@
         "date_end_tz": null,
         "address": "Курган г, Бурова-Петрова ул, дом 78",
+        "city": "Курган г",
         "house": "78",
         "street": "Бурова-Петрова ул",
@@ Строка 1952: / Строка 1923: @@
         "date_end_tz": null,
         "address": "Курган г, Куртамышская ул, дом 18 К1",
+        "city": "Курган г",
         "house": "18 К1",
         "street": "Куртамышская ул",
@@ Строка 1975: / Строка 1947: @@
 |date_start_tz|string|да|дата начала в формате DD.MM.YYYY HH:mm|
 |date_end_tz|string|да|дата окончания в формате DD.MM.YYYY HH:mm|
+**Параметры ответа**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|affected_rows|number|да|сколько строк изменилось|
+|status_id|string|да|идентификатор прикрепленного дома|
 **Примеры:**
@@ Строка 1993: / Строка 1971: @@
 }
-**Параметры ответа**
-^ Название  ^ Тип    ^ Обязательно ^ Описание^
-|affected_rows|number|да|сколько строк изменилось|
-|status_id|string|да|идентификатор прикрепленного дома|
@@ Строка 2659: / Строка 2633: @@
 |request_rso_id|number|да|ид заявки рсо|
 |status_id|number|да|ид статуса|
-|request_id|number|да|ид родительской заявки|
+|request_id|number|нет|ид родительской заявки|
 |status_name|string|да|название статуса|
 |svc_name|string|да|название службы рсо|
-|updated_on_tz|string|да|дата изменения в формате ISO|
+|updated_on_tz|string|нет|дата изменения в формате ISO|
 **Примеры:**
@@ Строка 2746: / Строка 2720: @@
 |note|string|да|описание заявки рсо|
 |request_rso_id|number|да|ид заявки рсо|
-|ext_request_id|string|да|ид заявки из смежной службы|
+|ext_request_id|string|нет|ид заявки из смежной службы|
-|request_id|number|да|ид заявки основной|
+|request_id|number|нет|ид заявки основной|
 |status_id|number|да|ид статуса|
 |status_name|string|да|название статуса|
-|request_status_name|string|да|название статуса основной заявки|
+|request_status_name|string|нет|название статуса основной заявки|
 |svc_name|string|да|название службы рсо|
-|pass_fio|string|да|фио того, кто принял заявки в смежной службе|
+|pass_fio|string|нет|фио того, кто принял заявки в смежной службе|
-|updated_on_tz|string|да|дата изменения в формате ISO|
+|updated_on_tz|string|нет|дата изменения в формате ISO|
 **Примеры:**
@@ Строка 3298: / Строка 3272: @@
 |flat_num|string|нет|номер помещения|
 |autophone|string|нет|АОН|
-|ess_id|number|нет|идентификатор причины обращения|
+|ess_id|number|да|идентификатор причины обращения|
 |request_rso_id|number|нет|номер заявки в РСО|
 |editable|string|да|редактируема ли Y / N|
@@ Строка 3496: / Строка 3470: @@
 |rtype|string|да|тип заявки|
 |req_type|string|да|тип заявки полем из бд|
-|flag_emergency|string|нет|аварийная ли заявка. Д - аварийная / Н - не аварийная|
+|flag_emergency|string|да|аварийная ли заявка. Д - аварийная / Н - не аварийная|
-|prepay_flag|string|нет|оплачиваемая ли заявка. Д - можно редактировать суммы к оплате /qr код для оплаты / Н - нет нельзя|
+|prepay_flag|string|да|оплачиваемая ли заявка. Д - можно редактировать суммы к оплате /qr код для оплаты / Н - нет нельзя|
 |is_rso_available|string|да|работа с заявками в РСО Д/Н|
-|note|да|string|текст заявки|
+|note|string|да|текст заявки|
 |house|string|да|Адрес дома|
 |fias|string|нет|фиас|
@@ Строка 3515: / Строка 3489: @@
 |request_type|number|да|тип заявки в числовом обозначении|
 |entr|string|нет|обозначение подъезда|
-|appeal_num|нет|string|номер обращения|
+|appeal_num|string|нет|номер обращения|
 |appeal_date|string|нет|дата обращения|
 |rso_name|string|нет|назваине организации РСО|
@@ Строка 3552: / Строка 3526: @@
 |cnt_id|number|да|Идентификатор юр. лица|
 |oi_id|number|нет|Идентификатор оповещения|
+|term_id|number|нет|Идентификатор услуги|
 |oi_status|string|нет|Статус оповещения|
 |house_id|number|да|Идентификатор дома|
@@ Строка 3558: / Строка 3533: @@
 |request_rso_id|number|нет|Идентификатор РСО заявки|
 |rso_status_name|string|нет|Статус РСО заявки|
-|is_paid|string|нет|Оплачено или нет. Д - оплачено / Н - не оплачено|
+|is_paid|string|да|Оплачено или нет. Д - оплачено / Н - не оплачено|
 |price|number|нет|стоимость заявки|
 |rate|number|нет|рейтинг заявки|
 |paid|number|нет|сколько оплачено в данный момент по заявке|
-|material_price|нет|number|стоимость материалов по заявке|
+|material_price|number|нет|стоимость материалов по заявке|
-|position|да|string|позиция сотрудника|
+|position|string|да|позиция сотрудника|
-|accessstring|да|доступ|
+|access|string|да|доступ|
 |appointed_str|string|нет|желаемое время прихода специалиста|
 |uploads_count|number|да|кол-во скачиваний заявки|
@@ Строка 3684: / Строка 3659: @@
     "what_was_done": "qwe1",
     "oi_id": null,
+    "term_id": null,
     "oi_status": null,
     "rsfat_value": 6623,