Version 1 (modified by tolix, 3 years ago) (diff) |
---|
Вывоз ТБО: 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}