Различия

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

--- d24:develop:v2:backend:user [2021/11/09 11:44]
pavlovaa [Получить список заявок по параметрам]
+++ d24:develop:v2:backend:user [2024/04/01 06:39] (текущий)
fedorovlv [Перевод аварийной заявки на участок]
@@ Строка 1: / Строка 1: @@
 ====== Описание API мобильного приложения Д24 v2 ======
+  * **Рефакторинг апи** https://ds24.ru/wiki/doku.php?id=d24:develop:v2:backend:v2
   * url продакшен сервера https://ds24.ru/piedpiper
-  * url тестового сервера http://192.168.37.50:9009
+  * url тестового сервера https://s0.ds24.ru/piedpiper
+====== Данное API потеряет поддержку с 04.2022 ======
+  * **Новое апи** https://ds24.ru/wiki/doku.php?id=d24:develop:v2:backend:v2
 ===== Описание URL =====
@@ Строка 70: / Строка 74: @@
 Регистрация http://server.ru/registration
-Пользователь вводит свой логин и пароль на форме например "login : predeinay : superpass" , (login означает что авторизация происходит по логину и паролю) интерфейс должен закодировать эту строку в base64 чтобы получилась вот такая "строка cHJlZGVpbmF5IDogc3VwZXJwYXNz" затем интерфейс посылает http запрос с заголовком "authorization: cHJlZGVpbmF5IDogc3VwZXJwYXNz" и JSON объектом методом POST на URL: http://server.ru/registration
+Пользователь вводит свой логин и пароль на форме например "login : predeinay : superpass" , (login означает что авторизация происходит по логину и паролю) интерфейс должен закодировать эту строку в base64 чтобы получилась вот такая "строка bG9naW4gOiBwcmVkZWluYXkgOiBzdXBlcnBhc3M=" затем интерфейс посылает http запрос с заголовком "authorization: bG9naW4gOiBwcmVkZWluYXkgOiBzdXBlcnBhc3M=" и JSON объектом методом POST на URL: http://server.ru/registration
 <code javascript>
 // Запрос
@@ Строка 431: / Строка 435: @@
         "status": "Зарегистрирована",
         "status_id": 1,
-        "reasons" : 0                      // кол-во доступных причин статуса (например если статус = "Отложена", то причин будет к пример 5)
+        "reasons" : 0,                      // кол-во доступных причин статуса (например если статус = "Отложена", то причин будет к пример 5)
-    }, {                                   // сделано это для удобства обработки на фронте (не делать лишний запрос если причин по статусу = 0)
+                                            // сделано это для удобства обработки на фронте (не делать лишний запрос если причин по статусу = 0)
+        "need_comment": 0                   // необходимо ли обязательно указывать коммент в момент перевода заявки в данный стутус (0 нет 1 да)
+    }, {
         "status": "Требуется отклик",
         "status_id": 65,
-        "reasons" : 2
+        "reasons" : 2,
+        "need_comment": 1
     }]
 }
@@ Строка 774: / Строка 782: @@
         "price": 1000,                                                 // стоимость заявки
         "paid": 200                                                    // сколько оплачено в данный момент по заявке
     }
 }
@@ Строка 951: / Строка 960: @@
                 "image_name"  : "some test",                                          // Название изображения
                 "appointed_at": "next_week",                                           // Дата, когда придёт исполнитель, принимает "today" / "tomorrow" / "next_week" / дату в формате "ДД.ММ.ГГГГ"
-                "local_at"    : "12.12.2020 12:12"                                     // Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:МИ"
+                "local_at"    : "12.12.2020 12:12",                                     // Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:МИ"
+               "material_price" : 333                                                   // Стоимость материалов по заявке
                }
 }
@@ Строка 1948: / Строка 1958: @@
         "is_paid": "Д",                                                // флаг оплачено
         "price": 1000,                                                 // стоимость заявки
-        "paid": 200                                                    // сколько оплачено в данный момент по заявке
+        "paid": 200,                                                   // сколько оплачено в данный момент по заявке
+        "material_price" : 666,                                        // стоимость материалов по заявке
         "appointed_str": null,                                         // желаемое время прихода специалиста
         "is_local_need": "Н",                                          // нужна ли локализация аварии
@@ Строка 2010: / Строка 2021: @@
 ==== Перевод аварийной заявки на участок ====
 <code javascript>
-GET server/v2/request/:request_id/tocurrentrepair
+POST server/v2/request/:request_id/tocurrentrepair
 JSON ответ в случае успеха:
@@ Строка 2151: / Строка 2162: @@
         "emp_id": 22055,
         "not_read_push_count": 10,
-        "can_comment_to_ext_system": true,
+        "can_comment_to_ext_system": 1,  // варианты 0/1
-        "token_id": 12345
+        "token_id": 12345,
+        "can_access_material_price": true,
+        "access_status_list" : "1:2:3:4:5"  //доступные для использования пользователем статусы заявок
     }
 </code>