Changes between Initial Version and Version 1 of WasteCollectionTabletAPI

Timestamp:

Nov 4, 2021 2:31:26 PM (3 years ago)

Author:

tolix

Comment:

--

WasteCollectionTabletAPI

@@ +1 @@
+= Вывоз ТБО: API взаимодействия с планшетом =
+
+API использует сообщения в JSON формате, передаваемые по HTTP по принципу запрос-ответ. Инициатором обмена всегда выступает планшет. 
+
+Необходимым условием является наличие в сообщениях следующих HTTP заголовков:
+ * X-Signature: reserved
+ * Content-Type: text/x-json
+
+HTTP адрес всех веб-сервисов (URL), используемых в данном компоненте, формируется из базовой части http://<server_name>/components/communa/ и имени конкретного сервиса.
+
+Все параметры, содержащие время, используют часовой пояс оператора-владельца используемых в запросе объектов (спецавтомобилей, контейнеров и т.д.), т.е. местное время.
+
+== Запрос списка водителей/экспедиторов для аутентификации ==
+
+Endpoint: http://<server_name>/components/communa/get_personnel
+
+Запрос:
+{{{
+{
+    "device_id":"a40d38a959f1ca65"
+}
+}}}
+
+Ответ,
+{{{
+{"personnel": [{"personnel_number": 444, "first_name": "Иван", "last_name": "mts", "middle_name": "", "id": 1012651}, {"personnel_number":
+777, "first_name": "Василий", "last_name": "mts1", "middle_name": "", "id": 1012652}], "success": true}
+}}}
+
+== Запрос списка маршрутов полный (с подробной информацией о платформах) ==
+
+Endpoint: http://<server_name>/components/communa/get_routes
+
+Запрос:
+{{{
+{
+    "device_id":"49aa570dc04344a6"
+}
+}}}
+
+Ответ:
+{{{
+{"routes": [{"platforms": [{"estimated_fill": 1.0, "volume":1.100, "address": "АТБ-Містечко", "lat": 50.2107736547029, "lng": 30.3174322843552, "id": 1022549, "quantity": 1}, {"estimated_fill": 1.0,
+"volume": 1.100, "address": "пр.Лесі Українки, 15 ", "lat": 50.1974241245373, "lng": 30.2944350242615, "id": 1022542, "quantity": 1}, {"est
+imated_fill": 1.0, "volume": 1.100, "address": "Столичка", "lat": 50.216073975587, "lng": 30.3178024291992, "id": 1022543, "quantity": 3},
+{"estimated_fill": 1.0, "volume": 1.100, "address": "Солнечная", "lat": 50.1883300230983, "lng": 30.2941560745239, "id": 1022544, "quantity
+": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Володимирська,13", "lat": 50.1747131083508, "lng": 30.3193259239197, "id":
+1022545, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Володимирька, 28 (Корунд)", "lat": 50.1733834992561, "lng
+": 30.3227108716965, "id": 1022546, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "Фуршет", "lat": 50.1795055782639,
+"lng": 30.3133499622345, "id": 1022547, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Набережна", "lat": 50.1800
+174337311, "lng": 30.3084254264832, "id": 1022548, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "Військове .Містечко
+", "lat": 50.2120369970609, "lng": 30.3167670965195, "id": 1022550, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "ву
+л.Грушевського,25", "lat": 50.180299123662, "lng": 30.3108340501785, "id": 1022551, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100
+, "address": "Іванковичі", "lat": 50.2786446089967, "lng": 30.4251337051392, "id": 1022552, "quantity": 2}], "num": "01.05 - Смаколики", "i
+d": 1022554, "itinerary": ""}], "success": true}
+}}}
+