Changes between Initial Version and Version 1 of WasteCollectionTabletAPI


Ignore:
Timestamp:
Nov 4, 2021 2:31:26 PM (3 years ago)
Author:
tolix
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WasteCollectionTabletAPI

    v1 v1  
     1= Вывоз ТБО: API взаимодействия с планшетом =
     2
     3API использует сообщения в JSON формате, передаваемые по HTTP по принципу запрос-ответ. Инициатором обмена всегда выступает планшет.
     4
     5Необходимым условием является наличие в сообщениях следующих HTTP заголовков:
     6 * X-Signature: reserved
     7 * Content-Type: text/x-json
     8
     9HTTP адрес всех веб-сервисов (URL), используемых в данном компоненте, формируется из базовой части http://<server_name>/components/communa/ и имени конкретного сервиса.
     10
     11Все параметры, содержащие время, используют часовой пояс оператора-владельца используемых в запросе объектов (спецавтомобилей, контейнеров и т.д.), т.е. местное время.
     12
     13== Запрос списка водителей/экспедиторов для аутентификации ==
     14
     15Endpoint: http://<server_name>/components/communa/get_personnel
     16
     17Запрос:
     18{{{
     19{
     20    "device_id":"a40d38a959f1ca65"
     21}
     22}}}
     23
     24Ответ,
     25{{{
     26{"personnel": [{"personnel_number": 444, "first_name": "Иван", "last_name": "mts", "middle_name": "", "id": 1012651}, {"personnel_number":
     27777, "first_name": "Василий", "last_name": "mts1", "middle_name": "", "id": 1012652}], "success": true}
     28}}}
     29
     30== Запрос списка маршрутов полный (с подробной информацией о платформах) ==
     31
     32Endpoint: http://<server_name>/components/communa/get_routes
     33
     34Запрос:
     35{{{
     36{
     37    "device_id":"49aa570dc04344a6"
     38}
     39}}}
     40
     41Ответ:
     42{{{
     43{"routes": [{"platforms": [{"estimated_fill": 1.0, "volume":1.100, "address": "АТБ-Містечко", "lat": 50.2107736547029, "lng": 30.3174322843552, "id": 1022549, "quantity": 1}, {"estimated_fill": 1.0,
     44"volume": 1.100, "address": "пр.Лесі Українки, 15 ", "lat": 50.1974241245373, "lng": 30.2944350242615, "id": 1022542, "quantity": 1}, {"est
     45imated_fill": 1.0, "volume": 1.100, "address": "Столичка", "lat": 50.216073975587, "lng": 30.3178024291992, "id": 1022543, "quantity": 3},
     46{"estimated_fill": 1.0, "volume": 1.100, "address": "Солнечная", "lat": 50.1883300230983, "lng": 30.2941560745239, "id": 1022544, "quantity
     47": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Володимирська,13", "lat": 50.1747131083508, "lng": 30.3193259239197, "id":
     481022545, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Володимирька, 28 (Корунд)", "lat": 50.1733834992561, "lng
     49": 30.3227108716965, "id": 1022546, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "Фуршет", "lat": 50.1795055782639,
     50"lng": 30.3133499622345, "id": 1022547, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "вул.Набережна", "lat": 50.1800
     51174337311, "lng": 30.3084254264832, "id": 1022548, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "Військове .Містечко
     52", "lat": 50.2120369970609, "lng": 30.3167670965195, "id": 1022550, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100, "address": "ву
     53л.Грушевського,25", "lat": 50.180299123662, "lng": 30.3108340501785, "id": 1022551, "quantity": 1}, {"estimated_fill": 1.0, "volume": 1.100
     54, "address": "Іванковичі", "lat": 50.2786446089967, "lng": 30.4251337051392, "id": 1022552, "quantity": 2}], "num": "01.05 - Смаколики", "i
     55d": 1022554, "itinerary": ""}], "success": true}
     56}}}
     57