Используется для регистрации нового пользователя в системе.
\nРегистрирует пользователя с указанным email (параметр user_provider_id) и создает новую компанию, в которой пользователь становится администратором (роль Admin).
\nНа указанный email отправляется ссылка для подтвержения аккаунта.
\nПользователь сразу логинится в системе (создается сессия) и может выполнять любые запросы, требующие авторизации.
\nПараметры:
\nuserProviderId - email пользователя (обязательный) \ntype - тип регистрации, всегда \"EMAIL\" (обязательный)\npassword - пароль (обязательный)\nname - имя нового пользователя (необязательный, по умолчанию копируется email)\nphone - телефон нового пользователя\ncompany_name - название компании (необязательный, по умолчанию будет имя из email до символа @\ntimezone - (обязательный) значение часового пояса из справочника dictionary (см. type = 'timezone')\nlanguage - (обязательный) значение из справочника dictionary (см type = 'lang')\ncaptcha - код с картинки получаемой методом GET /captcha\ninvite_id - ID приглашения, получается из link в письме на почту, параметр invite_id\n{\n \"userProviderId\": \"mihsh1111@tut.by\",\n \"type\": \"EMAIL\",\n \"company_name\": \"BigBin\",\n \"password\": \"11111\", \n \"name\": \"Имя пользователя\",\n \"timezone\": {\n \"key\": \"UTC+3\"\n },\n \"language\": {\n \"key\": \"ru\"\n }\n}\n\nПараметры ответа:
\nКод 200 и пустой body в случае успеха.
\nЕсли уже есть аккаунт (см. /approve) с таким email, то возращается Код 422 и body c ошибкой session.errors.emailAlreadyRegistered
\nВ случае частого вызова метода (чаще чем раз в 30 секунд), то возращается Код 400 и body validation.errors.often
\n","urlObject":{"path":["api_v1","registrate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f0cf33dc-9069-4236-9331-c69efa28fe58"},{"name":"/login","id":"b5ac16dd-94f2-4c0a-ab5e-da22d80e8b2d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"userProviderId\": \"test1@ya.ru\",\n \"provider_key\": \"TEXT\",\n \"password\": \"12345N\"\n}"},"url":"{{base_url}}/api_v1/login","description":"Авторизация пользователя с помощью email
\nПроверяет корректность связки email и пароля для авторизации пользователя. Если авторизация проходит успешно, то в cookies помещается id сессии пользователя, которая используется для авторизации дальнейших вызовов функции API под авторизованным пользователем. В случае если пользователь заходит по временному паролю (присланному при восстановлении пароля или вторичной регистрации по уже зарегистрированному телефону), то временный пароль становится постоянным.
\nПараметры:
\n\"userProviderId\" - email (обязательный) или логин
\"provider_key\" - костанта \"TEXT\" (обязательный)
\"password\" - пароль (обязательный)
\"is_admin_panel\" - true отправляется при входе в админ-панель
\nВ поле password необходимо указать пароль, полученный при регистрации по смс (или email при тестовом режиме)
\n{\n \"userProviderId\": \"test1@ya.ru\", (обязательный)\n \"provider_key\": \"EMAIL\", (обязательный)\n \"password\": \"33100078\" (обязательный)\n}\n\nПараметры ответа:
\nВ случае успешной авторизации возвращается пустой body с кодом 200.
\nВ случае не успешной авторизации возвращается status: 422 и json-body с ошибкой.
\n","urlObject":{"path":["api_v1","login"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b5ac16dd-94f2-4c0a-ab5e-da22d80e8b2d"},{"name":"/recovery","id":"23bad864-c980-40c0-8b32-32a4f1651323","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"user_provider_id\": \"test1@ya.ru\",\n \"type\": \"EMAIL\"\n}"},"url":"{{base_url}}/api_v1/recovery","description":"Восстановление пароля
\nМетод создает временный пароль для существующего пользователя. Новый пароль отправляется на указанный email. В тестовой среде отправляет письмо на отладочные почтовые ящики.
\nПараметры:
\nuser_provider_id - телефон пользователя (обязательный)\ntype - константа, всегда \"EMAIL\" (обязательный)\n{\n \"user_provider_id\": \"test1@ya.ru\", \n \"type\": \"EMAIL\" \n}\n\nПараметры ответа:
\nКод 200. Даже если пользователь с указанным паролем не существует.
\n{\n \"pssword\": \"\"\n}\n\nОшибка валидации - код 422, с перечнем ошибок в полях
\n{\n \"errors\": [\n {\n \"code\": 4221,\n \"field\": \"password\",\n \"message\": \"Отсутствует параметр\"\n }\n ],\n \"code\": 4220, //общий код ошибки \n \"message\": \"Отсутствует параметр\" // частный \n}\n\nВход через qr
\nМетод создает временный пароль для существующего пользователя. По ссылке auth.recovery_url можно получить сессию и сменить пароль. Так же, если для пользователя настроен vpn, его парамеры будут возвращены в теге vpn
\nПараметры:
\nuser_id - id пользователя (обязательный)
\nРоль: Супервизор и выше.
\nПараметры ответа:
\nКод 200. Даже если пользователь с указанным паролем не существует. Ответ всегда такого вида
\n{\n \"vpn\": {\n \"privateKey\": \"ULVS+24iL5KGaQuDOWwx97MrMdWiyb8OPbic5uaz6kk=\",\n \"address\": \"10.8.0.4/23\",\n \"dns\": \"8.8.8.8\",\n \"publicKey\": \"kD4mmtvAAcSQo1A4jFGVrXfSS6ANk9dqpcs3NJ5c904=\",\n \"allowedIPs\": \"0.0.0.0/0\",\n \"endpoint\": \"37.151.94.172:51820\",\n \"persistentKeepalive\": \"20\"\n },\n \"auth\": {\n \"recovery_url\": \"https://dev5.skif.pro/recovery/75c93998-f410-4e4a-a470-722940f10946\"\n }\n}\n\nОшибка валидации - код 422, с перечнем ошибок в полях
\n{\n \"errors\": [\n {\n \"code\": 4221,\n \"field\": \"\",\n \"message\": \"Отсутствует параметр\"\n }\n ],\n \"code\": 4220, //общий код ошибки \n \"message\": \"Отсутствует параметр\" // частный \n}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"}]}},"response":[],"_postman_id":"facdc912-f8c6-4bd5-8a9b-9df4d191d109"},{"name":"/logout","id":"d0981a7a-d7f5-4e89-8501-06ff561f1fc3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/logout","description":"Выход из учетной записи
\nУдаляет все сессии пользователя на сервере.
\nПараметры: пусто
\nОтвет: 200
\n","urlObject":{"path":["api_v1","logout"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d0981a7a-d7f5-4e89-8501-06ff561f1fc3"},{"name":"/reset_password/:user_id","id":"7cb63efe-4f20-4202-819d-407892aa3224","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"newPassword\": \"Aa@1234567891011121314\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/reset_password/:user_id","description":"Сбросить пароль пользователя администратором (только администратор)
\nУстановить новый временный пароль для пользователя. После чего пользователь должен изменить пароль после входа.
\nПараметры:
\nuser_id - ID пользователя
newPassword - новый пароль
Роль: Администратор и выше.
\nОтвет: Пустой 200. Новый пароль установлен или ошибка
\nПример запроса:
\n{\n \"newPassword\": \"12345678\"\n}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"}]}},"response":[],"_postman_id":"7cb63efe-4f20-4202-819d-407892aa3224"},{"name":"/change_my_password","id":"72f905f8-e118-43c8-ad36-e260e3928d9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/change_my_password","description":"Изменить свой пароль пользователем
\nУстановить новый пароль пользователя для себя.
\nПараметры:
\npassword - текущий пароль
newPassword - новый пароль
Ответ: Пустой 200 новый пароль установлен или ошибка
\nПример запроса:
\n{\n \"password\": \"123456\",\n \"newPassword\": \"12345678\"\n}\n\nПодтверждение email. Используется для подтверждения email по ссылке полученной на почту.
\nДелает email подтвержденным, после чего зарегистироваться с таким email уже не возможно.
Пользователь сразу авторизуется в системе без ввода email и пароля.
Создается временный id помещенный в redis со временем жизни 30 мин
\nПараметры:
\nid - временный id связанный с email
\nОтвет:
\nВозвращает код 200 с пустым body
\nВозвращает код 422 в случае если id не валидно
\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\nАвторизация по приглашению. Используется для получения доступа к компании по ссылке, полученной на почте.
\nСоздает пользователя, если он не был ранее зарегистрирован и дает доступ к компании из которой Администратор вызвал метод POST /invite
Пользователь сразу авторизуется в системе без ввода email и пароля под приглашенной Компанией.
Пример запроса:
\nСоздается временный id помещенный в redis со временем жизни 30 мин.
\nid связан с email и компанией, в которую приглашают пользователя (оба значения можно помещать в качестве значения в redis)
\nПараметры:
\nid - временный id связанный с email и Компанией в которую приглашают пользователя
\nОтвет:
\nВозвращает код 200 с пустым body
\nВозвращает код 422 в случае если id не валидно
\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\nАвторизация по ссылке восстановления, полученной по почте. Используется для авторизации пользователя в системе для последующей смены пароля.
\nПользователь сразу авторизуется в системе без ввода email и пароля. При этом если у пользователя доступ к нескольким компаниям, то предлагается выбор Компании, в которую пользователь хочет войти через метод GET switchcompany/:id
\nПример запроса:
\nСоздается временный id, помещенный в redis со временем жизни 30 мин. id связан с email
\nПараметры:
\nid - временный id связанный с email
\nОтвет:
\nВозвращает код 200 с пустым body
\nВозвращает код 422 в случае, если id не валидно
\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\nДля регистрации необходимо передать код с картинки, получаемый из этого метода в поле captcha
\n","urlObject":{"path":["api_v1","captcha"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"06b7a242-5894-4de1-a1df-8d2578cc4801"},{"name":"/ask_approve_code","id":"1bda634a-9e56-4925-a87a-2f6f71bd5513","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"userProviderId\": \"+71111111111\",\n \"provider_key\": \"PHONE\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/ask_approve_code","description":"Запрос получения кода
\nПараметры:
provider_key: text, для подтверждения номером телефона (пока только так) provider_key = PHONE
userProviderId - text, номер телефона если provider_key = PHONE
Пример запроса:
\n{\n \"userProviderId\": \"+7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\"\n}\n\nВ ответ приходит 200, если запрос правильный, иначе ошибка
\n","urlObject":{"path":["api_v1","ask_approve_code"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1bda634a-9e56-4925-a87a-2f6f71bd5513"},{"name":"/ask_approve_code_voice","id":"bf42fc80-46bb-48b2-9762-800ff9cabd4d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"userProviderId\": \"+71111111111\",\n \"provider_key\": \"PHONE\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/ask_approve_code_voice","description":"Запрос получения кода через звонок
\nПараметры:
provider_key: text, для подтверждения номером телефона, provider_key = PHONE
userProviderId - text, номер телефона, если provider_key = PHONE
Пример запроса:
\n{\n \"userProviderId\": \"+7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\"\n}\n\nВ ответ приходит 200, если запрос правильный, иначе ошибка
\n","urlObject":{"path":["api_v1","ask_approve_code_voice"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bf42fc80-46bb-48b2-9762-800ff9cabd4d"},{"name":"/approve_code","id":"ca9c5200-70ab-47fd-9ae8-f8ddc9b0dabe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"userProviderId\": \"+71111111111\",\n \"provider_key\": \"PHONE\",\n \"code\": \"52798\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/approve_code","description":"Подтверждение аккаунта с помощью кода
\nПараметры:
provider_key: text, ддля подтверждения номером телефона(пока только так) provider_key = PHONE
userProviderId - text, номер телефона если provider_key = PHONE
code: text, полученный код
Пример запроса:
\n{\n \"userProviderId\": \"7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\",\n \"code\": \"27280\"\n}\n\nПолучить информацию о текущем пользователе
\nМетод выдает информацию по текущему пользователю
\nРоль: Наблюдатель и выше.
\nОтвет:
\n{\n \"id\": \"75bd17cc-642f-4c7c-982e-e0e991907733\", // id пользователя\n \"created\": \"2017-03-10 16:56:41\", // дата создания\n \"role\": {\"key\": \"Editor\", \"value\": \"Редактор\"}, //роль пользователя. В системе есть роли NoAccess - пользователь без доступа, Editor - обычный пользователь, Reader - читатель, Admin - администратор (может изменять роли других пользователей, блокировать)\n },\n \"actions\": [ // список действий пользователя, весь список: GET /actions\n {\n \"id\": \"5858822c-1f21-431b-9cde-a672d2803b2b\",\n \"key\": \"generate_report\",\n },\n {\n \"id\": \"6ff2a8bd-48d6-4347-b42e-c01d73434fb5\",\n \"key\": \"units/update\"\n }\n ], \n \"name\": \"Миша\", // имя\n \"email\": \"test@gmail.com\",\n \"is_approved\": true, //подтвержден ли аккаунт\n \"is_driver\": true, //является ли пользователь водителем\n \"need_change_password\": true, // Если у пользователя установлен временный пароль, то пользователь должен изменить свой пароль \n \"telegram_chat_id\": 12345678910, //id-рассылки для Telegram\n \"photos\": [{\n \"id\": \"b549d113-88e7-4002-b792-8f76d6694aa3\",\n \"url\": \"/photos/b549d113-88e7-4002-b792-8f76d6694aa3_original.png\", //путь к оригинальной картинке\n \"width\": 850,\n \"height\": 670,\n \"param_type\": \"users\" //тип картинки, для пользователей - users\n }, {\n \"id\": \"a8a0d710-01f4-4952-8a0f-35e345f2ad98\",\n \"url\": \"/photos/b549d113-88e7-4002-b792-8f76d6694aa3_110.png\", //путь к картинке с максимальной стороной в 110px\n \"width\": 110,\n \"height\": 86,\n \"param_type\": \"users\" //тип картинки, для пользователей - users\n }],\n \"code\": \"092384\", // id пользователя (rfid)\n \"language\" : {\"key\":\"en\", \"value\":\"English\", \"type\":\"languages\"}, //язык пользователя\n \"phone\" : \"+78902334234\",\n \"details\": \"Просто текстовое поле\",\n \"companies\": [{\"id\":\"75bd17cc-642f-4c7c-982e-e0e991907733\", \"name\":\"Моя первая Компания\", \"timezone\": \"UTC+3\"}] //доступные пользователю компании\n \"active_company\": {\"id\":\"75bd17cc-642f-4c7c-982e-e0e991907733\", \"name\":\"Моя первая Компания\", \"timezone\": \"UTC+3\"}\n \"settings_web\": {}, // настройки в виде json, специфические для web-клиента\n \"settings_ios\": {},// настройки в виде json, специфические для iOS-клиента\n \"settings_android\": {},// настройки в виде json, специфические для android-клиента\n \"actions_templates\": {},// настройки в виде json \n \"actions\": [// список действий пользователя, \n {\n \"id\": \"5858822c-1f21-431b-9cde-a672d2803b2b\",\n \"key\": \"generate_report\",\n },\n {\n \"id\": \"6ff2a8bd-48d6-4347-b42e-c01d73434fb5\",\n \"key\": \"units/update\"\n }\n ],\n \"units_access\": [//Доступ к объектам\n {\n \"unit\": {\n \"id\": \"0c4095e1-8cf4-4be2-b8b8-5aacf528a6dd\"\n },\n \"actions\": [] // cписок действий, можно выбирать те actions для которых is_unit_action = true\n },\n {\n \"unit\": {\n \"id\": \"d0dd6178-fd10-4f49-8627-a386ac35b8c3\"\n },\n \"actions\": [{\n \"id\": \"051d5caf-b40a-4474-9c25-fb0d83ea4891\",\n \"key\": \"delete_units\"\n },\n {\n \"id\": \"bc7f985c-9641-4d0a-9f6f-8d5214d98105\",\n \"key\": \"update_units\"\n }\n ]\n }\n ],\n \"units_groups_access\": [{ //Доступ к группам\n \"units_group\": {\n \"id\": \"d7bad56b-bb05-4c9c-830b-ed192a3fa4de\"\n },\n \"actions\": []//список действий, можно выбирать те actions для которых is_unit_action = true\nуказанные actions применяются для всех объектов группы\n },\n {\n \"units_group\": {\n \"id\": \"1769a313-0c20-4ebf-b7f6-7fce00f4f301\"\n },\n \"actions\": [{\n \"id\": \"051d5caf-b40a-4474-9c25-fb0d83ea4891\",\n \"key\": \"delete_units\"\n },\n {\n \"id\": \"bc7f985c-9641-4d0a-9f6f-8d5214d98105\",\n \"key\": \"update_units\"\n }\n ]\n }\n ],\n}\n\nОбновить данные текущего пользователя
\nОбновляет те поля, которые содержатся в запросе. Поля отсутствующие в запросе, не обновляются.
\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"name\": \"Миша\", // имя\n}\n\nПараметры:
\n{\n \"role\": {\"key\": \"Editor\", \"value\": \"Редактор\"}, // не доступно для изменения самому пользователю\n \"password\": \"newpw\" //новый пароль\n \"name\": \"Миша\", //имя \n \"is_driver\": true // делает пользователя водителем \n \"email\": \"test@gmail.com\", //email\n \"code\": \"092384\", // id пользователя (rfid), доступно для пользователя с ролью Editor\n \"language\" : {\"key\":\"en\"} //язык пользователя\n \"phone\" : \"+78902334234\" //телефон пользователя\n \"details\": \"Просто текстовое поле\"\n \"telegram_chat_id\": 12345678910,\n \"settings_web\": {}, // настройки в виде json специфические для web-клиента\n \"settings_ios\": {},// настройки в виде json специфические для iOS-клиента\n \"settings_android\": {},// настройки в виде json специфические для android-клиента\n}\n\nОтвет:
\nВозвращает обновленную запись пользователя см. GET /me
\n","urlObject":{"path":["api_v1","me"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f9123041-1cc8-4189-8c10-5ec51342da86"},{"name":"/users?ids=:ids","id":"1da7a201-1905-4c31-b277-07c1e3db8fd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/users?ids=","description":"Получить информацию о текущем пользователе по его id
\nВозвращает данные по пользователям переданных id. Возвращаются только те пользователи, у которых есть доступ к текущей компании пользователя, который делает запрос.
\nПараметры:
\nids - может содержать как один id пользователя, так и несколько, разделенных через запятую.
\nРоль: Читатель и выше.
\nОтвет:
\nМассив объектов пользователей, каждый объект которого аналогичен возвращаемому через метод GET /me
\n","urlObject":{"path":["api_v1","users"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"1da7a201-1905-4c31-b277-07c1e3db8fd1"},{"name":"/users/:id","id":"feaeae8c-9a62-4aad-a0ae-acfb07422d8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\": \"Вася\", \"transport\":{\"key\": \"Bicycle\"}}"},"url":"{{base_url}}/api_v1/users/:user_id","description":"Обновить информацию о текущем пользователе по его id.
\nОбновление пользователя по его id. Пользователь с ролями User, Provider, Executor может менять только себя.
\nРоль: Администратор и выше.
\nПараметры и ответ аналогичны методу POST /users
\n","urlObject":{"path":["api_v1","users",":user_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"}]}},"response":[],"_postman_id":"feaeae8c-9a62-4aad-a0ae-acfb07422d8e"},{"name":"/users/:id/check_use_name_as_login","id":"856feecc-8274-487f-86b2-b4b42d9bcba2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\": \"Вася\", \"transport\":{\"key\": \"Bicycle\"}}"},"url":"{{base_url}}/api_v1/users/:user_id","description":"Обновить информацию о текущем пользователе по его id.
\nРоут для проверки уникальности строки Имя пользователя для использования в качестве логина
\nРоль: Администратор и выше.
\nПример запроса:
\n{\"name\": \"Иванов Иван Иванович\"}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"}]}},"response":[],"_postman_id":"856feecc-8274-487f-86b2-b4b42d9bcba2"},{"name":"/users/:id","id":"08ed8c91-e15c-4c37-9b4c-e7a6a9ebd834","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Вася\",\n \"transport\": {\n \"key\": \"Bicycle\"\n }\n}"},"url":"{{base_url}}/api_v1/users/:user_id","description":"Удаление пользователя по его id
\nРоль: Администратор и выше.
\n","urlObject":{"path":["api_v1","users",":user_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"}]}},"response":[],"_postman_id":"08ed8c91-e15c-4c37-9b4c-e7a6a9ebd834"},{"name":"/users?ids=:ids","id":"4681ad60-e2ee-4aec-bb48-c4bbdb6c1e1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Вася\",\n \"transport\": {\n \"key\": \"Bicycle\"\n }\n}"},"url":"{{base_url}}/api_v1/users?ids=","description":"Планирование удаления пользователей по их ID
\nЛогика использования, как в DELETE /company/users?ids=:ids
Пользователь с ролью SUPERVISOR может удалять других пользователей.
Роль: Администратор и выше.
\n","urlObject":{"path":["api_v1","users"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"4681ad60-e2ee-4aec-bb48-c4bbdb6c1e1b"},{"name":"/users","id":"526d3411-ecbb-4f7f-9fd2-4ed8ac87600d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/users/21200533-fd3c-4314-bec7-b784dda0214d","description":"Создание пользователей, минуя приглашение.
\nДобавление пользователя с ролью Редактор
\nРоль: Администратор и выше.
\nПараметры:
\n{\n \"role\": {\"key\": \"EDITOR\", \"value\": \"Редактор\", \"id\": \"5ac818aa-f66e-4ecd-8981-5bcbafe03255\"}, // Роль выбирается из списка ролей; достаточно указать только идентификатор. Получить все роли GET /roles\n \"name\": \"Миша\", //имя \n \"password\": \"password for user\", \n \"is_driver\": false // является ли пользователь водителем \n \"email\": \"test@gmail.com\", //email\n \"code\": \"092384\", // id пользователя (rfid), доступно для пользоваетля с ролью Editor\n \"language\" : {\"key\":\"en\"} //язык пользователя\n \"phone\" : \"+78902334234\" //телефон пользователя\n \"details\": \"Просто текстовое поле\"\n \"telegram_chat_id\": 12345678910, //id-рассылки для Telegram, получается из бота\n \"units_groups_access\": [{ //Доступ к группам\n \"units_group\": {\n \"id\": \"d7bad56b-bb05-4c9c-830b-ed192a3fa4de\"\n },\n \"actions\": []//список действий, можно выбирать те actions для которых is_unit_action = true\nуказанные actions применяются для всех объектов группы\n },\n {\n \"units_group\": {\n \"id\": \"1769a313-0c20-4ebf-b7f6-7fce00f4f301\"\n },\n \"actions\": [{\n \"id\": \"051d5caf-b40a-4474-9c25-fb0d83ea4891\",\n \"key\": \"delete_unit\"\n },\n {\n \"id\": \"bc7f985c-9641-4d0a-9f6f-8d5214d98105\",\n \"key\": \"update_unit\"\n }\n ]\n }\n ]\n}\n\nОтвет аналогичен PUT /me
\n","urlObject":{"path":["api_v1","users","21200533-fd3c-4314-bec7-b784dda0214d"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"526d3411-ecbb-4f7f-9fd2-4ed8ac87600d"},{"name":"/users/query","id":"eb61cf7b-b4ad-4194-a7b8-2f1a82d24a66","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"sort\": \"name\",\n \"sortDesc\": true,\n \"from\": 0,\n \"limit\": 100\n}"},"url":"{{base_url}}/api_v1/users/query","description":"Получить пользователей по фильтру
\nНа основании переданных параметров формирует запрос к списку пользователей.
\nПараметры:
\n\"from\": с какой строки возвращать список, 0 - первая. Тип: Integer
\n\"limit\": сколько строк возвращать, если 0 - возвращается количество найденных строк. Тип: Integer
\n\"fields\":[\"id\", \"name\"] - поля, которые необходимо включить в результат
\n\"sortField\": поле, по которoму нужно делать сортировку (используются следующие поля - name, code, details, role.key, email, phone)
\n\"sortDesc\": тип сортировки поля
\n\"value\": подстрока для поиска, для User используются следующие поля - name, code, details, role.key, email, phone
\nРоль: Читатель и выше.
\nПример запроса:
\nПолучить пользователей, у которых в полях есть подстрока 'ася', сортировка по полю name в desc режиме (по убыванию)
\n{\n \"sortField\": \"name\",\n \"sortDesc\": \"true\",\n \"value\": \"ася\",\n \"from\": 0,\n \"limit\": 100\n}\n\nОтвет:
\nВозвращает количество найденых записей, если параметр count=0. Возвращает найденные строки, начиная с указанной в from (отсчет с 0) в количестве, указанном в параметре count или менее, если таких не нашлось.
\nВозвращаемые объекты идентичны получаемым через запрос GET /me
\nЕсли ничего не нашлось, возвращается пустой массив.
\n","urlObject":{"path":["api_v1","users","query"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb61cf7b-b4ad-4194-a7b8-2f1a82d24a66"},{"name":"/users/photos","id":"0dc29654-e259-42cb-8e16-8e3ffb0972f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/Pictures/Screenshot from 2021-09-27 14-19-40.png"},{"key":"id","value":"5798e71d-52b5-4a7e-8089-00647872a3e4","type":"text"}]},"url":"{{base_url}}/api_v1/users/photos","description":"Добавление аватарки пользователю
\nСохраняет фотографии на диске.
\nПервый - оригинальный с url \"/imgs/\" + photo.id + \"_original.png\"
\nВторой - миниатюра - с наибольшей стороной не больее 110 px, url - \"/imgs/\" + photo.id + \"_110.png\"
\nОба файла можно использовать для сохранения в поле photos в сущности users
\nПараметр - id пользователя, которому устанавливаем аватарку.
\nОграничение - размер любой стороны передаваемой картинки не может быть больше 3000px
\nРоль: Читатель и выше.
\nОтвет:
\nВозможные ошибки:
\n422, No File
\n422, No Image
\n422, Image size exceeded 3000x3000
\nВозвращается модель вложения
\n[\n {\n \"id\": \"af571635-340e-4c4e-a4c0-4eab34a97e8c\",\n \"url\": \"/imgs/af571635-340e-4c4e-a4c0-4eab34a97e8c_original.png\",\n \"width\": 858,\n \"height\": 536,\n \"param_type\": \"users\"\n },\n {\n \"id\": \"561518f7-6f1a-4f3c-8b9f-234a91d8ef16\",\n \"url\": \"/imgs/af571635-340e-4c4e-a4c0-4eab34a97e8c_70.png\",\n \"width\": 110,\n \"height\": 43,\n \"param_type\": \"users\"\n }\n]\n\nЗапросить подтверждение пользователя.
\nПараметры:
userId - ID пользователя
Тела запроса JSON:
\nДля подтверждение email: { \"type\": \"EMAIL\" }
\nДля подтверждение номер телефона: { \"type\": \"PHONE\" }
\nМожно отправить запрос, если пользователь не подтвержден. Это определяется полем is_approved пользователя для email и is_approved_phone для номера телефона.
\nВ случае успеха, в результате отправляется ответ 200 и отправляется письмо на почту или на телефон, указанную в настройке пользователя.
\nИначе возвращается ошибка с кодом 422.
\n","urlObject":{"path":["api_v1","ask_approve",":userId"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"userId"}]}},"response":[],"_postman_id":"7e2845cb-3554-447f-9af4-e6ca387baf8b"},{"name":"/users/:id/companies","id":"5995dea2-1015-4b2b-b280-166f40b2868e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"companies\": [\n {\n \"id\": \"2a4b08cd-6c92-4f74-93a9-2cd319caa601\"\n },\n {\n \"id\": \"2f2c629a-9087-4925-8240-d6d6b90aafda\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/users/:id/companies","description":"Удаление пользователя из выбранных компаний.
\nПараметры:
\nid - ID пользователя
\nВ теле запроса указать список компаний (достаточно указать ID компании)
\n","urlObject":{"path":["api_v1","users",":id","companies"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"5995dea2-1015-4b2b-b280-166f40b2868e"},{"name":"/users/:id/change_role","id":"38bc26c2-45f2-4a04-aaef-c016f1d92e99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"role\": {\n \"key\": \"EDITOR\",\n \"name\": \"Редактор\"\n },\n \"companies\": [\n {\n \"id\": \"fc83e935-9c95-4b6f-aee4-be749479a2bc\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/users/:id/change_role","description":"Изменение роли пользователя в компаниях.
\nПараметры:
\nid - ID пользователя
\nВ теле запроса указать:
\nСписок компаний (достаточно указать ID компании).
\nНовую роль в поле role.
\nРоль: Администратор и выше.
\n","urlObject":{"path":["api_v1","users",":id","change_role"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"38bc26c2-45f2-4a04-aaef-c016f1d92e99"},{"name":"/users/:id/change_role_all","id":"6cfa8fa5-bf64-42d2-9b7e-f87d1276d6d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"role\": {\n \"key\": \"ADMIN\",\n \"name\": \"Редактор\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/users/:id/change_role_all","description":"Изменение роли пользователя во всех его компаниях, доступных авторизованному пользователю.
\nПараметры:
\nid - ID пользователя
\nВ теле запроса указать новую роль в поле role
\nПример запроса:
\nPUT /api_v1/users/a8fa266e-3c70-44c8-933e-adb3fe17063d/change_role_all
\n{\n \"role\": {\n \"key\": \"EDITOR\",\n \"name\": \"Редактор\"\n }\n}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"6cfa8fa5-bf64-42d2-9b7e-f87d1276d6d8"},{"name":"/users/:id/addable_companies?search=search","id":"18e95d42-62d3-4329-80bd-b26d77e93cf9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"role\": {\n \"key\": \"ADMIN\",\n \"name\": \"Редактор\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/users/:id/addable_companies?search=","description":"Получение списка компаний, доступных для добавления пользователя
\nПараметры:
\nid - ID пользователя
\nРоль: Администратор и выше.
\nПример запроса:
\nGET /api_v1/users/679bb60d-3563-4bdd-b7c5-bb72bcef69eb/addable_companies?search=Оду
\nПример ответа:
\n[\n {\n \"id\": \"06fe9426-9e0d-455b-9718-8c4f3400370b\",\n \"name\": \"Одуванцик\"\n },\n {\n \"id\": \"fb17d37d-e567-421c-805b-4e2e812c1cf7\",\n \"name\": \"Одуванцик\"\n },\n {\n \"id\": \"fe7b2772-ab94-4248-b32a-ed2da932730d\",\n \"name\": \"Одуванцик\"\n },\n {\n \"id\": \"3dd6b287-e47b-4cb2-9677-57ae4029d8e7\",\n \"name\": \"Одуванцик\"\n },\n {\n \"id\": \"fea12912-a5e4-4a65-bff1-43533daefe68\",\n \"name\": \"Одуванцик 10.0\"\n },\n {\n \"id\": \"2044d5e5-7206-4813-9533-ac89f20409b3\",\n \"name\": \"Одуванцикsdfbdfgnnrtfh\"\n }\n]\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"18e95d42-62d3-4329-80bd-b26d77e93cf9"},{"name":"/users/schedule_delete","id":"b2e924d3-7113-45c0-9fd5-63cb740f8a2e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/users/schedule_delete","description":"Запланированное удаление пользователя из системы.
\nРоль: Читатель и выше.
\nМетод запланирует удаление на 24 часа, а в ответ на метод выдается сообщение
\n200:
\n{\n \"msg\": \"Мы запланировали удаление вашего аккаунта. У вас есть 24 часа чтобы отменить удаление по ссылке, которую мы вам отправили на почту.\"\n}\n\nСоздание пользовательского API_KEY для конкретной компании
\nВы можете предоставить доступ только тем пользователям, у которых есть только одна компания и роль ниже администратора.
\nПараметры запроса:
\nid - Id пользователя
\nВ теле запроса:
\nvalid_to - срок действия ключа (ссылки).
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST /users/8462404e-99a9-4226-ae14-2f59e0400768/create_token
\n{\n \"valid_to\": \"2024-06-21 15:00:00\"\n}\n\nПоле user_company_api_key возвращает ключ, который можно отправлять в запросах в заголовке user_company_api_key.
\nПоле url возвращает ссылку для авторизации пользователя в компании.
\nПример ответа:
\n{ \n \"user_company_api_key\": \"{{vault:json-web-token}}\", \n \"url\": \"https://dev5.skif.pro/api_v1/login?user_company_api_key={{vault:json-web-token}}\"\n}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"c58d59d1-4ae8-408b-bdae-37aa64802817"},{"name":"/me/settings","id":"e4b9dc5f-1728-4227-a0f0-411bc0ebf32b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"key\": \"show_geozones_in_road_xyz\",\n \"value\": \"1\",\n \"version\": 0\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/me/settings","description":"Сохранение пользовательских настроек для текущего пользователя
\nОписание поля в JSON:
\nkey - ключ настройки, строка. Для уникальных настроек, которые используются только в одном стенде, рекомендуется использовать префикс или суффикс. Например, show_geozones_on_map_web
\nvalue - значение настройки, строка.
\nversion - версия настройки, целое число.
\ncompany_id - ID компании, в который сохраняется настройка пользователя.
\nПример запроса:
\n{\n \"key\": \"show_item_in_moon\",\n \"value\": \"1\"\n}\n\nОтвет возвращает массив JSON: все настройки пользователя:
\nПример:
\n[\n {\n \"id\": \"d6e6d77d-46f3-4603-b3b8-abe85cb302b8\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"key\": \"show_item_in_moon\",\n \"value\": \"0\",\n \"version\": 1\n },\n {\n \"id\": \"5b04c69c-1fe7-4815-8c3a-d1056a8b5b65\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"key\": \"show_geozones_in_road_xyz\",\n \"value\": \"1\",\n \"version\": 0\n }\n]\n\nСохранение настройки пользователя в компании:
\n{\n \"key\": \"show_geozones_in_road_3\",\n \"value\": \"1\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"\n}\n\nОтвет:
\n[\n {\n \"id\": \"48379173-7c56-457c-be29-f329fbd284c5\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"show_geozones_in_road_xyz_ssssssssss\",\n \"value\": \"1\",\n \"version\": 0\n },\n {\n \"id\": \"0ba785ce-5fcb-4b88-b8bc-88e0749de321\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"show_geozones_in_road_3\",\n \"value\": \"1\",\n \"version\": 0\n }\n]\n\nПолучение пользовательских настроек для текущего пользователя
\nПараметр запроса company_id - ID компании, необязательное поле. Если указано, настройки возвращаются только для этой компании.
\nОписание поля в JSON:
\nkey - ключ настройки, строка
\nvalue - значение настройки, строка
\nversion - версия настройки, целое число
\nПример:
\n[\n {\n \"id\": \"d6e6d77d-46f3-4603-b3b8-abe85cb302b8\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"key\": \"show_item_in_moon\",\n \"value\": \"0\",\n \"version\": 1\n },\n {\n \"id\": \"5b04c69c-1fe7-4815-8c3a-d1056a8b5b65\",\n \"user_id\": \"a4b5fde8-9b70-4425-bd75-bde7f12c9f87\",\n \"key\": \"show_geozones_in_road_xyz\",\n \"value\": \"1\",\n \"version\": 0\n }\n]\n\nВозможность переключение под пользователем без запроса пароля
\nПараметры запроса:
\nuser_id - ID пользователя для переключения.
\ncompany_id - ID компании для переключения.
\nРоль: Администратор и выше.
\nПример запроса:
\n\nВ результате пользователь перенаправляется на страницу в которой пользователь авторизуется под выбранным пользователем.
\nДля авторизованного пользователя таким способом возвращается в GET /me поле another_user: true
ID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"user_id"},{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"7536f3aa-9b44-474a-96d1-5a692ca7a8a1"}],"id":"3829e332-3894-e650-4e48-47167aaa781a","_postman_id":"3829e332-3894-e650-4e48-47167aaa781a","description":""},{"name":"Общее","item":[{"name":"/dictionaries/:dicType","id":"f4bd4373-feea-493b-a005-a3879f86b371","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/dictionaries/:dicType","description":"Получить все записи справочника Dictionary с указанным типом.
\nОписание параметров:
\ndicType - тип записей, которые необходимо получить.
\nМожет принимать следующие значения:
\nadmin_modules
color_code
customfield_groups
formula
geo_icon
geozone_type
notification_type
periodic_type
report_template_table_grouping
report_template_table_type
sensor_type
terminal_type
trip_activation_type
trip_passage_order_type
unit_icon
unit_type
weekdays_type
Пример запроса:
\nGET /dictionaries/unit_type
\nвозвращает все часовые пояса в формате (пример для английской локали):
\n[{\n \"type\": \"unit_type\",\n \"key\": \"farm_equipment\",\n \"value\": \"Farm equipment\"\n}, {\n \"type\": \"unit_type\",\n \"key\": \"house\",\n \"value\": \"House\"\n }\n}]\n\nОписание параметров ответа:
type - тип справочника,
key - ключ справочника,
value - перевод справочника на язык пользователя
В случае отсутствия записей переданного типа возвращает пустой массив []
\n","urlObject":{"path":["api_v1","dictionaries",":dicType"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"dicType"}]}},"response":[],"_postman_id":"f4bd4373-feea-493b-a005-a3879f86b371"},{"name":"/dictionaries","id":"de8cf2aa-31d4-432f-b425-f726c72079c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/dictionaries/unit_type","description":"Получить все записи справочника Dictionary
\nПример запроса:
\nGET /dictionaries
\nвозвращает все справочники (пример для английской локали) сортируя по type:
\n[{\n \"key\": \"admin_geozones\",\n \"type\": \"admin_modules\",\n \"value\": \"Geozones\"\n},\n...\n {\n \"type\": \"unit_type\",\n \"key\": \"house\",\n \"value\": \"House\"\n }\n},\n...\n{\n \"key\": \"monday\",\n \"type\": \"weekdays_type\",\n \"value\": \"Понедельник\"\n}\n]\n\nОписание параметров ответа:
type - тип справочника, все возможные знечения:
admin_modules
color_code
customfield_groups
formula
geo_icon
geozone_type
notification_type
periodic_type
report_template_table_grouping
report_template_table_type
sensor_type
terminal_type
trip_activation_type
trip_passage_order_type
unit_icon
unit_type
weekdays_type
key - ключ справочника,
value - перевод справочника на язык пользователя
Получить все записи справочника Properties с указанным типом.
\nСправочник 'Properties' предназначен ТОЛЬКО для микросервиса auth и включает в себя только информацию о юзере.
\nОписание параметров:
\npropertiesType - тип записей, которые необходимо получить.
\nМожет принмать следующие значения:
\nlanguages (языки),
\ntimezones (часовые пояса)
\nroles (роли)
\ndateformats (форматы даты)
\ntimeformats (форматы времени)
\nПример запроса:
\nGET /properties/timezones
\nВозвращает все часовые пояса в формате (пример для английской локали):
\n[{\n \"type\": \"timezones\",\n \"key\": \"UTC+4:30\",\n \"value\": \"Kabul, Afghanistan (+4:30)\"\n}, {\n \"type\": \"timezones\",\n \"key\": \"UTC+6:30\",\n \"value\": \"Yangon, Myanmar (+6:30)\"\n }\n}]\n\nОписание параметров ответа:
type - тип справочника,
key - ключ справочника,
value - перевод справочника на язык пользователя
В случае отсутствия записей переданного типа возвращает пустой массив []
\n","urlObject":{"path":["api_v1","properties",":propertiesType"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"propertiesType"}]}},"response":[],"_postman_id":"03eaf349-931e-4146-8498-8670b02e7784"},{"name":"/properties","id":"6914f78a-a3fe-4f71-a868-84f62a31c03a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/properties","description":"Получить все записи справочника Properties
\nСправочник 'Properties' предназначен ТОЛЬКО для микросервиса auth и включает в себя только информацию о пользователе.
\nПример запроса:
\nGET /properties
\nВозвращает все записи (пример для английской локали):
\n[{\n \"key\": \"yyyy-MM-dd\",\n \"type\": \"dateformats\",\n \"value\": \"yyyy-MM-dd(2014-01-25, 1987-12-02)\"\n}, \n...\n{\n \"key\": \"NO_ACCESS\",\n \"type\": \"roles\",\n \"value\": \"NoAccess\"\n}\n...\n{\n \"key\": \"UTC+5\",\n \"type\": \"timezones\",\n \"value\": \"(GMT + 05: 00) Yekaterinburg, Islamabad, Karachi, Tashkent\"\n}\n}]\n\nОписание параметров ответа:
type - тип справочника, все возможные значения:
languages - языки
timezones - часовые пояса
roles - роли
dateformats - форматы даты
timeformats - форматы времени
key - ключ справочника
value - перевод справочника на язык пользователя
Получить доступ текущего пользователя к сущностям системы
\nФормат возвращаемых данных:
\n{\n \"edit_classes_fields\": [{ //доступ на редактирование к полям сущностей в целом\n \"type\": \"users\",\n \"fields\": [\"name\", \"photo\", \"email\", \"phone\", \"code\"]\n }],\n \"edit_objects_fields\": [{ //доступ на редактирование к полям конкретной сущности\n \"type\": \"users\",\n \"id\": \"23498320-32492-3294-23989487\",\n \"fields\": [\"name\", \"photo\", \"email\", \"phone\", \"code\"]\n }],\n \"actions\": [\"btmCreateUser\", \"btmDeleteUser\", \"btmSendCommand\"] //доступ к действиям\n}\n\nОписание параметров ответа:
\nedit_classes_fields - ключ тега, содержащий массив ограничений на редактирование к сущности
\ntype - ключ сущности, возможные значения users, units, geozones, routes, report_templates, notifications_templates
\nfields - массив полей доступных пользователю на редактирование
\nedit_objects_fields - ключ тега, содержащий массив ограничений, на редактирование конкретных сущностей
\nid - идентификатор сущности, к которой применяется ограничение
\nactions - ключ тега, содержащий массив ключей действий, к которым имеет доступ пользователь
\nДоступ определяется на основании роли пользователя к текущей компании и сущностям, к которым он имеет эксклюзивный доступ (например, собственная карточка пользователя)
\n","urlObject":{"path":["api_v1","access"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"81be0d95-74cf-4c56-b5ff-9e70750496e5"},{"name":"/custom_fields","id":"05ee6204-6755-48ec-aeac-ba53f1041e9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{base_url}}/api_v1/custom_fields","description":"Запрос на получение обязательных custom_fields
\nCustom_fields юнита делятся на 2 типа - обязательные и необязательные (кастомные).
\nОбязательные custom_fields это поля, которые должны присутствовать у каждого юнита. При создании/изменении юнита лучше всего передавать эти обязательные поля со значениями, установленными юзером. Если бэкенд не обнаружит в юните какого-то обязательного поля, то оно будет создано в нём автоматически, значение будет взято из default_value.
Бэкенд проверяет значения через паттерн. В случае не соответствия паттерну, будет выброшена ошибка.
Необязательные поля - произвольные поля, созданные юзером дополнительно. Никак не проверяются на стороне бэкенда. По состоянию на май 2020г. используются как поля для дополнительной информации (пояснительные) и не участвуют в каких-либо расчетах.
\nCustom_field юнита имеет следующие параметры
name - имя поля, которое отображается в интерфейсе. У обязательных полей - не изменяемо (поэтому пытаться изменить его название в юните не имеет смысла). У НЕобяз. - изменяемое, произвольное.
key - ключ custom_fields. Все поля определяются и распознаются бэкендом именно по ключу. У обяз.полей - ключ константный, у необяз. полей - ключ произвольный, договорились использовать key такой же как и name.
value - значение, которое пользователь присвоил этому кастом филду.
Пример ответа:
\n[\n {\n \"name\": \"Мин. объем заправки\",\n \"key\": \"fuel_fillings_minfilling\",\n \"default_value\": \"10\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Расход летом (л/100км.)\",\n \"key\": \"fuel_consumption_summerconsump\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. время стоянки (сек)\",\n \"key\": \"tripdetector_minparktime\",\n \"default_value\": \"300\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Аналитик\",\n \"key\": \"analyst\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Игнор-ть сообщ-я после начала движения\",\n \"key\": \"fuel_fillings_msgignorestart\",\n \"default_value\": \"60\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 2,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Расход зимой (л/100км.)\",\n \"key\": \"fuel_consumption_winterconsump\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 2,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Коэф. пробега\",\n \"key\": \"advanced_mileagecoeff\",\n \"default_value\": \"1\",\n \"pattern\": \"^\\\\d{1,8}((,|.)\\\\d{1,8})?$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 2,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Установщик\",\n \"key\": \"installer\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 2,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. время остановки для опр-ия слива\",\n \"key\": \"fuel_fillings_minstaytheft\",\n \"default_value\": \"60\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 3,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"На холостом ходу летом (л./час.)\",\n \"key\": \"fuel_math_idlingsummer\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 3,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. скорость движ-я (км/ч)\",\n \"key\": \"tripdetector_minmovespeed\",\n \"default_value\": \"3\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 3,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. объем слива\",\n \"key\": \"fuel_fillings_minitheft\",\n \"default_value\": \"10\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 4,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"На холостом ходу зимой (л./час.)\",\n \"key\": \"fuel_math_idlingwinter\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 4,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. расст-ие поездки (м)\",\n \"key\": \"tripdetector_mintripdist\",\n \"default_value\": \"100\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 4,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Дата установки(формат год-месяц-день, например 2019-03-07)\",\n \"key\": \"install_date\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 4,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Коэф. при движении под нагрузкой\",\n \"key\": \"fuel_math_coeffunderload\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 5,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Макс. интервал между сообщ-ми (сек)\",\n \"key\": \"advanced_maxintervalmsg\",\n \"default_value\": \"3600\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 5,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Место установки в ТС\",\n \"key\": \"install_place\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 5,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Первый месяц зимы (январь-1)\",\n \"key\": \"fuel_consumption_winterfrom\",\n \"default_value\": \"11\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 6,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Макс. расст-ие между сообщ-ми (м)\",\n \"key\": \"tripdetector_maxdistancemsg\",\n \"default_value\": \"1000\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 6,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер терминала\",\n \"key\": \"serial_number\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 6,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Последний месяц зимы (январь-1)\",\n \"key\": \"fuel_consumption_winterto\",\n \"default_value\": \"3\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 7,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. время поездки (сек)\",\n \"key\": \"tripdetector_mintriptime\",\n \"default_value\": \"60\",\n \"pattern\": \"^\\\\d+$\",\n \"type\": \"text\",\n \"group\": \"cf_trips\",\n \"values\": [],\n \"sort\": 7,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер ДУТ\",\n \"key\": \"serial_number_dut\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 7,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Стоимость (1 л.)\",\n \"key\": \"fuel_price\",\n \"default_value\": \"0\",\n \"pattern\": \"^[0-9]*\\\\.?[0-9]+$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 8,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Опр-ие движ-я\",\n \"key\": \"key_tripdetector_movedetect\",\n \"default_value\": \"speedkph\",\n \"pattern\": \"^[a-zA-Zа-яА-Я\\\\.\\\\_]*$\",\n \"type\": \"list\",\n \"group\": \"cf_trips\",\n \"values\": [\n {\n \"key\": \"speedkph\",\n \"value\": \"Скорость\"\n },\n {\n \"key\": \"ignition\",\n \"value\": \"Зажигание\"\n }\n ],\n \"sort\": 8,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер пломбы ДУТ\",\n \"key\": \"dut_seal_serial_number\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 8,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Определение пробега\",\n \"key\": \"tripdetector_mileagedetect\",\n \"default_value\": \"mileage_GPS\",\n \"pattern\": \"^[a-zA-Zа-яА-Я\\\\.\\\\_]*$\",\n \"type\": \"list\",\n \"group\": \"cf_trips\",\n \"values\": [\n {\n \"key\": \"mileage_GPS\",\n \"value\": \"GPS\"\n },\n {\n \"key\": \"mileage_mileage_sensor\",\n \"value\": \"Cенсор\"\n },\n {\n \"key\": \"mileage_relative_mileage\",\n \"value\": \"Относительный пробег\"\n },\n {\n \"key\": \"mileage_GPS_ignition\",\n \"value\": \"GPS зажигание\"\n }\n ],\n \"sort\": 9,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Гос номер\",\n \"key\": \"license_plate_number\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 9,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Определение моточасов\",\n \"key\": \"key_motohourdetector\",\n \"default_value\": \"ignition\",\n \"pattern\": \"^[a-zA-Zа-яА-Я\\\\.\\\\_]*$\",\n \"type\": \"list\",\n \"group\": \"cf_motohours\",\n \"values\": [\n {\n \"key\": \"ignition\",\n \"value\": \"Зажигание\"\n },\n {\n \"key\": \"abs_motohours\",\n \"value\": \"Абсолютные моточасы\"\n },\n {\n \"key\": \"relative_motohours\",\n \"value\": \"Относительные моточасы\"\n }\n ],\n \"sort\": 10,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Норма часов в день\",\n \"key\": \"hours_rate\",\n \"default_value\": \"8\",\n \"pattern\": \"^((2[0-4]|1[0-9]|[0-9])|((2[0-3]|1[0-9]|[0-9])\\\\.[0-9]+))$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 10,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Дата блокировки(формат год-месяц-день, например 2019-03-07)\",\n \"key\": \"block_date\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 11,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"КП\",\n \"key\": \"kp\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 12,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"ДУТ\",\n \"key\": \"dut\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 13,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Вторая sim\",\n \"key\": \"second_sim\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 14,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер ДУТ 1\",\n \"key\": \"serial_number_dut_1\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 15,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер ДУТ 2\",\n \"key\": \"serial_number_dut_2\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 16,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Марка машины\",\n \"key\": \"brand_name\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 17,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Вид топлива (бенз., д/т)\",\n \"key\": \"fuel_type\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 18,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Марка горючего\",\n \"key\": \"fuel_mark\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_fuel\",\n \"values\": [],\n \"sort\": 19,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Код марки\",\n \"key\": \"brand_code\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 20,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Видео устройство\",\n \"key\": \"video_device_name\",\n \"default_value\": \"\",\n \"pattern\": \"^(?:|CARVIS)$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 21,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"ID-видео устройства\",\n \"key\": \"video_device_id\",\n \"default_value\": \"\",\n \"pattern\": \"^.*$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 22,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Камеры\",\n \"key\": \"video_cameras\",\n \"default_value\": \"\",\n \"pattern\": \"^(|\\\\d+(?:[\\\\t]*,[\\\\t]*\\\\d+)*+)$\",\n \"type\": \"text\",\n \"group\": \"cf_etc\",\n \"values\": [],\n \"sort\": 23,\n \"show_in_monitoring\": false,\n \"hint\": \"Несколько числовых значений разделенных запятой, например 0,1,3,7\"\n }\n]\n\nПолучение изменений в справочниках
\nИспользуется один вебсокет для получения следующих данных:
\nПоследнего сообщения от объекта
\nУведомлений за последние сутки
\nНовых уведомлений
\nИзменения справочников
\nЕсли сервер использует протокол HTTP, то вебсокет должен работать по протоколу WS. Аналогично, если сервер использует HTTPS, то вебсокет должен работать по протоколу WSS.
\nМожно также передать параметр ?from_time=1628259485000, где значение — это метка времени в формате Unix (в часовом поясе пользователя). Это нужно, если вы хотите получить данные, начиная с определённого момента времени. Например, если у вас уже есть закэшированные данные на клиенте, и вы хотите получить только новые сообщения, начиная с этого времени.
Примеры:
\n[\n {\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"336024861\",\n \"group\": \"main\"\n },\n {\n \"key\": \"datepoint\",\n \"name\": \"Был на связи\",\n \"value\": \"2023-11-26 05:34:13\",\n \"group\": \"main\"\n },\n {\n \"key\": \"_datepoint\",\n \"name\": \"_datepoint\",\n \"value\": \"2023-11-26 05:34:13\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_unix_timestamp\",\n \"name\": \"_unix_timestamp\",\n \"value\": 1700966053,\n \"group\": \"hidden\"\n },\n {\n \"key\": \"speed\",\n \"name\": \"Скорость\",\n \"value\": 0,\n \"group\": \"gps\"\n },\n {\n \"key\": \"satellites\",\n \"name\": \"Спутники\",\n \"value\": 17,\n \"group\": \"gps\"\n },\n {\n \"key\": \"_angle\",\n \"name\": \"Угол\",\n \"value\": 159,\n \"group\": \"hidden\"\n },\n {\n \"key\": \"address\",\n \"name\": \"Адрес\",\n \"value\": \"41.1201 44.8419\",\n \"group\": \"gps\"\n },\n {\n \"key\": \"_imei\",\n \"name\": \"imei\",\n \"value\": \"336024861\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_marker_latlon\", //координаты, широта и долгота\n \"name\": \"_marker_latlon\",\n \"value\": [\n 41.1200669,\n 44.8419028\n ],\n \"group\": \"hidden\"\n }\n ],\n \"unit_id\": \"363771f3-9769-4817-b986-b22ee9f37fdd\",\n \"unit_name\": \"336024861\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"\n }\n]\n\n{\n \"notify\": {\n \"time\": \"2020-10-16 17:03:16\", //время изменений\n \"objects\": \"units\", //изменяемая сущность - \"users\", \"units\", \"notifications\" и т.д.\n \"operation\": \"PUT\", // операция изменения - PUT,POST,DELETE,PATCH\n \"id\": \"9eb8b795-dfb0-46e7-a35d-0fc43512ba66\", //id изменяемой сущности\n \"msg\": \"Пользователь Mih обновил объект\" //сообщение \n }\n}\n\nИконки для наглядного отображения состояния датчиков в мониторинге
\nДобавляется новое поле sensors_settings (массив), если для компании были настроены датчики.
{\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"Omnicomm 22 336023861\",\n \"group\": \"main\"\n },\n {\n \"key\": \"datepoint\",\n \"name\": \"Был на связи\",\n \"value\": \"2025-02-18 15:20:17\",\n \"group\": \"main\"\n },\n ...\n ],\n \"sensors_settings\": [\n {\n \"name\": \"Уровень топлива\", // Название, по этому значению определяется\n \"icon\": \"icon_fuel_level\", // иконка\n \"sensor_name\": \"Топлива\",// Название найденного датчика\n \"sensor_value\": 17, //Значение датчика\n \"style_color\": \"#51AAEB\" // Цвет иконки рассчитывается на основе показаний датчика\n }\n ],\n \"unit_id\": \"e037342f-e891-44d7-91b6-354ede0ef629\",\n \"unit_name\": \"Omnicomm 22\",\n \"company_id\": \"3e70f167-9fad-4753-bуcf-d7d47c2c648c\"\n}\n\nПолучение изменений по ID локатора; см. Locators
\nПосле подключения через сокет, поступает информация о местоположении связанного с локатором объекта.
\nСтруктура как в /messages, но приходят только поля unit_name, datepoint, _datepoint, address, _marker_latlon
\n","urlObject":{"protocol":"wss","path":["locator_msg"],"host":["{{base_url}}"],"query":[{"key":"id","value":""}],"variable":[]}},"response":[],"_postman_id":"b40d4ba6-8227-4d85-8412-43b8b92bfba5"},{"name":"/messages?monitoring_filter=filter","id":"0c95d1c8-2138-4c39-87ff-77de6d7257e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"wss://{{base_url}}/messages?monitoring_filter={\"conditions\":[{\"field\":\"name\",\"value\": \"Бензовоз\"},{\"field\":\"sensors.type.key\",\"value\": \"ignition\"}]}","description":"Получение изменений в справочниках + фильтрация объектов в мониторинге
\nВ поле conditions можно указать условия в полях field и value.
\nНапример:
wss://dev5.skif.pro/messages?monitoring_filter={\"conditions\":[{\"field\":\"name\",\"value\": \"Бензовоз\"},{\"field\":\"sensors.type.key\",\"value\": \"ignition\"}]}
Возможные значения field:
Вот эти поля сейчас есть в фильтре в списке объектов:
name - Имя
\nimei - IMEI
\nphonenumber - Телефоны, на обоих номер телефона ищется
\ncustom_fields - Доп. поля, на значения в дополнительных полей ищется
\nsensors.name - Имена датчиков
\nsensors.type.key - Типы датчиков, например ignition. Возможные значения можно получить из справочника с типом sensor_type
\nsensors.param - Параметр датчиков, например dut_485_1, возможные значение можно получать с помощью GET /units/sensors/params
\nevents - События, по описанию
\nevents.type.key - Типы событий, например filling. Из справочника можно получать с типом event_type
\ngroups - Группа, можно отправить название или ID группы
\ndriver - Водитель, можно отправить имя или ID водителя или код водителя (пользователи, для которых is_driver=true)
\nВ value можно отправить несколько значений разделенных запятыми.
При изменении данных на сокет приходит сообщение в виде {\"monitoring_units\" : [\"ID1\", \"ID2\", \"ID3\"]}
Надо оставлять только эти объекты в мониторинге.
Когда фильтр изменяется, необходимо переподключится
Получение координат по адресу
\n","urlObject":{"path":["api_v1","geocode",":address"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"address"}]}},"response":[],"_postman_id":"4e7ce341-1121-43a9-bc3c-329653738761"},{"name":"/routing/:points","id":"d6db4c76-4eb3-4f67-8089-386f865febb9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/routing/:points","description":"Построение маршрута, проходящего через указанные точки
\nСтруктура запроса:
points - Список точек в формате : latitude1,longitude1;latitude2,longitude2;...;latitudeN,longitudeN
Можно указать до 10 точек.
Структура ответа, как в ответе на запрос /fastracks
\nПример запроса:
GET /routing/76.928054,43.226996;76.913200,43.237085;76.887795,43.217677
Пример ответа:
\n{\n \"columns\": [\n {\n \"key\": \"longitude\",\n \"value\": \"Долгота\"\n },\n {\n \"key\": \"latitude\",\n \"value\": \"Широта\"\n }\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 43.22688,\n 76.928102\n ],\n [\n 43.22682,\n 76.92688\n ],\n [\n 43.226827,\n 76.924814\n ],\n [\n 43.22683,\n 76.923471\n ],\n [\n 43.22688,\n 76.928102\n ],\n [\n 43.22655,\n 76.915747\n ],\n [\n 43.228767,\n 76.91545\n ],\n [\n 43.231589,\n 76.915042\n ],\n [\n 43.235994,\n 76.913977\n ],\n [\n 43.22655,\n 76.915747\n ],\n [\n 43.236787,\n 76.91353\n ],\n [\n 43.236787,\n 76.91353\n ],\n [\n 43.236508,\n 76.91167\n ],\n [\n 43.236508,\n 76.91167\n ],\n [\n 43.237132,\n 76.913191\n ],\n [\n 43.237132,\n 76.913191\n ],\n [\n 43.237132,\n 76.913191\n ],\n [\n 43.236318,\n 76.916238\n ],\n [\n 43.236532,\n 76.918205\n ],\n [\n 43.237132,\n 76.913191\n ],\n [\n 43.236552,\n 76.918459\n ],\n [\n 43.236552,\n 76.918459\n ],\n [\n 43.237071,\n 76.918404\n ],\n [\n 43.237071,\n 76.918404\n ],\n [\n 43.237018,\n 76.917373\n ],\n [\n 43.237018,\n 76.917373\n ],\n [\n 43.236609,\n 76.916195\n ],\n [\n 43.236609,\n 76.916195\n ],\n [\n 43.236423,\n 76.916222\n ],\n [\n 43.236342,\n 76.911073\n ],\n [\n 43.236423,\n 76.916222\n ],\n [\n 43.235898,\n 76.909104\n ],\n [\n 43.235898,\n 76.909104\n ],\n [\n 43.235355,\n 76.909171\n ],\n [\n 43.233921,\n 76.904739\n ],\n [\n 43.23341,\n 76.903425\n ],\n [\n 43.232191,\n 76.900306\n ],\n [\n 43.231343,\n 76.898147\n ],\n [\n 43.231138,\n 76.897599\n ],\n [\n 43.230524,\n 76.896052\n ],\n [\n 43.230227,\n 76.895309\n ],\n [\n 43.229308,\n 76.893823\n ],\n [\n 43.228953,\n 76.893265\n ],\n [\n 43.228357,\n 76.892376\n ],\n [\n 43.228289,\n 76.892268\n ],\n [\n 43.227905,\n 76.89167\n ],\n [\n 43.235355,\n 76.909171\n ],\n [\n 43.227609,\n 76.891202\n ],\n [\n 43.224853,\n 76.891568\n ],\n [\n 43.224363,\n 76.891627\n ],\n [\n 43.223981,\n 76.891668\n ],\n [\n 43.222661,\n 76.891839\n ],\n [\n 43.221646,\n 76.892001\n ],\n [\n 43.221156,\n 76.89205\n ],\n [\n 43.227609,\n 76.891202\n ],\n [\n 43.218662,\n 76.892376\n ],\n [\n 43.218381,\n 76.8895\n ],\n [\n 43.218332,\n 76.888697\n ],\n [\n 43.218662,\n 76.892376\n ],\n [\n 43.217725,\n 76.887653\n ],\n [\n 43.217725,\n 76.887653\n ]\n ]\n }\n ]\n}\n\nПоиск места по адресу
\nЗапрос:
\n{\n \"part\": \"Москва\"\n}\n\npart - часть текста
\nСтруктура ответа:
JSON массив, где каждый элемент имеет следующие поля:
- name : Название места
- decription : Описание места
- pos : Координаты места в формате: [широта, долгота]
Пример запроса:
\n{\n \"part\": \"Алма\"\n}\n\nПример ответа:
\n[\n {\n \"name\": \"Алматы\",\n \"description\": \"Казахстан\",\n \"pos\": [\n 76.945627,\n 43.237163\n ]\n },\n {\n \"name\": \"река Алма\",\n \"description\": \"Амурская область, Россия\",\n \"pos\": [\n 124.708934,\n 53.214184\n ]\n },\n {\n \"name\": \"Алма\",\n \"description\": \"провинция Онтарио, Канада\",\n \"pos\": [\n -80.502192,\n 43.727401\n ]\n }\n]\n\nПолучение серверов по email пользователя
\nПараметр body содержит следущие поля:
\nemail (обязательный) - email пользователя
\nget (необязательный) - возможные значения: \"ktzh\" - для получения серверов приложения КТЖ, \"all\" - для получения всех доступных серверов
\n","urlObject":{"path":["api_v1","servers"],"host":["{{base_url}}"],"query":[{"key":"body","value":""}],"variable":[]}},"response":[],"_postman_id":"706ec81e-c50d-4cd2-bf17-2964f0d4816e"},{"name":"/points_geozones","id":"82a2da09-2e1f-4051-8026-94782281b74a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"model\": \"geozones\",\n \"from\": 0,\n \"count\": 100\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/points_geozones","description":"Получение точек с информацией о вхождении в геозоны
\nРоль: Администратор и выше.
\nПример запроса:
\n{\n \"model\": \"units\",\n \"value\": \"тест\", // для поиска\n \"from\": 0,\n \"count\": 100\n}\n\nПример ответа:
\n {\n \"max\": 2,\n \"list\": [{\n \"id\": \"53e57d49-4e98-4399-bbf2-b03964df68b7\",\n \"name\": \"testName-777\",\n \"imei\": \"e2f856c7-e7a9-4071-adb4-f76df176661b\",\n \"company_id\": \"11111111-1111-1111-1111-111111111111\",\n \"company_name\": \"companyName\"\n }, {\n \"id\": \"9e49f72f-1f1a-46c3-9e61-b61a5f9900ea\",\n \"name\": \"testName-22222222\",\n \"imei\": \"06ee6786-905b-4aa3-ac65-2a18054128ea\",\n \"company_id\": \"11111111-1111-1111-1111-111111111111\",\n \"company_name\": \"companyName\"\n }]\n }\n\nКопирует сущности из одной компании в другую (пока реализовано для units, geozones и reports_templates)
\nРоль: Супервизор и выше.
\nПримеры запросов:
\nКопирование в 1 компанию:
\n{\n \"type\": \"units\",\n \"ids\": [\"b92f5e06-ee48-4a08-8647-d805465e7be8\", \"b5298b57-df70-405e-b2b6-071ed230d36c\"], \n \"to_company_id\": \"0aa10a42-fc54-497c-a54b-3295e4633348\"\n}\n\nМожно копировать в несколько компаний:
\n{\n \"type\": \"units\",\n \"ids\": [\"b92f5e06-ee48-4a08-8647-d805465e7be8\", \"b5298b57-df70-405e-b2b6-071ed230d36c\"], \n \"to_company_id\": [\"0aa10a42-fc54-497c-a54b-3295e4633348\", \"qffa142-fc54-497c-a54b-3295e4633348\" ]\n}\n\nА чтобы копировать все сущности c другой компании:
\n{\n \"type\": \"units\",\n \"from_company_id\": \"b92f5e06-ee48-4a08-8647-d805465e7be8\", \n \"to_company_id\": \"0aa10a42-fc54-497c-a54b-3295e4633348\"\n}\n\nТакже можно скопировать в несколько компаний:
\n{\n \"type\": \"units\",\n \"from_company_id\": \"b92f5e06-ee48-4a08-8647-d805465e7be8\", \n \"to_company_id\": [\"0aa10a42-fc54-497c-a54b-3295e4633348\", \"qffa142-fc54-497c-a54b-3295e4633348\"]\n}\n\nВозможные значения type - \"units\", \"geozones\" или \"report_templates\" ( в будущем будут: \"unitsgroup\", \"units\", \"geozones\", \"notifications\", \"routes\", \"trailers\", \"mailings\")
\nids - id сущностей, которые нужно скопировать в другую компанию.
\nfrom_company_id - id компании, c которой нужно скопировать все сущности.
\nto_company_id - id компании, в которую нужно скопировать сущности.
\nВ случае успеха возвращается код 200, иначе текст ошибки.
\n","urlObject":{"path":["api_v1","copy"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc150b1f-8526-4c90-a93b-01030e1628f7"},{"name":"/sessions_excel","id":"432ccf86-f9f3-4b7c-90a1-5ce6a636ea1c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"units\",\n \"ids\": [\"d20f1b59-85c3-46a2-b90e-5915fcdda7cb\"], \n \"to_company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/copy","description":"Копирует сущности из одной компании в другую (пока реалзировано для units и geozones)
\nПримеры запросов:
\n{\n \"type\": \"units\",\n \"ids\": [\"b92f5e06-ee48-4a08-8647-d805465e7be8\", \"b5298b57-df70-405e-b2b6-071ed230d36c\"], \n \"to_company_id\": \"0aa10a42-fc54-497c-a54b-3295e4633348\"\n}\n\nА чтобы копировать все сущности c другого компания:
\n{\n \"type\": \"units\",\n \"from_company_id\": \"b92f5e06-ee48-4a08-8647-d805465e7be8\", \n \"to_company_id\": \"0aa10a42-fc54-497c-a54b-3295e4633348\"\n}\n\nВозможные значения type - \"units\" или \"geozones\" ( в будущем будут: \"unitsgroup\", \"units\", \"geozones\", \"report_templates\", \"notifications\", \"routes\", \"trailers\", \"mailings\")
\nids - id сущностей которые нужно скопировать в другую компанию
\nfrom_company_id - id компании c которого нужно скопировать все сущности
\nto_company_id - id компании в которую нужно скопировать сущности
\nВ случае успеха возвращается код 200, иначе текст ошибки
\n","urlObject":{"path":["api_v1","copy"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"432ccf86-f9f3-4b7c-90a1-5ce6a636ea1c"},{"name":"/restore","id":"756e8f81-9f7f-40e9-ba7d-2a358f51ec04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"units\",\n \"ids\": [\"afcbb296-ce2b-403b-8e1e-f3c12e6f108c\"]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/restore","description":"Восстанавливает сущности (пока реализовано для units)
\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n \"type\": \"units\",\n \"ids\": [\"b92f5e06-ee48-4a08-8647-d805465e7be8\", \"b5298b57-df70-405e-b2b6-071ed230d36c\"]\n}\n\nВозможные значения type - \"units\" ( в будущем будут: \"unitsgroup\", \"units\", \"geozones\", \"report_templates\", \"notifications\", \"routes\", \"trailers\", \"mailings\")
\nids - id сущностей, которые нужно востановить.
\nВ случае успеха возвращается код 200, иначе текст ошибки.
\n","urlObject":{"path":["api_v1","restore"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"756e8f81-9f7f-40e9-ba7d-2a358f51ec04"},{"name":"/admin_query","id":"4bec4758-e20d-428a-902f-d34aeb63a729","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"model\": \"units\",\n \"from\": 0,\n \"count\": 100,\n \"companies\": [\n {\"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"}\n ],\n \"conditions\": [\n {\"field\": \"terminal_type_key\", \"values\":[\"adm\",\"galileo\"]},\n {\"field\": \"sensors.type_key\", \"values\": [\"cardnumber,ignition\"]}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/admin_query","description":"Получение сущностей по всем компаниям
\nРоль: Администратор и выше.
\nПримеры запросов:
\n{\n \"model\": \"units\",\n \"value\": \"тест\", //для поиска\n \"from\": 0,\n \"count\": 100\n}\n\nДля получение удаленных объектов:
\n{\n \"model\": \"units\",\n \"value\": \"тест\", //для поиска\n \"from\": 0,\n \"count\": 100,\n \"is_delete\": true\n}\n\nДля фильтрации по компании указать компании в поле companies:
\n{\n \"model\": \"units\",\n \"value\": \"тест\", /для поиска\n \"from\": 0,\n \"count\": 100,\n \"companies\": [\n {\"id\": \"935aa95a-d245-42d9-92ea-da6a2530d59c\"},\n {\"id\": \"25d1ff38-e39e-42f4-9659-2124d308400c\"}\n ],\n \"conditions\": [\n {\"field\": \"terminal_type_key\", \"values\":[\"adm\",\"galileo\"]},\n {\"field\": \"sensors.type_key\", \"values\": [\"cardnumber,ignition\"]}\n ] \n}\n\nВозможные значения model - \"unitsgroup\", \"units\", \"geozones\", \"report_templates\", \"notifications\", \"routes\", \"trailers\", \"mailings\", \"terminals\", \"retranslators\".
\nВ conditions можно указать дополнительный фильтр для объектов по протоколам и типам датчиков.
\nЧтобы фильтровать по интегратору надо отправить в запросе поле dealer. Достаточно указать id.
\n\"dealer\": {\"id\": \"8a7d85f9-156e-41ab-9534-da71d1847cba\"}
\nПример ответа:
\n {\n \"max\": 2,\n \"list\": [{\n \"id\": \"53e57d49-4e98-4399-bbf2-b03964df68b7\",\n \"name\": \"testName-777\",\n \"imei\": \"e2f856c7-e7a9-4071-adb4-f76df176661b\",\n \"company_id\": \"11111111-1111-1111-1111-111111111111\",\n \"company_name\": \"companyName\"\n }, {\n \"id\": \"9e49f72f-1f1a-46c3-9e61-b61a5f9900ea\",\n \"name\": \"testName-22222222\",\n \"imei\": \"06ee6786-905b-4aa3-ac65-2a18054128ea\",\n \"company_id\": \"11111111-1111-1111-1111-111111111111\",\n \"company_name\": \"companyName\"\n }]\n }\n\nПример получения тех. параметров объекта: укажите необходимое поле в виде custom_fields.
\n{\n \"model\": \"units\",\n \"fields\": [\"id\", \"name\", \"custom_fields.tripdetector_minmovespeed\"],\n \"from\": 0,\n \"count\": 2\n}\n\nПример ответа:
\n{\n \"max\": 202,\n \"list\": [\n {\n \"id\": \"da8e065e-27b8-4007-a231-4ffcb0c20e98\",\n \"name\": \"IVECO 606 TВA 03\",\n \"custom_fields\": [\n {\n \"key\": \"tripdetector_minmovespeed\",\n \"value\": \"3\",\n \"group\": \"cf_trips\"\n }\n ]\n },\n {\n \"id\": \"504f7e4e-d938-4016-99f5-4e8294efa9f0\",\n \"name\": \"Кран Урал 676 STA 033\",\n \"custom_fields\": [\n {\n \"key\": \"tripdetector_minmovespeed\",\n \"value\": \"5\",\n \"group\": \"cf_trips\"\n }\n ]\n }\n ]\n}\n\nПример получения списка терминалов в отсортированном порядке по названию компании в обратном порядке:
\n{\n \"model\": \"terminals\",\n \"sortField\": \"company_name\",\n \"sortDesc\": true,\n \"from\": 0,\n \"count\": 100\n}\n\nПолучения сущностей по всем компаниям для users и companies
\nРоль: Администратор и выше.
\nПримеры запросов:
\n{\n \"model\": \"units\",\n \"value\": \"тест\", /для поиска\n \"from\": 0,\n \"count\": 100\n}\n\nВозможные значения model - \"users\", \"companies\"
\nЧтобы фильтровать по интегратору надо отправить в запросе поле dealer. Достаточно указать id.
\n\"dealer\": {\"id\": \"8a7d85f9-156e-41ab-9534-da71d1847cba\"}
\nПример ответа:
\n {\n{\n \"max\": 531,\n \"list\": [\n {\n \"id\": \"2a004e29-0ca2-4f28-8a23-2ffb5392fd43\",\n \"name\": \"Company\",\n \"timezone_key\": \"UTC+3\"\n },\n {\n \"id\": \"06187e4b-3059-4da1-aa2f-89da732d2b2f\",\n \"name\": \"Company\",\n \"timezone_key\": \"UTC+3\"\n },\n...\n\nДобавление вложения, которое можно будет использовать в теге attachments для таблиц шаблонов
\nсм. POST /report_templates и PUT /report_templates/:template_id
\nСохраняет файлы на диске, присваивая ему id.
Файлы сохраняются с именами:
\"/attachments/\" + attachment.id + \".\" + extension
Роль: Редактор и выше.
\nОтвет:
Возвращается модель вложения
{\n \"id\": \"80a201ea-67e5-4cd9-aea5-591128d2855a\", //его id\n \"created\": \"2017-11-16 23:41:44\", //дата создания\n \"name\": \"test.doc\", //переданное название файла\n \"url\": \"/attachments/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\" //путь, по которому доступен файл\n}\n\nДля получения вложения нужно использовать запрос GET /attachments/80a201ea-67e5-4cd9-aea5-591128d2855a.doc
\n","urlObject":{"path":["api_v1","attachments"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0ced5347-cf86-4aaf-8961-e81448fa22cf"},{"name":"/attachments/:id","id":"ec67af4f-25a0-413c-b20a-4d7a12c8c24b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/attachments/:id","description":"Получение вложения
\nПосле создания вложения через метод POST /attachments возвращается json c url - его нужно использовать для получения файла
\n","urlObject":{"path":["api_v1","attachments",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"ec67af4f-25a0-413c-b20a-4d7a12c8c24b"},{"name":"/cancel_delete/:id","id":"3d40450a-744e-444e-aa66-8fa4cf9f5b00","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/cancel_delete/:id","description":"Отмена запроса удаления по уникальному ID
\nЭтот ID приходит в теле ответа на запрос удаления. см. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\nПример запроса:
PUT /cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc
Возвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.
\n","urlObject":{"path":["api_v1","cancel_delete",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"3d40450a-744e-444e-aa66-8fa4cf9f5b00"},{"name":"/auth_cancel_delete/:id","id":"556ddc7b-e386-499c-995c-4a3ecb26b6d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/auth_cancel_delete/:id","description":"Отмена запроса на удаление по уникальному ID
\nЭтот ID приходит в теле ответа на запрос удаления. см. DELETE /company/users?ids=:ids
\nРоль: Администратор и выше.
\nПример запроса:
PUT /auth_cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc
Возвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.
\n","urlObject":{"path":["api_v1","auth_cancel_delete",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"556ddc7b-e386-499c-995c-4a3ecb26b6d9"},{"name":"/mtracker_cancel_delete/:id","id":"b857e93c-7a24-4a1a-a141-da29abb80d83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/mtracker_cancel_delete/:id","description":"Отмена запроса на удаление по уникальному ID.
\nУникальный ID приходит в теле ответа на запрос уделения.
\nсм. DELETE /terminals?ids=:ids или DELETE /retranslators?ids=:ids
\nРоль: Супервизор и выше.
\nПример запроса:
PUT /mtracker_cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc
Возвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.
\n","urlObject":{"path":["api_v1","mtracker_cancel_delete",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b857e93c-7a24-4a1a-a141-da29abb80d83"},{"name":"/support","id":"081a974e-bad4-4584-a2ce-631a937f56c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"subject\": \"Привет\",\n \"body\": \"Как дела? Как создать объект?\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/support","description":"Отправка письма в поддержку интегратора
\nТело запроса:
\n{\n \"subject\": \"тема письма\", \n \"body\": \"текст сообщения\"\n}\n\nСообщение отправляется всем сотрудникам интегратора с ролью \"Редактор тарифа\".
Отправка доступна всем пользователям Компании.
Удаление пользователя из компании
\nПараметры:
\nid - ID пользователя
\nВ админ панеле можно удалить из определенных компаний с укзанием списка компаний в поле companies
\nРоль: Администратор и выше.
\nПример запроса:
\n{\n \"companies\": [\n {\n \"id\": \"545c61a4-27ae-4335-a18e-e63e98b3eceb\"\n },\n {\n \"id\": \"6b596675-81ba-4916-ac2d-32388da57e6d\"\n },\n {\n \"id\": \"6c08dd40-950a-4d7e-86ee-aa8f12435ed7\"\n }\n ]\n}\n\nОтвет: Пусто 200
Если пользователь с таким id не найден, то возвращается ошибка 400
{\n \"id\": [\n \"Недопустимый параметр\"\n ]\n}\n\nID пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b81c7cad-55ca-45da-83d7-3aefe62411e7"},{"name":"/company/users?ids=:ids","id":"0fe0d9a0-ad9b-4212-9c36-111dea4c86f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"","value":"","description":"Список ID пользователей
\n","type":"text"}],"url":"{{base_url}}/api_v1/company/users?ids=","description":"Планирует удаление пользователя с доступом к текущей компании по их id.
\nЕсли пользователь удаляется из последней компании, то создается новая компания, где у него роль Admin.
\nРоль: Администратор и выше.
\nПример запроса:
DELETE /company/users?ids=456dc493-5983-478b-90cc-5bca0bfe708c,05f6bb8b-84cf-4553-951a-c5cca0be7220
Параметры:
\nids - список Id пользователей
\nПользователь должен обладать правами Admin, иначе возвращается ошибка 403.
\nОтвет:
\nСтатус 200. В теле ответа id задачи на удаление, с помощью которого можно отменить удаление через роут PUT auth_cancel_delete/:id
Если хотя бы один пользователь с таким id не найден, то возвращается ошибка 400
{\n \"id\": [\n \"Недопустимый параметр\"\n ]\n}\n\nВыбор компании пользователем
\nВ cookies пользователя прописывается новая сессия
\nПример запроса:
\nВ качестве id может использоваться только id доступной пользователю компании из списка companies в сущности user, см GET /me
\nПараметры:
\nid - id доступной компании пользователя.
\nОтвет:
\nВозвращает код 200:
\n{\n \"id\": \"75bd17cc-642f-4c7c-982e-e0e991907733\"\n}\n\nВозвращает код 422 в случае если id не валидно:
\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Вы не имеете доступа к выбранной компании, попробуйте перезайти.\"\n}\n\nID доступной компании пользователя
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"6553fe00-f11f-4036-aef7-e75500cffebf"},{"name":"/company/change/:id","id":"f101eb04-49a1-4ec2-ab02-f723d4249e29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/company/change/:id","description":"Переключение в компанию по ссылке
\nВ cookies пользователя сохраняется сессия компании, переданная через параметр :id, после чего происходит перенаправление на главную страницу приложения.
ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f101eb04-49a1-4ec2-ab02-f723d4249e29"},{"name":"/company/:id","id":"b55ceb6f-785f-4add-81c5-083dd369e014","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"name\": \"Одуванчик \",\n \"auto_kill_sessions\": 0,\n \"strong_password\": false,\n \"efis_retranslate\": true,\n \"dealer\": {\n \"id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"is_default\": false,\n \"type\": {\n \"key\": \"legal_entity\",\n \"type\": \"dealer_types\",\n \"value\": \"Юридическое лицо\"\n },\n \"inn\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"contact_person\": \"\",\n \"name\": \"Мониторинг Плюс Москва\",\n \"_default\": false,\n \"_delete\": false\n },\n \"timezone\": {\n \"key\": \"UTC+3\",\n \"type\": \"timezones\",\n \"value\": \"(GMT+03:00) Москва, Санкт-Петербург, Волгоград\"\n },\n \"dateformat\": {\n \"key\": \"d/MM/yy\",\n \"type\": \"dateformats\",\n \"value\": \"d/MM/yy(25/01/14, 2/12/87)\"\n },\n \"timeformat\": {\n \"key\": \"HH:mm\",\n \"type\": \"timeformats\",\n \"value\": \"HH:mm(09:45, 17:20)\"\n },\n \"holidays\": [],\n \"forbidden_layers\": [{\"key\": \"pressure_new\"}]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/:id","description":"Изменение параметров компании
\nИзменяет атрибуты компании. Доступно только для пользователей, у которых доступ к компании на уровне Admin.
\nРоль: Администратор и выше.
\nПример запроса:
\nВ качестве id может использоваться только id доступной пользователю компании из списка companies в сущности user, см GET /me
\n{\n 'name': 'newCompanyName', \n 'auto_kill_sessions': 20,\n 'strong_password': true\n 'timezone': { 'key': 'UTC+4' },\n 'holidays': [\n {'year': 2020, 'days': ['01.01', '01.02', '03.08', '04.13', '04.14']}, \n {'year': 2021, 'days': ['01.01', '01.02', '03.08', '04.15', '04.16']}\n ],\n \"properties\": { // настройки для компании\n \"action_templates\": [// шаблоны actions\n {\n \"name\": \"Шаблон1\", // имя шаблона\n \"is_unit_action\": false,// true если относится к объектам.\n \"actions\": [// список actions, см. GET /actions\n {\"id\": \"e80c59b0-2c80-4bea-969c-498db4b0d446\"},\n {\"id\": \"62e20acf-cab3-4e8d-9e1f-e8774cf10764\"}\n ]\n },\n {\n \"name\": \"Шаблон2\", // имя шаблона\n \"is_unit_action\": true,// true если относится к объектам.\n \"actions\": [// список actions, см. GET /actions\n {\"id\": \"7d0ca86a-66e2-473b-8f4c-a61cc3e40649\"},\n {\"id\": \"9259c55d-7e1c-45a2-ab3e-c98aef52a1f5\"}\n ]\n }\n ]\n }\n}\n\nПараметры:
\nid - id доступной компании пользователя\nname - имя компании \nauto_kill_sessions - минуты, срок жизни сессии, \nstrong_password - true, если компания использует сложный пароль, иначе false\ninteger, если 0 то сессии живут бесконечно для пользователей компании\ntimezone - часовой пояс компании\ndateformat - формат даты для компании, выбирается из результата запроса /properties/dateformats\ntimeformat - формат времени для компании, выбирается из результата запроса /properties/timeformats\nholidays - нерабочие дни для компания\n year - год, int от 2000 до 3000\n days - массив нерабочих дней, в формате MM.dd \nforbidden_layers - Список запрещенных слоев, ключи получаются из справочника /properties с типом layers_type\nlogo - логотипе на экране мониторинга, на месте надписи Skif.Pro. Сначала нужно загрузить фото запросом: \n `POST /api_v1/upload_photos/logos` , в form-data указать файл в поле file<br>\n logo для компании выбрать из поля small.url\n \n\nОтвет:
\nВозвращает код 200 с body:
\n{\n \"id\": \"75bd17cc-642f-4c7c-982e-e0e991907733\",\n \"name\": \"Моя компания\",\n \"auto_kill_sessions\": 20,\n \"strong_password\": true,\n \"timezone\": {\"key\": \"UTC+3\"} // часовой пояс компании\n \"dateformat\": {\"key\": \"yyyy-MM-dd\"}, // формат даты компании,\n \"timeformat\": {\"key\": \"HH:mm:ss\"}, // формат времени компании,\n \"holidays\": [\n {\"year\": 2020, \"days\": [\"01.01\", \"01.02\", \"03.08\", \"04.13\", \"04.14\"]}, \n {\"year\": 2021, \"days\": [\"01.01\", \"01.02\", \"03.08\", \"04.15\", \"04.16\"]}\n ],\n \"forbidden_layers\": [\n {\n \"key\": \"pressure_new\",\n \"type\": \"layers_type\",\n \"value\": \"Давление\"\n }\n ],\n \"action_templates\": [\n {\n \"name\": \"Шаблон1\", \n \"is_unit_action\": false, относиться к объектам.\n \"actions\": [\n {\"id\": \"e80c59b0-2c80-4bea-969c-498db4b0d446\"},\n {\"id\": \"62e20acf-cab3-4e8d-9e1f-e8774cf10764\"}\n ]\n },\n {\n \"name\": \"Шаблон2\",\n \"is_unit_action\": true,\n \"actions\": [\n {\"id\": \"7d0ca86a-66e2-473b-8f4c-a61cc3e40649\"},\n {\"id\": \"9259c55d-7e1c-45a2-ab3e-c98aef52a1f5\"}\n ]\n }\n ]\n}\n\nВозвращает код 422 в случае если id не валидно, body :
\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Вы не имеете доступа к выбранной компании, попробуйте перезайти.\"\n}\n\nID доступной пользователю компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b55ceb6f-785f-4add-81c5-083dd369e014"},{"name":"/company/invite","id":"b31981b8-508d-4561-b7e1-af90dd740d21","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"mshevelevich@gmail2.com\",\n \"role\": {\"id\": \"fffaa80b-28a5-466b-a0a2-29761bfc8c80\"}\n}"},"url":"{{base_url}}/api_v1/company/invite","description":"Приглашение пользователя в систему
\nМетод создает ссылку и отправляет ее на указанный email. По ссылке можно авторизоваться.
\nРоль: Администратор и выше.
\nПараметры:
\nemail - email того, кого приглашаем\n{\n \"email\": \"test@gmail.com\", \n \"role\": {\"key\": \"Admin\", \"id\": \"fffaa80b-28a5-466b-a0a2-29761bfc8c80\"}, // Роль выбирается из списка ролей; достаточно указать только идентификатор. Получить все роли GET /roles,\n \"companies\": [ //Можно указать ID конкретных компаний, это поле используется в админке\n {\"id\": \"545c61a4-27ae-4335-a18e-e63e98b3eceb\"},\n {\"id\": \"6b596675-81ba-4916-ac2d-32388da57e6d\"},\n {\"id\": \"6c08dd40-950a-4d7e-86ee-aa8f12435ed7\"}\n ]\n}\n\nПараметры ответа:
\nКод 200. Даже если пользователь с указанным паролем не существует. Ответ всегда такого вида
\n{\"code\":200,\"message\":\"На указанный email была выслана ссылка для восстановления.\"}\n\nСоздание пользователем новой компании
\nПараметры:
\n\"company_name\": текст, название компании, обязательное\n\"timezone\": часовой пояс компании, обязательное\n\"dateformat\": формат даты компании. Не обязательное. Если не указано, то установится дефолтный формат \n\"timeformat\": формат время компании. Не обязательное. Если не указано. то установится дефолтный формат \nlogo - логотипе на экране мониторинга, на месте надписи Skif.Pro. Сначала нужно загрузить фото запросом: \n `POST /api_v1/upload_photos/logos` , в form-data указать файл в поле file\n logo для компании выбрать из поля small.url\n\n\nПри создании вместе с первым пользователем требуются дополнительные поля:
\n\"userProviderId\": \"test@mail.ru\", // email пользователя
\"type\": \"EMAIL\",
\"password\": \"11111\", // пароль
\"name\": \"Имя пользователя\",
Если в запросе присутствует поле userProviderId, это означает, что компания создаётся вместе с пользователем.
Роль: Супервизор и выше.
\nПример запроса:
\n{\n \"company_name\": \"A company X\",\n \"timezone\": {\"key\": \"UTC+3\"},\n \"imeis\": [\"3424324324\", \"657657657\"]\n}\n\nОтвет:
\n{\n \"id\": \"8c78a9d2-0c10-48c2-9d25-746f243b39a8\",\n \"name\": \"A company X\",\n \"strong_password\": false,\n \"efis_retranslate\": false,\n \"integrator\": {\n \"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\",\n \"is_default\": false,\n \"name\": \"Интегратор\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"contact_person\": \"\",\n \"regions\": [\n \"Казахстан\"\n ],\n \"_default\": false,\n \"_delete\": false\n },\n \"timezone\": {\n \"key\": \"UTC+3\",\n \"type\": \"timezones\",\n \"value\": \"(GMT + 03: 00) Moscow, St. Petersburg, Volgograd\"\n },\n \"dateformat\": {\n \"key\": \"dd-MM-yyyy\",\n \"type\": \"dateformats\",\n \"value\": \"dd-MM-yyyy(25-01-2014, 02-12-1987)\"\n },\n \"timeformat\": {\n \"key\": \"HH:mm:ss\",\n \"type\": \"timeformats\",\n \"value\": \"HH:mm:ss(09:45:33, 17:20:00)\"\n },\n \"holidays\": []\n}\n\nПолучение сессий пользователей компании
\nРоль: Администратор и выше.
\nЗапрос данных ограничен периодом в один месяц.
\n{\n \"from\":\"2024-10-01 00:00:00\",\n \"from\":\"2024-11-01 00:00:00\", // необязательный параметр\n \"first\":0, // необязательный параметр\n \"count\":100 // необязательный параметр\n}\n\nПолучение сессий пользователей компании из админ панели
\nРоль: Супервизор и выше.
\nПараметры запроса:
\nid - ID компании
\n{\n \"from\":\"2020-10-01 00:00:00\",\n \"first\":0,\n \"count\":100\n}\n\nЗапрос данных ограничен периодом в один месяц
\n","urlObject":{"path":["api_v1","company",":id","sessions","query"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"0562ec97-8db5-4b03-917f-4527104e7bba"},{"name":"/company/updates/query","id":"c10ba642-0ad3-4299-8a6e-d6a52dd38925","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": \"2021-01-05 00:00:00\",\n \"to\": \"2021-12-12 23:59:59\",\n \"objects\": \"units\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"user.name\",\n \"sortDesc\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/updates/query","description":"Получение истории изменения сущностей
\nРоль: Администратор и выше.
\nПример запроса для одной сущности:
\n{\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-10-01 00:00:00\",\n \"object_id\": \"b56f98e9-7c8e-4cda-a642-6d4e207de5d4\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true\n}\n\nПример запроса для всего справочника units:
\n{\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-10-01 00:00:00\",\n \"objects\": \"units\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true,\n \"value\": \"user1\"\n}\n\nЗапрос данных ограничен периодом в один год
\nВозможные параметры:
\nmax_rows - максимальное количестов строк.
\nfrom - дата-время от какой выдавать данные, необязательный параметр. По умолчанию - текущее время минус 7 дней.
\nto - дата-время до какой выдавать данные, необязательный параметр. По умолчанию - текущее время.
\nfirst_row - первая строка, необязательный параметр. По умолчанию 0.
\nmax_rows - максимальное количество строк в выдаче, необязательный параметр. По умолчанию 10000.
\nobject_id - если нужно запросить изменение по конкретной сущности, используйте id нужной сущности, необязательный параметр.
\nobjects - по каким типам сущностей возвращать историю - users, units, company, unitsgroup, units_trailers, geozones, report_templates, notifications, routes, trips, trailers, mailings.
\nsortField - имя поля для сортировки результатов, возможные значения: created, user.name, operation.
\nsortDesc - true, если надо соортировать по убыванию.
\nvalue - искомый текст.
\nПример ответа:
\n{\n \"list\": [{\n \"created\": \"2020-11-11 15:55:33\",\n \"user\": {\n \"id\": \"5551b5bd-b4d7-4f99-a166-c9ecdabccee0\",\n \"name\": \"user1\",\n \"email\": \"user1@mail.ru\"\n },\n \"objects\": \"company\",\n \"operation\": \"PUT\",\n \"object_id\": \"11e541f5-3b57-4968-a428-eb13dde6ede0\",\n \"msg\": \"Пользователь user1 обновил настройки компании\"\n }],\n \"max_rows\": 1\n}\n\ncreated - дата время
\nobjects - тип сущностей
\nuser - автор изменений
\noperation - операция PUT, DELETE, POST - изменение, удаление, создание
\nobject_id - id объекта
\nmsg - текст
\n","urlObject":{"path":["api_v1","company","updates","query"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c10ba642-0ad3-4299-8a6e-d6a52dd38925"},{"name":"/company/:id/updates/query","id":"436cdbf0-0e3d-4e94-9dff-3ce7583770a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": \"2021-01-05 00:00:00\",\n \"to\": \"2021-12-12 23:59:59\",\n \"objects\": \"units\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"user.name\",\n \"sortDesc\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/company/:id/updates/query","description":"Получение истории изменения сущностей из админ панели
\nРоль: Супервизор и выше.
\nПример запроса для одной сущности:
\n{\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-10-01 00:00:00\",\n \"object_id\": \"b56f98e9-7c8e-4cda-a642-6d4e207de5d4\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true\n}\n\nПример запроса для всего справочника units:
\n{\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-10-01 00:00:00\",\n \"objects\": \"units\",\n \"first_row\": 0,\n \"max_rows\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true,\n \"value\": \"user1\"\n}\n\nЗапрос данных ограничен периодом в один год
\nВозможные параметры:
\nmax_rows - максимальное количество строк.
\nfrom - дата-время от какой выдавать данные, необязательный параметр. По умолчанию - текущее время минус 7 дней.
\nto - дата-время до какой выдавать данные, необязательный параметр. По умолчанию - текущее время.
\nfirst_row - первая строка, необязательный параметр. По умолчанию 0.
\nmax_rows - максимальное количество строк в выдаче, необязательный параметр. По умолчанию 10000.
\nobject_id - если нужно запросить изменение по конкретной сущности, используйте id нужной сущности, необязательный параметр.
\nobjects - по каким типам сущностей возвращать историю - users, units, company, unitsgroup, units_trailers, geozones, report_templates, notifications, routes, trips, trailers, mailings.
\nsortField - имя поля для сортировки результатов, возможные значения: created, user.name, operation.
\nsortDesc - true, если надо соортировать по убыванию.
\nvalue - искомый текст.
\nПример ответа:
\n{\n \"list\": [{\n \"created\": \"2020-11-11 15:55:33\",\n \"user\": {\n \"id\": \"5551b5bd-b4d7-4f99-a166-c9ecdabccee0\",\n \"name\": \"user1\",\n \"email\": \"user1@mail.ru\"\n },\n \"objects\": \"company\",\n \"operation\": \"PUT\",\n \"object_id\": \"11e541f5-3b57-4968-a428-eb13dde6ede0\",\n \"msg\": \"Пользователь user1 обновил настройки компании\"\n }],\n \"max_rows\": 1\n}\n\ncreated - дата время
\nobjects - тип сущностей
\nuser - автор изменений
\noperation - операция PUT, DELETE, POST - изменение, удаление, создание
\nobject_id - id объекта
\nmsg - текст
\n","urlObject":{"path":["company",":id","updates","query"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"436cdbf0-0e3d-4e94-9dff-3ce7583770a2"},{"name":"/company/schedule_delete","id":"ce64a80c-dd4b-4d90-83e6-e85117358065","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"ids\": [\n \"04350fc5-8cec-4edc-bed1-7e1ee9a9e630\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/schedule_delete","description":"Удаление компании
\nПараметры:
\nids - ID удалаемых компаний.
\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n \"ids\": [\"acce8268-e0ef-4fda-a6ea-89ed23ffae50\"]\n}\n\nПока можно удалить только одну компанию в одном запросе.
\nЕсли все ok, тогда запланируетсяудаление. Его можно отменить с помощью роут POST /company/cancel_delete
\n","urlObject":{"path":["api_v1","company","schedule_delete"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ce64a80c-dd4b-4d90-83e6-e85117358065"},{"name":"/company/cancel_delete","id":"402d8a8f-e880-4adb-b535-b94812daf625","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"ids\": [\n \"04350fc5-8cec-4edc-bed1-7e1ee9a9e630\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/cancel_delete","description":"Отмена удаления компании
\nПараметры:
\nids - ID удаляемых компаний.
\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n \"ids\": [\"acce8268-e0ef-4fda-a6ea-89ed23ffae50\"]\n}\n\nЕсли все ok, тогда удаление отменяется.
\n","urlObject":{"path":["api_v1","company","cancel_delete"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"402d8a8f-e880-4adb-b535-b94812daf625"},{"name":"/company/:id/roles","id":"73228b2a-2201-40fa-a912-24d691d9ee70","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/company/:id/roles","description":"Получение доступных ролей для компании
\nid - ID компании
\nВозвращается массив ролей
\nРоль: Администратор и выше.
\nПример запроса:
\nGET https://dev5.skif.pro/api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/roles
\nПример ответа:
\n[\n {\n \"key\": \"NO_ACCESS\",\n \"value\": \"Без доступа\"\n },\n {\n \"key\": \"OBSERVER\",\n \"value\": \"Наблюдатель\"\n },\n {\n \"key\": \"READER\",\n \"value\": \"Читатель\"\n },\n {\n \"key\": \"OPERATOR\",\n \"value\": \"Оператор\"\n },\n {\n \"key\": \"EDITOR\",\n \"value\": \"Редактор\"\n },\n {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n },\n {\n \"key\": \"SUPERVISOR\",\n \"value\": \"Супервизор\"\n },\n {\n \"key\": \"TARIFF_EDITOR\",\n \"value\": \"Редактор тарифа\"\n },\n {\n \"key\": \"CONTROLLER\",\n \"value\": \"Контроллер\"\n }\n]\n\nID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"73228b2a-2201-40fa-a912-24d691d9ee70"},{"name":"/company/:id/addable_users?search=:search","id":"16159da0-fcbf-40e9-9998-f74c972eacb8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/company/:id/addable_users?search=&offset=&count=","description":"Получение списка пользователей, доступных для добавления в компанию
\nПараметры:
\nid - ID компании.
\nsearch - текст для поиска.
\noffset - индекс первого элемента в странице.
\ncount - количество в странице.
\nВозвращается массив пользователей с полями id, name и email.
\nРоль: Администратор и выше.
\nПример запроса:
\nGET /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/addable_users?search=test1
\nПример ответа:
\nmax - общее количество
\nlist - список пользователей
\n{\n \"max\": 4,\n \"list\": [\n {\n \"id\": \"5e139290-cfbc-4770-b42a-fdf12d898684\",\n \"name\": \"123123\",\n \"email\": \"test16@test.kmm\"\n },\n {\n \"id\": \"0010b3d2-dc83-4ea3-a3ab-2cf04a79ceeb\",\n \"name\": \"test1@test.rm\",\n \"email\": \"test1@test.rm\"\n }\n ]\n}\n\nтекст для поиска
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"индекс первого элемента в странице
\n","type":"text/plain"},"key":"offset","value":""},{"description":{"content":"количество в странице
\n","type":"text/plain"},"key":"count","value":""}],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"16159da0-fcbf-40e9-9998-f74c972eacb8"},{"name":"/company/:id/add_users","id":"31ad718e-7bd2-48f0-8900-2ce134955510","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"users\": [\n {\n \"id\": \"8d33f780-3923-463f-ab5c-500edca4219a\"\n },\n {\n \"id\": \"edbb2a66-4847-4a80-a3c4-f76907ac31d5\"\n }\n ],\n \"role\": {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/:id/add_users","description":"Добавление существующих доступных пользователей в компанию
\nid - ID компании
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/add_users
\nПример тела запроса:
\n{\n \"users\": [\n {\n \"id\": \"8d33f780-3923-463f-ab5c-500edca4219a\"\n },\n {\n \"id\": \"edbb2a66-4847-4a80-a3c4-f76907ac31d5\"\n }\n ],\n \"role\": {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n}\n\nВозврвщается ответ со статусом 200 или ошибка
\n","urlObject":{"path":["api_v1","company",":id","add_users"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"31ad718e-7bd2-48f0-8900-2ce134955510"},{"name":"/company/:id/users?ids=","id":"3efcb31b-c26d-4589-8dc3-9fc50173452b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"users\": [\n {\n \"id\": \"8d33f780-3923-463f-ab5c-500edca4219a\"\n },\n {\n \"id\": \"edbb2a66-4847-4a80-a3c4-f76907ac31d5\"\n }\n ],\n \"role\": {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/:id/users?ids=","description":"Добавление существующих доступных пользователей в компанию
\nid - ID компании
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/add_users
\nПример тела запроса:
\n{\n \"users\": [\n {\n \"id\": \"8d33f780-3923-463f-ab5c-500edca4219a\"\n },\n {\n \"id\": \"edbb2a66-4847-4a80-a3c4-f76907ac31d5\"\n }\n ],\n \"role\": {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n}\n\nВозврвщается ответ со статусом 200 или ошибка
\n","urlObject":{"path":["api_v1","company",":id","users"],"host":["{{base_url}}"],"query":[{"description":{"content":"ID пользователя
\n","type":"text/plain"},"key":"ids","value":""}],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"3efcb31b-c26d-4589-8dc3-9fc50173452b"},{"name":"/company/:id/properties","id":"9919b7df-5755-42d7-a577-b4e3dc09c4fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/company/:id/properties","description":"Получение настройки для компании
\nGET /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties
\nРоль: Администратор и выше.
\nВозвращается ответ со статусом 200
\ntrack_gradation - цветовая градация трека\nstyles - массив стилей\nmax - максимальное значение скоорости\nhex_color - шестнадцатеричный Код Цвета\nmonitoring_sensors_settings - настройка датчики для мониторинга\nname - название, строка\nsensor_name_mask - маска датчика, строка\nicon - ключ для иконки, строка\ngradation - цветовая градация, такая же структура как в track_gradation\n\nПример ответа:
\n{\n \"track_gradation\": {\n \"styles\": [\n {\n \"max\": 40,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n },\n \"monitoring_sensors_settings\": [\n {\n \"name\": \" Уровень топлива\",\n \"sensor_name_mask\": \"*топлива*\",\n \"icon\": \"icon_fuel_level\",\n \"gradation\": {\n \"styles\": [\n {\n \"max\": 42,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n },\n {\n \"name\": \"Зажигания\",\n \"sensor_name_mask\": \"*зажиган*\",\n \"icon\": \"icon_ignition\",\n \"gradation\": {\n \"styles\": [\n {\n \"max\": 0,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n }\n ]\n}\n\nID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"9919b7df-5755-42d7-a577-b4e3dc09c4fa"},{"name":"/company/:id/properties","id":"70796955-5da2-486f-885c-923af560b9ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"track_gradation\": {\n \"styles\": [\n {\n \"max\": 41,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/:id/properties","description":"Обновление настроек компании
\nПараметр запроса:
\nid - ID компании
\nТело запроса JSON:
\ntrack_gradation - цветовая градация трека\nstyles - массив стилей\nmax - максимальное значение скоорости\nhex_color - шестнадцатеричный Код Цвета\nmonitoring_sensors_settings - настройка датчиков для мониторинга\nname - название, строка\nsensor_name_mask - маска датчика, строка\nicon - ключ для иконки, строка\ngradation - цветовая градация, такая же структура, как в track_gradation\n\nPUT /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties
\n{\n \"track_gradation\": {\n \"styles\": [\n {\n \"max\": 41,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n}\n\nВозвращается ответ со статусом 200 или ошибка
\ntrack_gradation - Цветовая градация трека\n styles - массив стилей\n max - максимальное значение скорости\n hex_color - Шестнадцатеричный Код Цвета\n\nРоль: Администратор и выше.
\nПример тела ответа:
\n{\n \"track_gradation\": {\n \"styles\": [\n {\n \"max\": 41,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n}\n\n2. Пример запроса на обновление настройки датчиков для мониторинга
\n{\n \"monitoring_sensors_settings\": [\n {\n \"name\": \" Уровень топлива\",\n \"sensor_name_mask\": \"*топлива*\",\n \"icon\": \"icon_fuel_level\",\n \"gradation\": {\n \"styles\": [\n {\n \"max\": 42,\n \"hex_color\": \"#51AAEB\"\n },\n {\n \"max\": 80,\n \"hex_color\": \"#623F73\"\n },\n {\n \"max\": 120,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n },\n {\n \"name\": \"Зажигания\",\n \"sensor_name_mask\": \"*зажиган*\",\n \"icon\": \"icon_ignition\",\n \"gradation\": {\n \"styles\": [\n {\n \"max\": 0,\n \"hex_color\": \"#E37A3A\"\n },\n {\n \"max\": null,\n \"hex_color\": \"#DD1E1E\"\n }\n ]\n }\n }\n ]\n}\n\nID компании
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"70796955-5da2-486f-885c-923af560b9ea"},{"name":"/company/:id/properties/copy","id":"051d51cb-43f3-44b2-95bf-0821110278c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"companies\": [\n {\"id\": \"42ee050a-f6f7-40c0-a8d8-1656e787dc0b\"},\n {\"id\": \"c968398b-be00-4b4a-9e2c-7d7bdc0d43ad\"}\n ],\n \"properties\": [\n \"available_maps\",\n \"monitoring_sensors_settings\",\n \"track_gradation\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/company/:id/properties/copy","description":"Обновление настроек компании
\nПараметр запроса:
\nid - ID компании, из которой необходимо скопировать свойства
\nТело запроса JSON:
\ncompanies - список компаний, на которые копируются свойств, см. пример
properties - список свойств, которые копируются
возможные значения:
available_maps - Доступные карты
track_gradation - Цвет трека
monitoring_sensors_settings - Цветные индикаторы датчиков в мониторинге
PUT /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties/copy
\n{\n \"companies\": [\n {\"id\": \"42ee050a-f6f7-40c0-a8d8-1656e787dc0b\"},\n {\"id\": \"c968398b-be00-4b4a-9e2c-7d7bdc0d43ad\"}\n ],\n \"properties\": [\n \"available_maps\",\n \"monitoring_sensors_settings\",\n \"track_gradation\"\n ]\n}\n\nВозвращается ответ со статусом 200 или ошибка
\nРоль: Администратор и выше.
\nМетоды связанные с компанией
\n","_postman_id":"a85d372f-64df-47ef-85a1-438990cff301"},{"name":"Ресурсы компаний","item":[{"name":"/map_layers","id":"1f97cf2e-945a-4337-8293-3fe70a0ba32d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/map_layers","description":"Возвращает список всех слоев, для текущей активной компании
\nПример ответа
\n[\n {\n \"id\": \"uuid\", // ID базового слоя\n \"company_layer_id\": \"uuid\", // ID привязки к компании\n \"name\": \"Название слоя\",\n \"url\": \"https://...\",\n \"type\": \"WMS\",\n \"is_active\": true, // Включен ли слой по умолчанию\n \"sort_order\": 0 // Порядок в списке слоев\n }\n]\n\nВозвращает список слоев карт для интегратора, к которым у пользователя есть доступ.
\nОтвет:
\n[\n {\n \"id\": \"uuid-слоя\",\n \"name\": \"Кадастр РФ\",\n \"url\": \"https://...\",\n \"type\": \"WMS\",\n \"usage_count\": 2,\n \"companies\": [\n {\n \"id\": \"uuid-компании-1\",\n \"name\": \"1111\"\n },\n {\n \"id\": \"uuid-компании-2\",\n \"name\": \"2222'\"\n }\n ]\n }\n]\n\nВключает стандартные поля слоя + usage_count (сколько компаний используют слой)
\n","urlObject":{"path":["api_v1","dealer","map_layers"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"815442de-09b1-4001-b055-5455dcdecf9b"},{"name":"/dealer/:id/map_layers","id":"44f10574-071a-4bf9-aeb5-2d83f9c5e51b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"Получение слоев по переданному ID интегратора
\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"44f10574-071a-4bf9-aeb5-2d83f9c5e51b"},{"name":"/map_layers","id":"d274b410-0ca1-44ab-a1d3-6e3fea4e2d33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/map_layers","description":"Универсальный метод, который выполняет сразу три функции:
\nСоздание нового слоя (если не передан id).
\nРедактирование параметров существующего слоя (если передан id).
\nУправление видимостью слоя: массовая привязка к компаниям и отвязка от них.
\nПри создании требуется, какому интегратору будет принадлежать слой.
\n{\n \"dealer_id\": \"3d1be96f-6e73-491c-8745-e89e8a46bf94\", \n \"name\": \"WMS\",\n \"url\": \"https://test.com/wms\",\n \"type\": \"WMS\",\n \"companyIdsToAdd\":[\n \"c5ca5827-8b23-4f78-9234-276a7a56fe73\",\n \"e62ae10f-b963-4ca1-87ad-519226231faa\"\n ]\n}\n\ndealer_id (обязательно): UUID интегратора, в список которого добавляется слой.
\ncompanyIdsToAdd (опционально): Массив UUID компаний, которым этот слой станет доступен сразу после
создания (по умолчанию он добавится к ним в выключенном состоянии — is_active: false)
При редактировании принадлежность к интегратору изменить нельзя.
\n{\n \"id\": \"15af5b55-f529-485a-9701-b7c9be48f102\",\n \"name\": \"Новое название карты\",\n \"url\": \"https://new-url.service.com/wms\",\n \"companyIdsToAdd\":[\n \"436aed8b-43c8-4a93-91be-a2cdf2d4d2c2\"\n ],\n \"companyIdsToRemove\":[\n \"c5ca5827-8b23-4f78-9234-276a7a56fe73\"\n ]\n}\n\nid (обязательно): UUID слоя, который нужно изменить. (Если передан, поле dealer_id игнорируется).
\ncompanyIdsToRemove (опционально): Массив UUID компаний, у которых этот слой нужно забрать.
\nВыполняет удаление слоя и все связи этого слоя с компаниями.
\n","urlObject":{"path":["api_v1","map_layers",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"id":"8acb02a6-0e1d-48c3-b17c-b2f5849e6436","type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f8c5e175-2bee-459f-bd47-77539746459f"},{"name":"/company/:id/map_layers","id":"ae8ac4a2-64fa-4c97-85b0-28348871fa5e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/company/:id/map_layers","description":"Возвращает список слоев, которые были привязаны к указанной компании, с учетом их статуса (активен/неактивен) и порядка сортировки.
\nПример ответа:
\n[\n {\n \"id\": \"uuid\", // ID основного слоя \n \"company_layer_id\": \"uuid\", // ID связи \n \"name\": \"Карта полей\",\n \"url\": \"https://...\",\n \"type\": \"WMS\",\n \"is_active\": true, // Включен ли слой у компании\n \"sort_order\": 0 // Порядок отображения\n }\n]\n\nСортировка: сначала активные (is_active), затем по sort_order.
\n","urlObject":{"path":["api_v1","company",":id","map_layers"],"host":["{{base_url}}"],"query":[],"variable":[{"id":"dde68382-2c8f-4c84-990b-00aab876da9d","type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"ae8ac4a2-64fa-4c97-85b0-28348871fa5e"},{"name":"/company/:id/map_layers","id":"467a3595-8945-4ff4-bebd-414a646d1509","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/company/:id/map_layers","description":"Позволяет изменить порядок отображения слоев и включить/выключить их для конкретной компании.
\nПример запроса:
\n[\n {\n \"id\": \"uuid\", // ID слоя\n \"is_active\": true // Статус активности\n },\n {\n \"id\": \"uuid\",\n \"is_active\": false\n }\n]\n\nВажно: Порядок объектов в массиве определяет sort_order
\n","urlObject":{"path":["api_v1","company",":id","map_layers"],"host":["{{base_url}}"],"query":[],"variable":[{"id":"c44deffb-901f-43fd-bff8-2463ab490f27","type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"467a3595-8945-4ff4-bebd-414a646d1509"}],"id":"515319d8-06d3-4f92-8d2d-c7245a68ddc3","_postman_id":"515319d8-06d3-4f92-8d2d-c7245a68ddc3","description":""},{"name":"Геозоны","item":[{"name":"Пользовательский тип геозоны","item":[{"name":"geozones/custom_types","id":"8f144503-307e-4ee0-9df2-717df7c04f60","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"test\",\n \"photo\": {\n \"small\":\n {\n \"url\": \"/photos/geozones/0559a281-5f03-4f36-8871-2a18daa16f56_300.jpeg\",\n \"width\": 300,\n \"height\": 200,\n \"param_type\": \"geozones\"\n },\n \"original\": {\n \"url\": \"/photos/geozones/0559a281-5f03-4f36-8871-2a18daa16f56_original.jpeg\",\n \"width\": 5184,\n \"height\": 3456,\n \"param_type\": \"geozones\"\n }\n },\n \"company_id\": \"11111111-1111-1111-1111-111111111111\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/geozones/custom_types","urlObject":{"path":["api_v1","geozones","custom_types"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8f144503-307e-4ee0-9df2-717df7c04f60"}],"id":"90baebb3-bf08-4e94-aec4-e9491db5654f","_postman_id":"90baebb3-bf08-4e94-aec4-e9491db5654f","description":""},{"name":"/geozones","id":"0fa1011a-e581-4ebc-aaa5-da69c4236a43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"companies\": [\n {\n \"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"\n },\n {\n \"id\": \"42ee050a-f6f7-40c0-a8d8-1656e787dc0b\"\n }\n ],\n \"name\": \"POI_Z\",\n \"type\": {\n \"key\": \"circle\"\n },\n \"icon\": {\n \"key\": \"hospital\"\n },\n \"geometry\": [\n [\n 33.1,\n 55.2\n ]\n ],\n \"color\": {\n \"key\": \"#E68A2F\"\n },\n \"width\": 20777\n}"},"url":"{{base_url}}/api_v1/geozones","description":"Создание геозоны
\nДобавляет новую геозону, присваивая id.
\nРоль: Редактор и выше.
\nПараметры:
\n{\n \"companies\": [{\"id\": \"e94111ca-b6a7-4b7e-a844-fcbc9043ac8f\"}] //список компаний\n \"name\": \"POI\", //название\n \"type\": {\"key\": \"point\"}, // тип геозоны, key = [point, circle, line, polygon] (можно добавлять \"type\":\"geozone_type\").\n \"icon\": {\"key\": \"hospital\"}, // тип иконки, key = [hospital, school] (можно добавлять \"type\":\"geo_icon\").\n \"geometry\": [ //геометрия - всегда массив координат\n [\n 33.1,\n 55.2\n ]\n ],\n \"is_show_on_map\": true,\n \"color\": {\"key\": \"#E6EAEE\"}, //цвет, key = ['#F56C6C', '#E6EAEE', '#E68A2F', '#1585D8', '#1BB934'], (можно добавлять \"type\": \"color_code\").\n \"width\": 1777, //ширина\n \"area\": 2032932.5 // площадь в m2,\n \"perimeter\": 2234.3 // периметр в m,\n \"polygon_geometry\": [[55, 33], [56, 32]] //координаты после преобразование в полигон(только для линии)\n}\n\nОтвет:
\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.
\n","urlObject":{"path":["api_v1","geozones"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0fa1011a-e581-4ebc-aaa5-da69c4236a43"},{"name":"/goezones?ids=Получение геозон
\nВозвращает массив всех геозон.
\nОтвет:
\nЕсли запрашивается по одному id - вернется не массив, а один объект.
\nЕсли запрашивать по конкретному id - вернётся даже удаленная геозона.
\nЕсли запрос без id (просто GET /geozones), то удаленные геозоны не отобразятся.
\n\"{\n \"id\":\"a321b5f0-f52c-4d36-9d39-f11ba64f9293\",\n \"name\":\"POI\",\n \"type\":{\"key\":\"point\",\"type\":\"geozone_type\",\"value\":\"Точка\"},\n \"geometry\":[[33.1,55.2]],\n \"color\":{\"key\":\"#E68A2F\",\"type\":\"color_code\",\"value\":\"Оранжевый\"},\n \"width\":1777.0,\n \"icon\":{\"key\":\"hospital\",\"type\":\"geo_icon\",\"value\":\"Больница\"},\n \"is_show_on_map\": true,\n \"area\": 2032932.5,\n \"perimeter\": 2234.3\n}\"\n\nПолучение геозон для отображения на карте в виде geojson
\nВозвращает массив всех геозон, которые нужно отображать на карте.
\nОтвет:
\n{\n \"type\":\"FeatureCollection\",\n \"features\":[\n {\n \"type\":\"Feature\",\n \"id\":\"a9e42e60-bdce-48ed-946c-55d141ce58b4\",\n \"geometry\":{\n \"type\":\"Point\",\n \"coordinates\":[\n 55.0,\n 30.0\n ]\n },\n \"properties\":{\n \"address\":\"\",\n \"name\":\"POI-1\"\n }\n },\n {\n \"type\":\"Feature\",\n \"id\":\"83592eea-20ff-4db0-9ca7-1aa3450c6453\",\n \"geometry\":{\n \"type\":\"Point\",\n \"coordinates\":[\n 55.0,\n 55.0\n ]\n },\n \"properties\":{\n \"address\":\"\",\n \"name\":\"POI-2\"\n }\n },\n {\n \"type\":\"Feature\",\n \"id\":\"3def4148-335f-42d1-aca4-d55366f93ee8\",\n \"geometry\":{\n \"type\":\"Point\",\n \"coordinates\":[\n 55.0,\n 30.0\n ]\n },\n \"properties\":{\n \"address\":\"\",\n \"name\":\"POI-3\"\n }\n },\n {\n \"type\":\"Feature\",\n \"id\":\"4c061c44-2112-4494-a015-63d5bdb70194\",\n \"geometry\":{\n \"type\":\"Point\",\n \"coordinates\":[\n 30.0,\n 30.0\n ]\n },\n \"properties\":{\n \"address\":\"\",\n \"name\":\"POI-4\"\n }\n }\n ]\n}\n\nУдаление геозоны по ее id
\nПараметры:
\nid геозоны
\nРоль: Редактор и выше.
\nОтвет:
\n200 и удаленная геозона
\nЕсли геозона с таким id не найдена, то возвращается ошибка 400
\n{\n \"code\": 4000,\n \"field\": \"id\",\n \"message\": \"Недопустимый параметр\"\n}\n\nID геозоны
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"d4f54449-6034-4ebc-92d8-e50b99f91d8b"},{"name":"/geozones/:id/all","id":"59259921-007e-4753-98cc-b13361a66f2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/geozones/:id/all","description":"Удаление геозоны по ее id во всех компаниях в админке
\nПараметры:
\nid геозоны
\nОтвет:
\n200 и удаленная геозона.
\nЕсли геозона с таким id не найдена, то возвращается ошибка 400.
\n{\n\"code\": 4000,\n\"field\": \"id\",\n\"message\": \"Недопустимый параметр\"\n}\n\nID геозоны
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"59259921-007e-4753-98cc-b13361a66f2a"},{"name":"/geozones?ids=:ids","id":"66dfc056-cfa6-4816-b168-395b57d4a99d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/geozones?ids=","description":"Планирование удаления геозоны
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozones"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"66dfc056-cfa6-4816-b168-395b57d4a99d"},{"name":"/geozones","id":"dd473eb3-b72a-4efa-ace9-10e196d67699","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/geozones","description":"Планирование удаление геозоны
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozones"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"dd473eb3-b72a-4efa-ace9-10e196d67699"},{"name":"/geozones/:id","id":"0d113e0d-ac67-413b-af2a-6c052cdd97bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"31bb27f2-c937-4a91-8a95-e65515957411\",\n \"name\": \"POI\",\n \"type\": {\n \"key\": \"point\",\n \"type\": \"geozone_type\",\n \"value\": \"Точка 2\"\n },\n \"geometry\": [\n [\n 33.1,\n 55.2\n ]\n ],\n \"color\": {\n \"key\": \"#E68A2F\",\n \"type\": \"color_code\",\n \"value\": \"Оранжевый\"\n },\n \"width\": 1777,\n \"icon\": {\n \"key\": \"hospital\",\n \"type\": \"geo_icon\",\n \"value\": \"Больница\"\n }\n}"},"url":"{{base_url}}/api_v1/geozones/:id","description":"Обновление данных геозоны
\nОбновляет переданные параметры
\nПараметры:
\nСм метод POST /geozones
\nРоль: Редактор и выше.
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /geozeons
\n","urlObject":{"path":["api_v1","geozones",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID геозоны
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"0d113e0d-ac67-413b-af2a-6c052cdd97bd"},{"name":"/geozones/list","id":"d744c554-b769-4fd4-9014-7d2e78adfa0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\t\t\t\t\t\"from\":0,\n \"count\":1,\n \"sortField\":\"name\",\n \"sortDesc\":\"false\", \n \"conditions\":[ \n \t{ \"field\": \"type.key\", \"value\": \"point\"}\n ]\n}"},"url":"{{base_url}}/api_v1/geozones/list","description":"Получение геозоны по фильтру
\nАналогична запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[name, created, is_delete, icon.key, color.key, type.key]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - name (можно искать по неполному слову), icon.key, icon.type, color.key, color.type, type.key, type.type
Пример запроса:
\nПолучить первые 10 геозон, отсортированные по возрастанию по имени, которые имеют тип \"point\" и иконку \"school\"
\n{\n \"from\":0,\n \"count\":10,\n \"sortField\":\"name\",\n \"sortDesc\":\"false\", \"conditions\":[ \n { \"field\": \"type.key\", \"value\": \"point\"},\n { \"field\": \"icon.key\", \"value\": \"school\"}\n ]\n}\n\nОтвет:
\n{\n \"max\":1,\n \"list\":\n [\n {\"id\":\"80773471-1eb8-4b71-ad44-fcfd6d8c721a\",\n \"name\":\"aPOI-2\",\n \"type\":{\"key\":\"point\",\n \"type\":\"geozone_type\",\n \"value\":\"Точка\"},\n \"geometry\":[[55.3,33.2]],\n \"color\":{\"key\":\"#E6EAEE\",\n \"type\":\"color_code\",\n \"value\":\"translate.color_code.key.grey\"},\n \"width\":1900.0,\n \"area\": 2032932.5,\n \"perimeter\": 2234.3,\n \"icon\":{\"key\":\"hospital\",\n \"type\":\"geo_icon\",\n \"value\":\"Больница\"}\n },\n ]\n}\n\nГенерация координат для линии
\nПараметры:
\nwidth - ширина
\ngeometry - координаты линии
\nВ ответ возвращаются координаты полигона в поле polygon_geometry
\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"width\": 10,\n \"geometry\": [\n [\n 54.6977009532508,\n 37.35351562500001\n ],\n [\n 54.53663764197375,\n 37.40158081054688\n ],\n [\n 54.61405984802798,\n 37.69821166992188\n ],\n [\n 54.67780208930051,\n 37.54714965820313\n ],\n [\n 54.762105979366964,\n 37.62954711914063\n ],\n [\n 54.69372196444214,\n 37.69683837890626\n ]\n ]\n}\n\nОтвет:
\n{\n \"polygon_geometry\": [\n [\n 54.69771417625393,\n 37.35355993442366\n ],\n [\n 54.536726211105375,\n 37.401630671355655\n ],\n [\n 54.614075095960615,\n 37.698000235820835\n ],\n [\n 54.67778288639096,\n 37.54705432526793\n ],\n [\n 54.76218431453469,\n 37.62954698668847\n ],\n [\n 54.693760434922694,\n 37.69687747411603\n ],\n [\n 54.693683493961586,\n 37.696799283696485\n ],\n [\n 54.762027644199236,\n 37.6295472515928\n ],\n [\n 54.67782129221007,\n 37.547244991138335\n ],\n [\n 54.61404460009534,\n 37.69842310402293\n ],\n [\n 54.53654907284212,\n 37.40153094973811\n ],\n [\n 54.69768773024767,\n 37.35347131557636\n ]\n ]\n}\n\nВ теле запроса укажите требуемые геозоны в geozones. Если geozones не указаны, то запрос формируется для всех геозон компании. Для группы геозон geozones_groups
\nРоль: Читател и выше.
\nПример запроса:
\n{\n \"geozones\": [\n {\"id\": \"0ca9f774-69fb-4a56-99ae-177f766fc291\"},\n {\"id\": \"8b13e5d3-898a-4463-8f84-0046fc15f323\"},\n {\"id\": \"d507e1ee-3e73-4ee6-a74a-3d1f6b8cbe89\"}\n ]\n}\n\nДля группы геозон:
\n{\n \"geozones_groups\": [\n {\"id\": \"517fe368-e2fe-4a64-bd96-473f2a2d670f\"},\n {\"id\": \"3789ac40-a076-48c1-85c2-a2d2515e6578\"}\n ]\n}\n\nОтвет:
\nВ теле ответа возращается kml файл
\n","urlObject":{"path":["api_v1","geozones","export_kml"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6a103a07-ad95-4534-aee5-4fa1f1bb5ffc"}],"id":"3a0d43af-cc8f-4f39-98e8-83b68f7dbfca","description":"Работа с Гоезонами
\n","event":[{"listen":"prerequest","script":{"id":"bb530a53-b141-471c-9131-89dd2a1050c7","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fc2eb399-7e4d-4b2e-b4dd-1ff2a2f4f9b3","type":"text/javascript","exec":[""]}}],"_postman_id":"3a0d43af-cc8f-4f39-98e8-83b68f7dbfca"},{"name":"Группы геозон","item":[{"name":"/geozonesgroup","id":"ce10fbf8-83c7-4e7a-a372-212de1adbb63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"geozoneName\",\n \"geozones\" : [\n { \n \"id\" : \"geozoneId1\"\n },\n {\n \"id\" : \"geozoneId2\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/geozonesgroup","description":"Cоздание групп геозон
\nВ body необходимо указать id геозоны, которая будет в группе и ее имя.
\n{\n \"name\": \"geozoneName\",\n \"geozones\" : [\n { \n \"id\" : \"geozoneId1\"\n },\n {\n \"id\" : \"geozoneId2\"\n }\n ]\n}\n\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozonesgroup"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ce10fbf8-83c7-4e7a-a372-212de1adbb63"},{"name":"/geozonesgroup?ids=geozone_id","id":"8f333998-e52a-4339-b42b-eca7e07d708a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/geozonesgroup?ids=","description":"Получение группы геозон по id
\nВозвращает группу геозон
\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","geozonesgroup"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"8f333998-e52a-4339-b42b-eca7e07d708a"},{"name":"/geozonesgroup/list","id":"b097a730-0468-4e90-8861-9e2a11293d4a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"fields\" : [\n \"geozones.id\",\n \"geozones.name\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/geozonesgroup/list","description":"Получение списка групп геозон
\nПоля:
\nВ fields указать нужные поля.
\n{\"fields\":[\"geozones.id\", \"geozones.name\"]}\n\nОтвет:
\ngeozones.id - Id группы.
\ngeozones.name - имя группы.
\n","urlObject":{"path":["api_v1","geozonesgroup","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b097a730-0468-4e90-8861-9e2a11293d4a"},{"name":"/geozonesgroup","id":"3ad49ee7-f35c-4f27-80dc-03c74775e4c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"testGroupGezone\",\n \"geozones\": [\n {\n \"id\": \"286e35d1-0d2e-481a-89b7-91755aabef54\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/geozonesgroup/geozonesgroup_id","description":"Обновление группы геозон
\nЗапрос:
\nhttps://dev5.skif.pro/api_v1/geozonesgroup/geozonesgroup_id\n\n{\n \"name\": \"testGroupGezone\",\n \"geozones\": [\n {\n \"id\": \"286e35d1-0d2e-481a-89b7-91755aabef54\"\n }\n ]\n}\n\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozonesgroup","geozonesgroup_id"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3ad49ee7-f35c-4f27-80dc-03c74775e4c4"},{"name":"/geozonesgroup/:geozonegroup_id","id":"298aa66b-ab00-4cdd-91a0-90b2c7aacf6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/geozonesgroup/:geozonesgroup_id","description":"Удаление группы геозон
\nГруппа удаляется физически.
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozonesgroup",":geozonesgroup_id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"geozonesgroup_id"}]}},"response":[],"_postman_id":"298aa66b-ab00-4cdd-91a0-90b2c7aacf6a"},{"name":"/geozonesgroup?ids=geozonesgroup_id","id":"fb8feb54-ac60-4f34-b6a2-6fad8a57a225","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/geozonesgroup?ids=","description":"Планирование удаления группы геозон
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","geozonesgroup"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"fb8feb54-ac60-4f34-b6a2-6fad8a57a225"}],"id":"1a3263cd-2bea-4857-8c65-287e1ee40118","_postman_id":"1a3263cd-2bea-4857-8c65-287e1ee40118","description":""},{"name":"Маршруты","item":[{"name":"/routes","id":"a5e83fc8-4238-47e6-8bc5-e899a1e336d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"RouteName\",\n\t\"points\": [{\n\t\t\"name\": \"point1\",\n\t\t\"type\": {\n\t\t\t\"key\": \"polygon\"\n\t\t},\n\t\t\"width\": 20,\n\t\t\"coordinates\": [\n\t\t\t[37.608734, 55.793154],\n\t\t\t[37.541330, 55.772056],\n\t\t\t[37.598908, 55.808941]\n\t\t]\n\t}]\n}"},"url":"{{base_url}}/api_v1/routes","description":"Создание маршрута
\nДобавляет новый маршрут, присваивая id.
\nРоль: Редактор и выше.
\nПараметры:
\n{\n \"name\": \"route1\", // название маршрута\n \"points\":[\n {\n \"name\":\"point1\",// название точки\n \"type\": {\"key\":\"polygon\"}, // тип точки, key = [point, circle, line, polygon] (можно добавлять \"type\":\"geozone_type\")\n \"width\":20,//ширина\n \"geometry\": [ //массив координат\n [37.608734,55.793154],\n [37.541330,55.772056],\n [37.598908,55.808941]\n ]\n }\n ]\n}\n\nОтвет:
\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.
\n","urlObject":{"path":["api_v1","routes"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a5e83fc8-4238-47e6-8bc5-e899a1e336d6"},{"name":"/routes?ids=Получение маршрутов
\nВозвращает массив всех маршрутов.
\nРоль: Читатель и выше.
\nОтвет:
\nЕсли запрашивается по одному id - вернется не массив, а один объект.
\nЕсли запрос без id (просто GET /routes), то вернутся все маршруты.
\n/routes?ids=a321b5f0-f52c-4d36-9d39-f11ba64f9293\n\"{\n \"id\":\"9817341d-474d-4468-9113-922637113f66\",\n \"name\":\"route1\",\n \"company_id\": \"ea0a3a44-ca90-4491-bb20-2c7f508da1c7\",\n \"points\":[\n {\n \"name\": \"point1\",\n \"type\" : {\n \"key\": \"polygon\",\n \"value\": \"Полигон\"\n },\n \"width\": 10,\n \"geometry\": [\n [37.541330, 55.772056],\n [37.598908, 55.808941]\n ]\n },\n {\n \"name\": \"point2\",\n \"type\" : {\n \"key\": \"circle\",\n \"value\": \"Круг\"\n },\n \"width\": 100,\n \"geometry\": [\n [37.541330, 55.772056]\n ]\n }\n ]\n}\"\n\nУдаление маршрута по его id
\nУдаляет маршрут
\nПараметры:
\nid маршрута
\nРоль: Редактор и выше.
\nОтвет:
\n200 Удаленный маршрут
\nЕсли маршрут с таким id не найден, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID маршрута
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"d529b6d7-94d4-4d9c-a0a9-3396eb90969a"},{"name":"/routes?ids=:ids","id":"b636d113-2754-4ca1-bb71-abea7bcbce98","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/routes?ids=","description":"Планирование удаление маршрута
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","routes"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"b636d113-2754-4ca1-bb71-abea7bcbce98"},{"name":"/routes","id":"af508fef-3af2-4e77-855b-aefa4739fccd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/routes","description":"Планирование удаления маршрута
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","routes"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"af508fef-3af2-4e77-855b-aefa4739fccd"},{"name":"/routes/:id","id":"f3c88508-82ba-485d-b805-c10828fdbd19","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"0d2c5867-301f-468a-aa15-1095f95cc697\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"RouteName\",\n \"points\": [\n {\n \"name\": \"point1\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": null,\n \"value\": null\n },\n \"width\": 20.0,\n \"coordinates\": [\n [\n 37.608734,\n 55.793154\n ],\n [\n 37.54133,\n 55.772056\n ],\n [\n 37.598908,\n 55.808941\n ]\n ]\n }\n ]\n}"},"url":"{{base_url}}/api_v1/routes/:id","description":"Обновление данных маршрута
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /routes
\nРоль: Редактор и выше.
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /routes
\n","urlObject":{"path":["api_v1","routes",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID маршрута
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f3c88508-82ba-485d-b805-c10828fdbd19"},{"name":"/routes/list","id":"76ab3e84-931b-434b-997e-38ae53d03d3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\t\t\t\t\t\"from\":0,\n \"count\":1,\n \"sortField\":\"name\",\n \"sortDesc\":\"false\", \n \"conditions\":[ \n \t{ \"field\": \"name\", \"value\": \"RouteName\"}\n ]\n}"},"url":"{{base_url}}/api_v1/routes/list","description":"Получение маршрутов по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[name, created, is_delete, icon.key, color.key, type.key]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - name(можно искать по неполному слову), icon.key, icon.type, color.key, color.type, type.key, type.type
Роль: Читатель и выше.
\nПример запроса:
\nПолучить первые 10 маршрутов, отсортированные по возрастанию, по имени, которые имеют имя \"route2\"
\n{\n \"from\":0,\n \"count\":10,\n \"sortField\":\"name\",\n \"sortDesc\":\"false\", \"conditions\":[ \n { \"field\": \"name\", \"value\": \"route2\"}\n ]\n}\n\nОтвет:
\n{\n \"max\":1,\n \"list\":\n [\n {\"id\":\"80773471-1eb8-4b71-ad44-fcfd6d8c721a\",\n \"name\":\"route2\",\n \"points\":[\n { \"name\":\"point1\",\n \"type\": {\"key\":\"polygon\", \"value\":\"Полигон\"}\",\n \"width\":20,\n \"geometry\": [[37.608734,55.793154],[37.541330,55.772056],[37.598908,55.808941]]\n }\n ]\n ]\n}\n\nРабота с Маршрутами
\n","event":[{"listen":"prerequest","script":{"id":"cc3e12ae-bb05-41b8-8b85-be09e9eafe9f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"e272ac3b-6a8b-433a-a72a-780d3cd9fdbc","type":"text/javascript","exec":[""]}}],"_postman_id":"949c9c98-3c41-49db-9668-cc62737070f6"},{"name":"Рейсы","item":[{"name":"/trips","id":"423f18db-af2b-4979-8488-dfbcb6143d4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"6e8f4833-c430-4509-ac5e-e1802691655c","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"A trip with 3 points\",\n\t\"unit\": { \n\t\t\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n\t},\n\t\"trailer\": {\n\t\t\"id\": \"4e00d717-fa03-4209-8771-a6ff71a4f65d\"\n\t},\n\t\"user_id\": \"e8c262f8-942b-4c61-bb25-825d886e627a\",\n\t\"activation_type\": { \n\t\t\"key\": \"leaving_first_point\"\n\t},\n\t\"passage_order_type\": {\n\t\t\"key\": \"strict\" \n\t},\n \"dates\": [\"2020-09-12\", \"2020-09-13 00:00\", \"2020-10-15 00:00:00\"], \n \"work_types\": [\"work1\", \"work2\"], \n\t\"points\": [{ \n\t\t\"name\": \"point11\",\n\t\t\"type\": { \n\t\t\t\"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n\t\t},\n\t\t\"departure\": {\n\t\t\t\"time\": \"08:00\",\n\t\t\t\"after_days\": 0,\n\t\t\t\"deviation_minutes\": 10\n\t\t},\n\t\t\"coordinates\":[ \n [37.442505, 55.750298], \n [37.421736, 55.750956],\n [37.422764, 55.750934]\n ]\n\t}, {\n\t\t\"name\": \"point22\", \n\t\t\"type\": { \n\t\t\t\"key\": \"circle\"\n\t\t},\n\t\t\"arrival\": { \n\t\t\t\"time\": \"07:00\",\n\t\t\t\"after_days\": 1,\n\t\t\t\"deviation_minutes\": 10\n\t\t},\n\t\t\"departure\": { \n\t\t\t\"time\": \"06:00\",\n\t\t\t\"after_days\": 2,\n \"deviation_minutes\": 15\n\t\t},\n\t\t\"coordinates\": [ \n\t\t\t[37.492764, 55.770934]\n\t\t]\n\t}, {\n\t\t\"name\": \"point33\",\n\t\t\"type\": {\n\t\t\t\"key\": \"polygon\"\n\t\t},\n\t\t\"arrival\": {\n\t\t\t\"time\": \"22:00\",\n\t\t\t\"after_days\": 2,\n\t\t\t\"deviation_minutes\": 10\n\t\t},\n \"coordinates\":[\n [37.442505, 55.750298], \n [37.421736, 55.750956],\n [37.422764, 55.750934]\n ]\n\t}]\n}"},"url":"{{base_url}}/api_v1/trips","description":"Создание рейса
\nДобавляет новый рейс, присваивая id.
\nРоль: Редактор и выше.
\nПараметры:
\n{\n \"name\": \"A trip with 3 points\", //название, обязательное\n \"unit\": { // объект, обязательное\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {// прицеп, необязательное\n \"id\": \"4e00d717-fa03-4209-8771-a6ff71a4f65d\"\n },\n \"user_id\": \"e8c262f8-942b-4c61-bb25-825d886e627a\",// ID водителя, необязательное\n \"activation_type\": { // Тип активации, получают из справочника type=trip_activation_type\n \"key\": \"leaving_first_point\" // возможные ключи и значения: [{'time_of_first_point', 'По премени первой точки'},{'entrance_to_first_point', 'По входу в первую точку'},{'leaving_first_point', 'По выходу из первой точки'}]\n },\n \"passage_order_type\": {// Поядок прохождения получают из справочника type = trip_passage_order_type, обязательное\n \"key\": \"strict\" // availeble keys and values[{'strict', Строгий},{'arbitrary', 'Произволный'}]\n },\n \"dates\": [\"2020-09-12\", \"2020-09-13 00:00\", \"2020-10-15 00:00:00\"], //Даты поездки, required,HH:mm::ss всегда должны быть указаны нули\n \"work_types\": [\"work1\", \"work2\"], // типы работы, необязательное. Можно получить ранее добавленные значения по GET /work_types и можно добавить новые. Если добавить новые, их можно использовать при следующем добавление рейса\n \"points\": [{ // массив точек, обязательное, описание во 2-точке\n \"name\": \"point11\",\n \"type\": { \n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"departure\": {\n \"time\": \"08:00\",\n \"after_days\": 0,\n \"deviation_minutes\": 10\n },\n \"geometry\":[ \n [37.442505, 55.750298], \n [37.421736, 55.750956],\n [37.422764, 55.750934]\n ]\n }, {\n \"name\": \"point22\", // название точки, string, обязательное\n \"type\": { // тип геозоны, object, обязательное\n \"key\": \"circle\", // один из ['point', 'circle', 'line', 'polygon']\n \"type\": \"geozone_type\", // всегда geozone_type\n \"value\": \"Круг\"\n },\n \"arrival\": { // прибытие, object, необязательное\n \"time\": \"07:00\", // время прибытия, string\n \"after_days\": 0, // через сколько дней c начала поездки, int\n \"deviation_minutes\": 10 // отклонение времени прибытия в минутах\n },\n \"departure\": { // отправления, object, необязательное\n \"time\": \"06:00\",// время отправления, string\n \"after_days\": 1, //через сколько дней c начала поездки, int\n \"deviation_minutes\": 15 // отклонение времени отправления в минутах\n },\n \"geometry\": [ // координаты точки, обязательное\n [37.492764, 55.770934]\n ]\n }, {\n \"name\": \"point33\",\n \"type\": {\n \"key\": \"polygon\"\n },\n \"arrival\": {\n \"time\": \"22:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 10\n },\n \"geometry\":[\n [37.442505, 55.750298], \n [37.421736, 55.750956],\n [37.422764, 55.750934]\n ]\n }]\n}\n\nОтвет:
\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.
\n","urlObject":{"path":["api_v1","trips"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"423f18db-af2b-4979-8488-dfbcb6143d4b"},{"name":"/trips?ids=Получить рейсы
\nВозвращает массив всех рейсов.
\nРоль: Читатель и выше.
\nОтвет:
\nЕсли запрашивается по одному id - вернется не массив, а один объект.
\nЕсли запрос без id (просто GET /trips), то вернутся все маршруты.
\n/trips?ids=41513f12-1773-43ed-92c5-197dac6b08a2\n{\n \"id\": \"41513f12-1773-43ed-92c5-197dac6b08a2\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"A trip with 3 points\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user_id\": \"e8c262f8-942b-4c61-bb25-825d886e627a\",\n \"dates\": [\n \"2020-09-12 00:00:00\",\n \"2020-09-13 00:00:00\",\n \"2020-10-15 00:00:00\"\n ],\n \"activation_type\": {\n \"key\": \"leaving_first_point\",\n \"type\": \"trip_activation_type\",\n \"value\": \"По выходу из первой точки\"\n },\n \"passage_order_type\": {\n \"key\": \"strict\",\n \"type\": \"trip_passage_order_type\",\n \"value\": \"Строгий\"\n },\n \"work_types\": [\n \"work1\",\n \"work2\"\n ],\n \"points\": [\n {\n \"name\": \"point11\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"geometry\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"departure\": {\n \"time\": \"08:00\",\n \"after_days\": 0,\n \"deviation_minutes\": 10\n }\n },\n {\n \"name\": \"point22\",\n \"type\": {\n \"key\": \"circle\",\n \"type\": \"geozone_type\",\n \"value\": \"Круг\"\n },\n \"geometry\": [\n [\n 37.492764,\n 55.770934\n ]\n ],\n \"arrival\": {\n \"time\": \"07:00\",\n \"after_days\": 1,\n \"deviation_minutes\": 10\n },\n \"departure\": {\n \"time\": \"06:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 15\n }\n },\n {\n \"name\": \"point33\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"geometry\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"arrival\": {\n \"time\": \"22:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 10\n }\n }\n ]\n}\n\nУдаление рейса по его ID
\nПараметры:
\nid рейса
\nРоль: Редактор и выше.
\nОтвет:
\n200 Удаленный рейс
\nЕсли рейс с таким id не найден возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID рейса
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"c3deb6f4-18da-44f9-91a1-e270898d1e32"},{"name":"/trips?ids=:ids","id":"09d2e789-7e46-43c9-ae8f-21e9765e87a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/trips?ids=","description":"Планирование удаления рейсов
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","trips"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"09d2e789-7e46-43c9-ae8f-21e9765e87a2"},{"name":"/trips","id":"abd8f4f8-9242-4f35-8e81-7faa2d58c941","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/trips","description":"Планирование удаления рейсов
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","trips"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"abd8f4f8-9242-4f35-8e81-7faa2d58c941"},{"name":"/trips/:id","id":"329f3bba-0cc7-460c-b99e-f1ebb9175fad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"db91e93d-202d-4cca-9bc9-883e237ff532\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"New new for trip\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user_id\": \"e8c262f8-942b-4c61-bb25-825d886e627a\",\n \"dates\": [\n \"2020-09-12 00:00:00\",\n \"2020-09-13 00:00:00\",\n \"2020-10-15 00:00:00\"\n ],\n \"activation_type\": {\n \"key\": \"leaving_first_point\",\n \"type\": \"trip_activation_type\",\n \"value\": \"По выходу из первой точки\"\n },\n \"passage_order_type\": {\n \"key\": \"strict\",\n \"type\": \"trip_passage_order_type\",\n \"value\": \"Строгий\"\n },\n \"work_types\": [\n \"work1\",\n \"work2\"\n ],\n \"points\": [\n {\n \"name\": \"point11\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"coordinates\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"departure\": {\n \"time\": \"08:00\",\n \"after_days\": 0,\n \"deviation_minutes\": 10\n }\n },\n {\n \"name\": \"point22\",\n \"type\": {\n \"key\": \"circle\",\n \"type\": null,\n \"value\": null\n },\n \"coordinates\": [\n [\n 37.492764,\n 55.770934\n ]\n ],\n \"arrival\": {\n \"time\": \"07:00\",\n \"after_days\": 1,\n \"deviation_minutes\": 10\n },\n \"departure\": {\n \"time\": \"06:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 15\n }\n },\n {\n \"name\": \"point33\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": null,\n \"value\": null\n },\n \"coordinates\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"arrival\": {\n \"time\": \"22:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 10\n }\n }\n ]\n}"},"url":"{{base_url}}/api_v1/trips/:id","description":"Обновление данных рейса
\nОбновляет переданные параметры
\nРоль: Редактор и выше.
\nПараметры:
\nсм метод POST /trips
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /trips
\n","urlObject":{"path":["api_v1","trips",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID рейса
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"329f3bba-0cc7-460c-b99e-f1ebb9175fad"},{"name":"/trips/list","id":"2d19e13c-4ee1-40c1-aaf8-f5540f299eb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"sortField\": \"name\", \n \"conditions\": [\n {\"field\": \"activation_type.key\", \"value\": \"leaving_first_point\"}, \n {\"field\": \"passage_order_type.key\", \"value\": \"strict\"}\n ]\n}\n"},"url":"{{base_url}}/api_v1/trips/list","description":"Получение рейсов по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[name, created, is_delete]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - name (можно искать по неполному слову), unit.id, user_id, activation_type.key, passage_order_type.key
Пример запроса:
\nПолучить первые 10 рейсов, отсортированные по возрастанию по имени, которые имеют ID объекта 7e1aaba2-625a-4a4c-b765-9934bec5a096
\n{\n \"from\":0,\n \"count\":10,\n \"sortField\":\"name\",\n \"sortDesc\":\"false\", \"conditions\":[ \n { \"field\": \"unit.id\", \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"}\n ]\n}\n\nОтвет:
\n{\n \"max\": 1,\n \"list\": [\n {\n \"id\": \"41513f12-1773-43ed-92c5-197dac6b08a2\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"A trip with 3 points\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user_id\": \"e8c262f8-942b-4c61-bb25-825d886e627a\",\n \"dates\": [],\n \"activation_type\": {\n \"key\": \"leaving_first_point\",\n \"type\": null,\n \"value\": null\n },\n \"passage_order_type\": {\n \"key\": \"strict\",\n \"type\": null,\n \"value\": null\n },\n \"work_types\": [\n \"work1\",\n \"work2\"\n ],\n \"points\": [\n {\n \"name\": \"point11\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"geometry\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"departure\": {\n \"time\": \"08:00\",\n \"after_days\": 0,\n \"deviation_minutes\": 10\n }\n },\n {\n \"name\": \"point22\",\n \"type\": {\n \"key\": \"circle\",\n \"type\": \"geozone_type\",\n \"value\": \"Круг\"\n },\n \"geometry\": [\n [\n 37.492764,\n 55.770934\n ]\n ],\n \"arrival\": {\n \"time\": \"07:00\",\n \"after_days\": 1,\n \"deviation_minutes\": 10\n },\n \"departure\": {\n \"time\": \"06:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 15\n }\n },\n {\n \"name\": \"point33\",\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"geometry\": [\n [\n 37.442505,\n 55.750298\n ],\n [\n 37.421736,\n 55.750956\n ],\n [\n 37.422764,\n 55.750934\n ]\n ],\n \"arrival\": {\n \"time\": \"22:00\",\n \"after_days\": 2,\n \"deviation_minutes\": 10\n }\n }\n ]\n }\n ]\n}\n\nРабота с Рейсами
\n","event":[{"listen":"prerequest","script":{"id":"4e92f3f8-a547-4818-a04d-31e11fa6c27e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d660471d-6c78-401d-a3bb-68b93ba6ce2f","type":"text/javascript","exec":[""]}}],"_postman_id":"608f1810-3576-40a2-acf1-45975e2cc090"},{"name":"Объекты","item":[{"name":"/units","id":"8d9df07b-752a-4b59-ac91-219b25539c4e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Hitachi XXXX\",\n \"type\": {\n \"key\": \"special_equipment\",\n \"type\": \"unit_type\",\n \"value\": \"Спецтехника\"\n },\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"12345\",\n \"phonenumber\": \"+71232131231\",\n \"phonenumber2\": \"+21312123231\",\n \"icon\": {\n \"key\": \"excavator_green\",\n \"type\": \"unit_icon\",\n \"value\": \"Иконка\"\n },\n \"services\": [],\n \"sensors\": [\n {\n \"name\": \"ДУТ-1\",\n \"type\": {\n \"key\": \"fuelsensor\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик топлива\"\n },\n \"param1\": {\n \"param_key\": \"dut_485_1\",\n \"min_valid\": 1.0,\n \"max_valid\": 4096.0,\n \"smoothing\": 0.0,\n \"calibrationABlist\": [\n {\n \"fromValue\": 0.0,\n \"a\": 0.087,\n \"b\": 0.0\n },\n {\n \"fromValue\": 115.0,\n \"a\": 0.0282,\n \"b\": 6.7606\n },\n {\n \"fromValue\": 470.0,\n \"a\": 0.0312,\n \"b\": 5.3583\n },\n {\n \"fromValue\": 791.0,\n \"a\": 0.0332,\n \"b\": 3.7209\n },\n {\n \"fromValue\": 1092.0,\n \"a\": 0.0383,\n \"b\": -1.8391\n },\n {\n \"fromValue\": 1353.0,\n \"a\": 0.0394,\n \"b\": -3.2677\n },\n {\n \"fromValue\": 1607.0,\n \"a\": 0.0413,\n \"b\": -6.405\n },\n {\n \"fromValue\": 1849.0,\n \"a\": 0.0412,\n \"b\": -6.0905\n },\n {\n \"fromValue\": 2092.0,\n \"a\": 0.0403,\n \"b\": -4.3548\n },\n {\n \"fromValue\": 2216.0,\n \"a\": 0.0403,\n \"b\": -4.3548\n },\n {\n \"fromValue\": 2340.0,\n \"a\": 0.042,\n \"b\": -8.3193\n },\n {\n \"fromValue\": 2459.0,\n \"a\": 0.0403,\n \"b\": -4.1532\n },\n {\n \"fromValue\": 2583.0,\n \"a\": 0.0389,\n \"b\": -0.5058\n },\n {\n \"fromValue\": 2840.0,\n \"a\": 0.045,\n \"b\": -17.9279\n },\n {\n \"fromValue\": 3062.0,\n \"a\": 0.0398,\n \"b\": -1.992\n },\n {\n \"fromValue\": 3313.0,\n \"a\": 0.0405,\n \"b\": -4.1295\n },\n {\n \"fromValue\": 3560.0,\n \"a\": 0.0426,\n \"b\": -11.4893\n },\n {\n \"fromValue\": 3983.0,\n \"a\": 0.0625,\n \"b\": -90.9375\n },\n {\n \"fromValue\": 4095.0,\n \"a\": 0.0625,\n \"b\": -90.9375\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": 0.0,\n \"y\": 0.0\n },\n {\n \"x\": 115.0,\n \"y\": 10.0\n },\n {\n \"x\": 470.0,\n \"y\": 20.0\n },\n {\n \"x\": 791.0,\n \"y\": 30.0\n },\n {\n \"x\": 1092.0,\n \"y\": 40.0\n },\n {\n \"x\": 1353.0,\n \"y\": 50.0\n },\n {\n \"x\": 1607.0,\n \"y\": 60.0\n },\n {\n \"x\": 1849.0,\n \"y\": 70.0\n },\n {\n \"x\": 2092.0,\n \"y\": 80.0\n },\n {\n \"x\": 2216.0,\n \"y\": 85.0\n },\n {\n \"x\": 2340.0,\n \"y\": 90.0\n },\n {\n \"x\": 2459.0,\n \"y\": 95.0\n },\n {\n \"x\": 2583.0,\n \"y\": 100.0\n },\n {\n \"x\": 2840.0,\n \"y\": 110.0\n },\n {\n \"x\": 3062.0,\n \"y\": 120.0\n },\n {\n \"x\": 3313.0,\n \"y\": 130.0\n },\n {\n \"x\": 3560.0,\n \"y\": 140.0\n },\n {\n \"x\": 3983.0,\n \"y\": 158.0\n },\n {\n \"x\": 4095.0,\n \"y\": 165.0\n }\n ]\n },\n \"param2\": {\n \"param_key\": \"skif_text\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"invalid\": false\n },\n {\n \"name\": \"Зажигание\",\n \"type\": {\n \"key\": \"ignition\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик зажигания\"\n },\n \"param1\": {\n \"param_key\": \"voltage_main\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [\n {\n \"fromValue\": 26500.0,\n \"a\": 0.0,\n \"b\": 1.0\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": 26500.0,\n \"y\": 1.0\n }\n ]\n },\n \"param2\": {\n \"param_key\": \"skif_text\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"invalid\": false\n },\n {\n \"name\": \"Пробег\",\n \"type\": {\n \"key\": \"mileage\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик пробега\"\n },\n \"param1\": {\n \"param_key\": \"mileage_cur\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"param2\": {\n \"param_key\": \"skif_text\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"invalid\": false\n },\n {\n \"name\": \"Напряжение [mV]\",\n \"type\": {\n \"key\": \"power\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик напряжения\"\n },\n \"param1\": {\n \"param_key\": \"voltage_main\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"param2\": {\n \"param_key\": \"skif_text\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"invalid\": false\n }\n ],\n \"custom_fields\": [\n {\n \"name\": \"S-2551\",\n \"key\": \"S-2551\",\n \"value\": \"#31\",\n \"group\": \"cf_custom\",\n \"sort\": 0\n },\n {\n \"name\": \"Мин. время стоянки (сек)\",\n \"key\": \"tripdetector_minparktime\",\n \"value\": \"600\",\n \"group\": \"cf_trips\",\n \"sort\": 1\n },\n {\n \"name\": \"Мин. объем заправки\",\n \"key\": \"fuel_fillings_minfilling\",\n \"value\": \"20\",\n \"group\": \"cf_fuel\",\n \"sort\": 1\n },\n {\n \"name\": \"Расход летом (л/100км.)\",\n \"key\": \"fuel_consumption_summerconsump\",\n \"value\": \"0\",\n \"group\": \"cf_fuel\",\n \"sort\": 1\n },\n {\n \"name\": \"Аналитик\",\n \"key\": \"analyst\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 1\n },\n {\n \"name\": \"Коэф. пробега\",\n \"key\": \"advanced_mileagecoeff\",\n \"value\": \"1.0\",\n \"group\": \"cf_trips\",\n \"sort\": 2\n },\n {\n \"name\": \"Игнор-ть сообщ-я после начала движения\",\n \"key\": \"fuel_fillings_msgignorestart\",\n \"value\": \"60\",\n \"group\": \"cf_fuel\",\n \"sort\": 2\n },\n {\n \"name\": \"Расход зимой (л/100км.)\",\n \"key\": \"fuel_consumption_winterconsump\",\n \"value\": \"0\",\n \"group\": \"cf_fuel\",\n \"sort\": 2\n },\n {\n \"name\": \"Установщик\",\n \"key\": \"installer\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 2\n },\n {\n \"name\": \"Мин. скорость движ-я (км/ч)\",\n \"key\": \"tripdetector_minmovespeed\",\n \"value\": \"1\",\n \"group\": \"cf_trips\",\n \"sort\": 3\n },\n {\n \"name\": \"Мин. время остановки для опр-ия слива\",\n \"key\": \"fuel_fillings_minstaytheft\",\n \"value\": \"60\",\n \"group\": \"cf_fuel\",\n \"sort\": 3\n },\n {\n \"name\": \"На холостом ходу летом (л./час.)\",\n \"key\": \"fuel_math_idlingsummer\",\n \"value\": \"0\",\n \"group\": \"cf_fuel\",\n \"sort\": 3\n },\n {\n \"name\": \"Мин. объем слива\",\n \"key\": \"fuel_fillings_minitheft\",\n \"value\": \"25\",\n \"group\": \"cf_fuel\",\n \"sort\": 4\n },\n {\n \"name\": \"Дата установки\",\n \"key\": \"install_date\",\n \"value\": \"16.07.2019\",\n \"group\": \"cf_etc\",\n \"sort\": 4\n },\n {\n \"name\": \"На холостом ходу зимой (л./час.)\",\n \"key\": \"fuel_math_idlingwinter\",\n \"value\": \"0\",\n \"group\": \"cf_fuel\",\n \"sort\": 4\n },\n {\n \"name\": \"Мин. расст-ие поездки (м)\",\n \"key\": \"tripdetector_mintripdist\",\n \"value\": \"100\",\n \"group\": \"cf_trips\",\n \"sort\": 4\n },\n {\n \"name\": \"Макс. интервал между сообщ-ми (сек)\",\n \"key\": \"advanced_maxintervalmsg\",\n \"value\": \"3600\",\n \"group\": \"cf_trips\",\n \"sort\": 5\n },\n {\n \"name\": \"Коэф. при движении под нагрузкой\",\n \"key\": \"fuel_math_coeffunderload\",\n \"value\": \"0\",\n \"group\": \"cf_fuel\",\n \"sort\": 5\n },\n {\n \"name\": \"Место установки в ТС\",\n \"key\": \"install_place\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 5\n },\n {\n \"name\": \"Макс. расст-ие между сообщ-ми (м)\",\n \"key\": \"tripdetector_maxdistancemsg\",\n \"value\": \"1000\",\n \"group\": \"cf_trips\",\n \"sort\": 6\n },\n {\n \"name\": \"Первый месяц зимы (январь-1)\",\n \"key\": \"fuel_consumption_winterfrom\",\n \"value\": \"11\",\n \"group\": \"cf_fuel\",\n \"sort\": 6\n },\n {\n \"name\": \"Серийный номер терминала\",\n \"key\": \"serial_number\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 6\n },\n {\n \"name\": \"Мин. время поездки (сек)\",\n \"key\": \"tripdetector_mintriptime\",\n \"value\": \"300\",\n \"group\": \"cf_trips\",\n \"sort\": 7\n },\n {\n \"name\": \"Последний месяц зимы (январь-1)\",\n \"key\": \"fuel_consumption_winterto\",\n \"value\": \"3\",\n \"group\": \"cf_fuel\",\n \"sort\": 7\n },\n {\n \"name\": \"Серийный номер ДУТ\",\n \"key\": \"serial_number_dut\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 7\n },\n {\n \"name\": \"Стоимость (1 л.)\",\n \"key\": \"fuel_price\",\n \"value\": \"45\",\n \"group\": \"cf_fuel\",\n \"sort\": 8\n },\n {\n \"name\": \"Опр-ие движ-я\",\n \"key\": \"key_tripdetector_movedetect\",\n \"value\": \"speedkph\",\n \"group\": \"cf_trips\",\n \"sort\": 8\n },\n {\n \"name\": \"Серийный номер пломбы ДУТ\",\n \"key\": \"dut_seal_serial_number\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 8\n },\n {\n \"name\": \"Определение пробега\",\n \"key\": \"tripdetector_mileagedetect\",\n \"value\": \"mileage_GPS\",\n \"group\": \"cf_trips\",\n \"sort\": 9\n },\n {\n \"name\": \"Гос номер\",\n \"key\": \"license_plate_number\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 9\n },\n {\n \"name\": \"Определение моточасов\",\n \"key\": \"key_motohourdetector\",\n \"value\": \"ignition\",\n \"group\": \"cf_motohours\",\n \"sort\": 10\n },\n {\n \"name\": \"Норма часов в день\",\n \"key\": \"hours_rate\",\n \"value\": \"8\",\n \"group\": \"cf_etc\",\n \"sort\": 10\n },\n {\n \"name\": \"Дата блокировки(yyyy-MM-dd)\",\n \"key\": \"block_date\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 11\n },\n {\n \"name\": \"КП\",\n \"key\": \"kp\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 12\n },\n {\n \"name\": \"ДУТ\",\n \"key\": \"dut\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 13\n },\n {\n \"name\": \"Вторая sim\",\n \"key\": \"second_sim\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 14\n },\n {\n \"name\": \"Серийный номер ДУТ 1\",\n \"key\": \"serial_number_dut_1\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 15\n },\n {\n \"name\": \"Серийный номер ДУТ 2\",\n \"key\": \"serial_number_dut_2\",\n \"value\": \"\",\n \"group\": \"cf_etc\",\n \"sort\": 16\n },\n {\n \"name\": \"translate.custom_fields.name.counters_mileagekey\",\n \"key\": \"counters_mileagekey\",\n \"value\": \"gps_mileage\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.counters_mileagecurr\",\n \"key\": \"counters_mileagecurr\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.counters_mileageauto\",\n \"key\": \"counters_mileageauto\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.counters_engienecurr\",\n \"key\": \"counters_engienecurr\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.counters_gprscurr\",\n \"key\": \"counters_gprscurr\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.counters_gprsauto\",\n \"key\": \"counters_gprsauto\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.advanced_speedlimit\",\n \"key\": \"advanced_speedlimit\",\n \"value\": \"130\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.advanced_urbspeedlimit\",\n \"key\": \"advanced_urbspeedlimit\",\n \"value\": \"60\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.advanced_dailyengine\",\n \"key\": \"advanced_dailyengine\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.tripdetector_movedetectkey\",\n \"key\": \"tripdetector_movedetectkey\",\n \"value\": \"speed\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.tripdetector_gpscorrect\",\n \"key\": \"tripdetector_gpscorrect\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.tripdetector_minsatellites\",\n \"key\": \"tripdetector_minsatellites\",\n \"value\": \"3\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.tripdetector_mintipdist\",\n \"key\": \"tripdetector_mintipdist\",\n \"value\": \"100\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_fillings_fillingstop\",\n \"key\": \"fuel_fillings_fillingstop\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_fillings_ignorefiltration\",\n \"key\": \"fuel_fillings_ignorefiltration\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_sensors_mergenameslevel\",\n \"key\": \"fuel_sensors_mergenameslevel\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_sensors_mergenamesconsum\",\n \"key\": \"fuel_sensors_mergenamesconsum\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_sensors_timelevel\",\n \"key\": \"fuel_sensors_timelevel\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_sensors_filtervalues\",\n \"key\": \"fuel_sensors_filtervalues\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_math_idling\",\n \"key\": \"fuel_math_idling\",\n \"value\": \"2\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_math_urbcycle\",\n \"key\": \"fuel_math_urbcycle\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_math_suburbcycle\",\n \"key\": \"fuel_math_suburbcycle\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_levelsensors\",\n \"key\": \"fuel_level_levelsensors\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_repivalid\",\n \"key\": \"fuel_level_repivalid\",\n \"value\": \"true\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_impulsefuel\",\n \"key\": \"fuel_level_impulsefuel\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_maximpulse\",\n \"key\": \"fuel_level_maximpulse\",\n \"value\": \"0\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_skipfirstzero\",\n \"key\": \"fuel_level_skipfirstzero\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_absolutefuel\",\n \"key\": \"fuel_level_absolutefuel\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.fuel_level_instantfuel\",\n \"key\": \"fuel_level_instantfuel\",\n \"value\": \"false\",\n \"group\": \"cf_hidden\",\n \"sort\": 1000\n },\n {\n \"name\": \"translate.custom_fields.name.battery_charge_level_diagnostic\",\n \"key\": \"battery_charge_level_diagnostic\",\n \"value\": \"diagnostic_ten_min\",\n \"group\": \"cf_diagnostic\",\n \"sort\": 1\n }\n ],\n \"drivers\": [\n {\n \"user\": {\n \"id\": \"bd3b26b7-506d-4cc6-8ab6-bf4cd1b9a39c\"\n },\n \"date_from\": \"2022-10-03 00:00:00\",\n \"date_to\": \"2022-10-04 00:00:00\"\n },\n {\n \"user\": {\n \"id\": \"bd3b26b7-506d-4cc6-8ab6-bf4cd1b9a39c\"\n },\n \"date_from\": \"2022-10-05 00:00:00\",\n \"date_to\": \"2022-10-10 00:00:00\"\n }\n ],\n \"trailers\": [\n {\n \"trailer\": {\n \"id\": \"fcaf9265-5a5b-4d35-8b00-ee146b8dc8f6\"\n },\n \"date_from\": \"2022-10-03 00:00:00\",\n \"date_to\": \"2022-10-04 00:00:00\"\n },\n {\n \"trailer\": {\n \"id\": \"d0bc0903-702b-4d96-826a-e26860681356\"\n },\n \"date_from\": \"2022-10-05 00:00:00\",\n \"date_to\": \"2022-10-10 00:00:00\"\n }\n ]\n}"},"url":"{{base_url}}/api_v1/units","description":"Создание объекта
\nПараметры:
\n\"name\": \"Автомобиль обычный-1\" // Номер, наименование объекта,\n\"type\": {\"key\":\"transport\"} // Тип объекта (из dictionary, все ключи с типом 'unit_type'),\n\"terminal_type\":{\"key\": \"navtelecom\"} // Тип устройства (из dictionary, все ключи с типом 'terminal_type'),\n\"imei\": \"352093084258333\" // imei устройства\n\"phonenumber\": \"89248608208\" // номер телефона\n\"phonenumber2\": \"+79851234567\" // второй номер телефона\n\"icon\": {\"key\":\"car_blue\"} // ключ иконки (из dictionary, все ключи с типом 'unit_icon')\nдоп поля: // смотри GET /custom_fields, ссылка ниже.\n\"custom_fields\": [\n {\"name\": \"analist\", 'key': 'analist', \"value\": \"Петров\"},\n {\"name\": \"counters_mileagekey\", \"key\": \"counters_mileagekey\", \"value\": \"gps_mileage\"},\n {\"name\": \"counters_mileagecurr\", \"key\": \"counters_mileagecurr\", \"value\": \"2400\"},\n {\"name\": \"tripdetector_movedetectkey\", \"key\": \"tripdetector_movedetectkey\", \"value\": \"speed\"},\n {\"name\": \"Минимальный объем заправки\", \"key\": \"fuel_fillings_minfilling\", \"value\": \"10\"},\n {\"name\": \"advanced_mileagecoeff\", \"key\": \"advanced_mileagecoeff\", \"value\": \"1.0\"},\n {\"name\": \"Видео устройство\", \"key\": \"video_device_name\", \"value\": \"CARVIS\", \"group\": \"cf_etc\"},\n {\"name\": \"ID-видео устройства\", \"key\": \"video_device_id\", \"value\": \"3432426544\", \"group\": \"cf_etc\"},\n {\"name\": \"Камеры\", \"key\": \"video_cameras\", \"value\": \"0,1,2\", \"group\": \"cf_etc\"}\nСмены:\n\"drivers\": [\n {\n \"user\": { // Водитель\n \"id\": \"bd3b26b7-506d-4cc6-8ab6-bf4cd1b9a39c\"\n },\n \"date_from\": \"2022-10-03 00:00:00\", // от\n \"date_to\": \"2022-10-04 00:00:00\"// до\n },\n {\n \"user\": {\n \"id\": \"bd3b26b7-506d-4cc6-8ab6-bf4cd1b9a39c\"\n },\n \"date_from\": \"2022-10-05 00:00:00\",\n \"date_to\": \"2022-10-10 00:00:00\"\n }\n ],\nНазначение прицепов\n \"trailers\": [\n {\n \"trailer\": { // Прицеп\n \"id\": \"fcaf9265-5a5b-4d35-8b00-ee146b8dc8f6\"\n },\n \"date_from\": \"2022-10-03 00:00:00\", // от\n \"date_to\": \"2022-10-04 00:00:00\" // до\n },\n {\n \"trailer\": {\n \"id\": \"d0bc0903-702b-4d96-826a-e26860681356\"\n },\n \"date_from\": \"2022-10-05 00:00:00\",\n \"date_to\": \"2022-10-10 00:00:00\"\n }\n ],\n\"services\": [{\n \"id\":\"23453-5435345-234345345-34534533\" // ОПЦИОНАЛЬНО ! Если сервис уже сохранен в БД и имеет id, то для его маппинга на текущий создаваемый юнит, необходимо указать его id, если сервис будет создаваться вместе с юнитом, то параметра \"id\" быть не должно. \n \"name\": \"Очередное ТО\" // наименование сервиса,\n \"description\": \"ваш текст\" // описание,\n \"isActiveKm\": \"true\" // активно или нет по км,\n \"intervalKm\": \"10000\" // периодичность по км,\n \"lastKm\": \"45000\" // последний раз по км,\n \"isActiveDays\": \"true\" // активно или нет по дням,\n \"intervaldays\": \"60\" // периодичность по дням,\n \"lastdays\": \"2019-05-14\" // последний раз по дням (Формат yyyy-MM-dd),\n \"isActiveMotohours\": \"true\" // активно или нет по моточасам,\n \"intervalMotohours\": \"1200\" // периодичность по моточасам,\n \"lastMotohours\": \"14000\" // последний раз по моточасам \n}]\nДатчики (Можно создавать отдельно через /units/sensors (без привязки к unit) или /units/:unit_id/sensors (с привязкой к unit)):\nsensors:[{\n \"id\":\"23453-5435345-234345345-34534533\" // ОПЦИОНАЛЬНО ! Если сенсор уже сохранен в БД и имеет id, то для его маппинга на текущий создаваемый юнит, необходимо указать его id, если сенсор будет создаваться вместе с юнитом, то параметра \"id\" быть не должно.\n \"name\": \"Зажигание\" // Название датчика ,\n \"type\": {\"key\":\"ignition\"} // тип датчика (из dictrionary, все ключи с типом \"sensor_type\"),\n \"param1\":{ // Параметр №1 сенсора. Под примером доп.инфа.\n \"param_key\": \"dut_485_1\", // ключ параметрa, должен быть в списке разрешенных ключей для конкретного терминала (/units/sensors/params)\n \"calibrationABlist\": // Лист калибровок AB\n [{\n \"fromValue\": 1.0, // нижняя граница\n \"a\": 2.0, // коэффициент А\n \"b\": 3.0 // коэффициент B\n }], \n \"calibrationXYlist\": // Лист калибровок AB\n [{\n \"x\": 1.0, // коэффициент X\n \"y\": 5.0 // коэффициент Y\n }]\n }, \n \"param2\":{ // Параметр №2 сенсора. Под примером доп.инфа.\n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{\n \"fromValue\": 1.0,\n \"a\": 1.0, \n \"b\": 1.0\n }], \n \"calibrationXYlist\":\n [{\n \"x\": 1.0,\n \"y\": 2.0\n }]\n }, \n \"hide_in_reports\": false, // флажок используется, чтобы скрыть в отчетах, По умолчанию false\n \"hide_in_monitoring\": true, // флажок используется чтобы скрыть значение датчика в мониторинге, По умолчанию false\n \"formula\": \"S1\" // формула связки параметра 1 и параметра 2. Полный список возможных значений лежит в Dictionaries по ключу \"formula\"\n \"expression\": \"$param + ${Пробег} / 100\"// выражения формулы, это поле нужно только в случае formula=EXPR и имеет следующие синтаксисы 1) обращение к значениям любого параметра из сырых данных - #param333 (обращение к параметру param333)\n \"retrans_param_name\": \"fuel_level_1\",Ретранслировать в параметр, необязательное поле\n2)обращение к параметру текущего датчика - $param\nконстанты - 1000 (константа 1000)\n3)обращение к значению других датчиков ${Название датчика}\n4)арифметические операции - + * / ^(степень)\nскобки - ( или ) \n},\n}]\n\nПо доп. полям смотрите GET /custom_fields
\nОписание param1, param2 сенсора: Данные параметры являются опциональными и если пользователь их не заполнил, то передавать их вообще не надо. Перед сохранением param1 и param2 происходит пересчет их внутренних калибровочных листов (калибровкиAB и КалибровкиXY). Лист КалибровокAB и лист калибровокXY у конкретного параметра взаимосвязаны и порождают друг друга по определенным формулам, т.е. из листа калибровок XY можно вычислить лист калибровок AB и наоборот.
\nВ связи с этим РЕКОМЕНДУЕТСЯ перед тем, как сделать запрос, предварительно использовать метод POST /units/sensors/recalc для пересчета этих листов и передавать в calibrationABlist и calibrationXYlist результат работы этого метода.
\nПосле создания, создается объект с привязкой объекта к компании пользователя.
\nРоль: Редактор и выше.
\nПример ответа:
\nВозвращается созданный объект
\n[{\n \"id\": \"72154648-1f0d-4acc-a74d-81c7926e4483\",\n \"type\": {\n \"key\":\"farm_equipment\",\n \"type\":\"unit_type\",\n \"value\":\"Сельхозтехника\"\n },\n \"is_delete\": 0,\n \"company_id\": \"d12c453b-d25c-445a-9e5b-ee9f9d4b7dff\",\n \"name\": \"Scania K 810 MT 159\",\n \"terminal_type\": {\n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\": \"868926035645339\",\n \"phonenumber\": \"+79223569544\",\n \"icon\": {\n \"key\":\"bus\",\n \"type\":\"unit_icon\",\n \"value\":\"автобус\"\n },\n custom_fields: [\n {\"name\":\"Игнорировать сообщения после начала движения\",\"key\":\"fuel_fillings_msgignorestart\",\"value\":60.0},\n {\"name\":\"Мин. время остановки для определения слива\",\"key\":\"fuel_fillings_minstaytheft\",\"value\":60.0},\n {\"name\":\"Минимальный объем слива\",\"key\":\"fuel_fillings_minitheft\",\"value\":10.0},\n {\"name\":\"Мин. время стоянки\",\"key\":\"tripdetector_minparktime\",\"value\":300.0},\n {\"name\":\"Коэффициент пробега\",\"key\":\"advanced_mileagecoeff\",\"value\":1.0},\n {\"name\":\"Мин. скорость движения\",\"key\":\"tripdetector_minmovespeed\",\"value\":3.0},\n {\"name\":\"Мин. расстояние поездки\",\"key\":\"tripdetector_mintripdist\",\"value\":100.0}\n ],\n \"services\": [{\n \"id\": \"1e83e291-690e-491e-84ee-e0d3e1397055\",\n \"unit_id\": \"72154648-1f0d-4acc-a74d-81c7926e4483\",\n \"name\": \"Очередное ТО\",\n \"description\": \"\",\n \"isactiveKm\": 1,\n \"intervalKm\": 10000,\n \"lastkm\": 45000,\n \"isActiveDays\": 1,\n \"intervalDays\": 60,\n \"lastDays\": \"2019-05-14 05:00:00\",\n \"isActiveMotohours\": true,\n \"intervalMotohours\": 1200,\n \"lastMotohours\": 18600,\n }],\n \"sensors\": [{\n \"id\": \"3c5b7072-abd5-4095-8be7-02d4b75751c0\",\n \"unit_id\": \"72154648-1f0d-4acc-a74d-81c7926e4483\",\n \"name\": \"Зажигание\",.\n \"typekey\": \"ignition\",\n \"param1\":{ \n \"param_key\": \"dut_485_1\",\n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 2.0, \"b\": 3.0 }], \n \"calibrationXYlist\": \n [{ \"x\": 1.0, \"y\": 5.0 }]\n }, \n \"param2\":{ \n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 1.0, \"b\": 1.0 }], \n \"calibrationXYlist\":\n [{ \"x\": 1.0, \"y\": 2.0 }]\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"hide_in_monitoring\": false\n }]\n}]\n\nПоиск объектов по ID (через запятую)
\nВозвращает массив объектов.
Если параметр 'ids' пустой (т.е. запрос = 'GET /units', без параметра), то вернётся список всех объектов по всем компаниям пользователя, из которого исключаются удаленные юниты. Если ids не пустой (т.е. запрос = 'GET /units?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных юнитов.
Если в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный объект.
\nРоль: Читатель и выше.
\nПример ответа:
\n[ \n { \n \"id\":\"2bcd95c4-d520-4203-89fc-b0d3a76a7d6b\",\n \"name\":\"testName-1\",\n \"type\":{ \n \"key\":\"farm_equipment\",\n \"type\":\"unit_type\",\n \"value\":\"Сельхозтехника\"\n },\n \"terminal_type\":{ \n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\":\"743b075b-3006-4450-83f8-46d80b13586b\",\n \"phonenumber\":\"8(914)3333333\",\n \"units_groups_names\": \"ТЕст123, НОДГП-1 (НОДГП-1 Кокшетау), Ntcn, все тест, Новая, НЖС-1 (ЭЧ-8 Астана)\",\n \"icon\":{ \n \"key\":\"bus\",\n \"type\":\"unit_icon\",\n \"value\":\"Автобус\"\n },\n \"services\":[ \n { \n \"id\":\"e257e819-5d09-4da2-8ee4-9c072fef6de0\",\n \"unit_id\":\"2bcd95c4-d520-4203-89fc-b0d3a76a7d6b\",\n \"name\":\"testService\",\n \"description\":\"dumb service for test\",\n \"isActiveKm\":true,\n \"intervalKm\":10000,\n \"lastKm\":45000,\n \"isActiveDays\":true,\n \"intervalDays\":300,\n \"lastDays\":\"2019-06-03\",\n \"activeKm\":true,\n \"activeDays\":true\n }\n ],\n \"sensors\":[ \n { \n \"id\":\"49d91500-6582-4a8c-a341-215fe2e11279\",\n \"unit_id\":\"2bcd95c4-d520-4203-89fc-b0d3a76a7d6b\",\n \"name\":\"testSensor\",\n \"type\":{ \n \"key\":\"ignition\",\n \"type\":\"sensor_type\",\n \"value\":\"translate.sensor_type.ignition\"\n },\n \"param1\":{ \n \"param_key\": \"dut_485_1\",\n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 2.0, \"b\": 3.0 }], \n \"calibrationXYlist\": \n [{ \"x\": 1.0, \"y\": 5.0 }]\n }, \n \"param2\":{ \n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 1.0, \"b\": 1.0 }], \n \"calibrationXYlist\":\n [{ \"x\": 1.0, \"y\": 2.0 }]\n },\n \"formula\": \"S1\"\n }\n ],\n \"custom_fields\":[ \n {\"key\": limit\", \"value\": \"123\"},\n {\"key\": \"power\", \"value\": \"123kw\"}\n ]\n },\n { \n \"id\":\"3f64e76d-0ff6-46ec-90dc-baadb89733f0\",\n \"name\":\"testName-2\",\n \"type\":{ \n \"key\":\"farm_equipment\",\n \"type\":\"unit_type\",\n \"value\":\"Сельхозтехника\"\n },\n \"terminal_type\":{ \n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\":\"1406dfa0-1a6b-4cce-be8e-5d41d1eb71c9\",\n \"phonenumber\":\"8(914)3333333\",\n \"icon\":{ \n \"key\":\"bus\",\n \"type\":\"unit_icon\",\n \"value\":\"Автобус\"\n },\n \"services\":[ \n { \n \"id\":\"f19f6da9-d010-4ffe-87cc-3fa9c40667cc\",\n \"unit_id\":\"3f64e76d-0ff6-46ec-90dc-baadb89733f0\",\n \"name\":\"testService\",\n \"description\":\"dumb service for test\",\n \"isActiveKm\":true,\n \"intervalKm\":10000,\n \"lastKm\":45000,\n \"isActiveDays\":true,\n \"intervalDays\":300,\n \"lastDays\":\"2019-06-03\",\n \"activeKm\":true,\n \"activeDays\":true\n }\n ],\n \"sensors\":[ \n { \n \"id\":\"bd41f2a6-56c6-46b7-97f1-1ac1096ad81b\",\n \"unit_id\":\"3f64e76d-0ff6-46ec-90dc-baadb89733f0\",\n \"name\":\"testSensor\",\n \"type\":{ \n \"key\":\"ignition\",\n \"type\":\"sensor_type\",\n \"value\":\"translate.sensor_type.ignition\"\n },\n \"param1\":\"voltage_main\",\n \"param2\":\"speedkph\",\n \"formula\":\"S\",\n \"calibrations\":[ \n { \n \"id\":\"b2a45781-f05f-4553-be86-9320334ce864\",\n \"sensor_id\":\"bd41f2a6-56c6-46b7-97f1-1ac1096ad81b\",\n \"fromValue\":3.0,\n \"a\":1.5,\n \"b\":2.0,\n \"param_key\":\"speedkph\"\n }\n ]\n }\n ],\n \"custom_fields\":[ \n {\"name\":\"Игнорировать сообщения после начала движения\",\"key\":\"fuel_fillings_msgignorestart\",\"value\":60.0},\n {\"name\":\"Мин. время остановки для определения слива\",\"key\":\"fuel_fillings_minstaytheft\",\"value\":60.0},\n {\"name\":\"Минимальный объем слива\",\"key\":\"fuel_fillings_minitheft\",\"value\":10.0}\n ]\n }\n]\n\nОбновление объекта
\nДерево объекта должно быть полным (с обновленными полями). Поля, которые будут отсутствовать в запросе, затрутся на null.
\nРоль: Редактор и выше.
\nОтвет:
\nТот же, что и при GET /units - возвращает обновленное дерево объекта.
\n","urlObject":{"path":["api_v1","units",":unit_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"acd40524-9445-4e06-b161-8b69b081917a"},{"name":"/units/:id","id":"046603ef-c541-41eb-ab46-234e6424bee5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n\t\"custom_fields\": [{\n\t\t\t\"key\": \"video_device_name\",\n\t\t\t\"value\": \"CARVIS\"\n\t\t},\n\t\t{\n\t\t\t\"key\": \"brand_code\",\n\t\t\t\"value\": \"123432\"\n\t\t},\n\t\t{\n\t\t\t\"key\": \"tripdetector_mintriptime\",\n\t\t\t\"value\": 70\n\t\t}\n\t]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units/:id","description":"Обновление указанных полей объекта
\nПока можно указать только custom_fields
\nРоль: Редактор и выше.
\nПример запроса:
PATCH /units/836db03e-7475-4628-9323-0ca506e2061f
{\n \"custom_fields\": [{\n \"key\": \"video_device_name\",\n \"value\": \"CARVIS\"\n },\n {\n \"key\": \"brand_code\",\n \"value\": \"123432\"\n },\n {\n \"key\": \"tripdetector_mintriptime\",\n \"value\": 70\n }\n ]\n}\n\nСписок все возможных custom_fields GET /custom_fields
\nДля пользовательских полей передавайте одинаковые key и name
\nОтвет:
\nТот же, что и при GET /units - возвращает обновленное дерево объекта.
\n","urlObject":{"path":["api_v1","units",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"046603ef-c541-41eb-ab46-234e6424bee5"},{"name":"/units/recovery/:unit_id","id":"2c2fb52a-9d60-497b-8d29-4e85ff63ebd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/units/recovery/:unit_id","description":"Восстанавливает ранее удаленный юнит
\nРоль: Администратор и выше.
\nОтвет:
200 OK
ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"2c2fb52a-9d60-497b-8d29-4e85ff63ebd1"},{"name":"/units/:unit_id","id":"479ceb7b-7d64-4d82-812c-ea51940f8f1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units/:unit_id","description":"Удаление объекта
\nФизически объект не удаляется из базы - флаг is_delete переводится в состояние true (необходимо для возможного восстановления объекта).
\nРоль: Редактор и выше.
\nВ случае успеха - ответ '200'
\n","urlObject":{"path":["api_v1","units",":unit_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"479ceb7b-7d64-4d82-812c-ea51940f8f1d"},{"name":"/units/physical/:unit_id","id":"0ed3b299-94d2-4809-b27c-071f208c49f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units/physical/:unit_id","description":"Удаление объекта безвозвратно
\nРоль: Супервизор и выше.
\nВ случае успеха - ответ '200'
\n","urlObject":{"path":["api_v1","units","physical",":unit_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"0ed3b299-94d2-4809-b27c-071f208c49f4"},{"name":"/units?ids=ids","id":"bd682aa6-069b-426c-8bd3-5a3e8aa26200","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units?ids=","description":"Планирование удаления объектов
\nПланирование удаления нескольких объектов, в ids указать список идентификаторов удаляемых объектов.
\nРоль: Редактор и выше.
\nПример запроса:
DELETE /units?ids=eece8fbc-0bad-4a2d-ac24-62573860dda0,fd848416-bf81-4a92-9c01-922b2da4dd5a
Пример ответа:
\nВ случае успеха - ответ '200', в теле ответа ID задачи удаления, с помощью которого можно отменить удаление.
В случае ошибки - ответ 422, в теле текст ошибки.
{\n \"id\": \"ace239ee-b7ab-42ee-9d57-d749a23987c6\"\n}\n\nПланирование удаления объектов
\nПланирование удаления нескольких объектов, в поле ids в теле запроса необходимо указать список идентификаторов удаляемых объектов.
\nРоль: Редактор и выше.
\nПример запроса:
DELETE /units
{\n \"ids\": [\"eece8fbc-0bad-4a2d-ac24-62573860dda0\",\"fd848416-bf81-4a92-9c01-922b2da4dd5a\"]\n}\n\nПример ответа:
\nВ случае успеха - ответ 200, в теле ответа ID задачи удаления, с помощью которого можно отменить удаление.
В случае ошибки - ответ 422, в теле текст ошибки.
{\n \"id\": \"ace239ee-b7ab-42ee-9d57-d749a23987c6\"\n}\n\nПоиск сервисов по ID (через запятую)
\nПример ответа:
\nВозвращает массив найденных сервисов. Если параметр unit_id пустой, значит данный сервис не привязан к какому-либо юниту.
\n [ \n { \n \"id\":\"e257e819-5d09-4da2-8ee4-9c072fef6de0\",\n \"unit_id\":\"2bcd95c4-d520-4203-89fc-b0d3a76a7d6b\",\n \"name\":\"testService\",\n \"description\":\"dumb service for test\",\n \"isActiveKm\":true,\n \"intervalKm\":10000,\n \"lastKm\":45000,\n \"isActiveDays\":true,\n \"intervalDays\":300,\n \"lastDays\":\"2019-06-03\",\n \"activeKm\":true,\n \"activeDays\":true\n },\n {...}\n ]\n\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","units","services"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"6dce08c8-6982-4b3e-b8fb-34fe9aca5790"},{"name":"/units/:unit_id/services","id":"b114d108-11f0-433f-8e58-40d4ae7d6c58","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units/:unit_id/services","description":"Поиск всех сервисов юнита
\nВозвращает все привязанные к юниту сервисы.
\nОтвет аналогичный GET /units/services?ids=:ids
\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","units",":unit_id","services"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"b114d108-11f0-433f-8e58-40d4ae7d6c58"},{"name":"/units/:unit_id/services","id":"b1ffc9b0-1783-41ca-bf97-a6227919c280","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"testService\",\n \"description\": \"dumb service for test\",\n \"isActiveKm\": \"true\",\n \"intervalKm\": \"10000\",\n \"lastKm\": \"45000\",\n \"isActiveDays\": \"true\",\n \"intervaldays\": \"300\",\n \"lastdays\": \"2019-06-13\"\n}"},"url":"{{base_url}}/api_v1/units/:unit_id/services","description":"Отдельное создание сервиса (с привязкой к юниту)
\nДанный вариант создания сервиса позволяет создать сервис для юнита через отдельный функционал и привязать их друг к другу, используя json форму только сервиса.
\nТакже его можно создать при создании юнита (POST /units), заполнив в json'е юнита поле 'services', без указания id сервиса. Это позовлит создать и юнит и привязанный к нему сервис одномоментно.
\nРоль: Редактор и выше.
\nПример создания сервиса для юнита с id = '4ca6ed64-3b58-493c-9ac9-862fe1a01f88' по УРЛу /units/4ca6ed64-3b58-493c-9ac9-862fe1a01f88/services:
\n{\n \"name\": \"testService\" // наименование сервиса,\n \"description\": \"dumb service for test\" // описание,\n \"isActiveKm\": \"true\" // активно или нет по км,\n \"intervalKm\": \"10000\" // периодичность по км,\n \"lastKm\": \"45000\" // последний раз по км,\n \"isActiveDays\": \"true\" // активно или нет по дням,\n \"intervaldays\": \"300\" // периодичность по дням,\n \"lastdays\": \"2019-06-13\" // последний раз по дням (Формат yyyy-MM-dd)\n}\n\nПример ответа:
\n { \n \"id\":\"2c705ae1-d99c-4be3-b564-8db5ac387caf\",\n \"unit_id\":\"4ca6ed64-3b58-493c-9ac9-862fe1a01f88\",\n \"name\":\"testService\",\n \"description\":\"dumb service for test\",\n \"isActiveKm\":true,\n \"intervalKm\":10000,\n \"lastKm\":45000,\n \"isActiveDays\":true,\n \"intervalDays\":300,\n \"lastDays\":\"2019-06-03\"\n }\n\nID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"b1ffc9b0-1783-41ca-bf97-a6227919c280"},{"name":"/units/services","id":"3b7ade96-3cc0-4f96-b90b-2935f1ace7d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/units/services","description":"Отдельное создание сервиса (без привязки к юниту)
\nТо же самое, что и метод (POST /units/:unit_id/services), но без привязки к какому-то конкретному объекту.
\nОтвет будет аналогичен методу выше (POST /units/:unit_id/services), но поле 'unit_id' будет пустым.
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units","services"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3b7ade96-3cc0-4f96-b90b-2935f1ace7d1"},{"name":"/units/sensors?ids=:ids","id":"862c1e9e-5ac4-4145-a9bf-66b5644fa8f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units/sensors?ids=","description":"Поиск датчиков по ID (через запятую)
\nТо же самое что и в Сервисах GET /units/services?ids=:ids
\nПример ответа:
\n[{\n \"id\": \"3c5b7072-abd5-4095-8be7-02d4b75751c0\",\n \"unit_id\": \"72154648-1f0d-4acc-a74d-81c7926e4483\",\n \"name\": \"Зажигание\",.\n \"typekey\": \"ignition\",\n \"param1\":{ \n \"param_key\": \"dut_485_1\",\n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 2.0, \"b\": 3.0 }], \n \"calibrationXYlist\": \n [{ \"x\": 1.0, \"y\": 5.0 }]\n }, \n \"param2\":{ \n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 1.0, \"b\": 1.0 }], \n \"calibrationXYlist\":\n [{ \"x\": 1.0, \"y\": 2.0 }]\n },\n \"formula\": \"S1\"\n },\n {...}\n ]\n\nПоиск всех датчиков объекта
\nТо же самое, что и в Сервисах GET /units/:unit_id/services
\nОтвет аналогичный методу выше GET /units/sensors?ids=:ids
\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","units",":unit_id","sensors"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"292ccc1d-1711-4e27-aad8-b42cb6a43085"},{"name":"/units/:unit_id/sensors","id":"1be6ba1c-a91a-44d1-b892-2e618c64d889","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/units/:unit_id/sensors","description":"Отдельное создание датчика (с привязкой к объекту)
\nАналогично POST /units/:unit_id/services
\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"name\": \"Зажигание\" // Название датчика ,\n \"type\": {\"key\":\"ignition\"} // тип датчика (из dictrionary, все ключи с типом \"sensor_type\"),\n \"param1\":{ // Параметр №1 сенсора. Под примером доп.инфа.\n \"param_key\": \"dut_485_1\", // ключ параметрa, должен быть в списке разрешенных ключей для конкретного терминала (/units/sensors/params)\n \"calibrationABlist\": // Лист калибровок AB\n [{\n \"fromValue\": 1.0, // нижняя граница\n \"a\": 2.0, // коэффициент А\n \"b\": 3.0 // коэффициент B\n }], \n \"calibrationXYlist\": // Лист калибровок AB\n [{\n \"x\": 1.0, // коэффициент X\n \"y\": 5.0 // коэффициент Y\n }]\n }, \n \"param2\":{ // Параметр №2 сенсора. Под примером доп.инфа.\n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{\n \"fromValue\": 1.0,\n \"a\": 1.0, \n \"b\": 1.0\n }], \n \"calibrationXYlist\":\n [{\n \"x\": 1.0,\n \"y\": 2.0\n }]\n }, \n \"formula\": \"EXPR\" // формула связки параметра 1 и параметра 2. Полный список возможных значений лежит в Dictionaries по ключу \"formula\". \n \"expression\": \"$param + ${Пробег} / 100\"// выражения формулы, это поле нужно только в случае formula=EXPR и имеет следующие синтаксисы 1) обращение к значениям любого параметра из сырых данных - #param333 (обращение к параметру param333)\n2) обращение к параметру текущего датчика - $param\nконстанты - 1000 (константа 1000)\n3) обращение к значению других датчиков ${Название датчика}\n4) арифметические операции - + * / ^(степень)\nскобки - ( или ) \n}\n\nОписание param1, param2 сенсора: Данные параметры являются опциональными и если пользователь их не заполнил, то передавать их вообще не надо. Перед сохранением param1 и param2 происходит пересчет их внутренних калибровочных листов (калибровкиAB и КалибровкиXY). Лист КалибровокAB и лист калибровокXY у конкретного параметра взаимосвязаны и порождают друг друга по определенным формулам, т.е. из листа калибровок XY можно вычислить лист калибровок AB и наоборот.
\nВ связи с этим РЕКОМЕНДУЕТСЯ перед тем, как сделать запрос, предварительно использовать метод POST /units/sensors/recalc для пересчета этих листов и передавать в calibrationABlist и calibrationXYlist результат работы этого метода.
\nПример ответа:
\n{\n \"id\": \"3c5b7072-abd5-4095-8be7-02d4b75751c0\",\n \"unit_id\": \"72154648-1f0d-4acc-a74d-81c7926e4483\",\n \"name\": \"Зажигание\",.\n \"typekey\": \"ignition\",\n \"param1\":{ \n \"param_key\": \"dut_485_1\",\n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 2.0, \"b\": 3.0 }], \n \"calibrationXYlist\": \n [{ \"x\": 1.0, \"y\": 5.0 }]\n }, \n \"param2\":{ \n \"param_key\": \"dut_485_2\", \n \"calibrationABlist\": \n [{ \"fromValue\": 1.0, \"a\": 1.0, \"b\": 1.0 }], \n \"calibrationXYlist\":\n [{ \"x\": 1.0, \"y\": 2.0 }]\n },\n \"formula\": \"S1\"\n }\n\nID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"1be6ba1c-a91a-44d1-b892-2e618c64d889"},{"name":"/units/sensors","id":"1ab2dbd6-e391-4ca2-b9ca-aac4a11bf975","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/units/sensors","description":"Отдельное создание датчика (без привязки к объекту)
\nАналогично POST /units/services
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units","sensors"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1ab2dbd6-e391-4ca2-b9ca-aac4a11bf975"},{"name":"/units/:id/files?url=:url","id":"b7505f8f-caa1-4905-a8ea-226ca56334ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units/files?url=/home/mih/photos/photos/359633107825189/2021_09/2021_09_08_06_52_50_0.jpg","description":"Получение файла объекта по URL
\nПараметры:
id - ID объекта
url - URL файла
Роль: Читатель и выше.
\n","urlObject":{"path":["api_v1","units","files"],"host":["{{base_url}}"],"query":[{"key":"url","value":"/home/mih/photos/photos/359633107825189/2021_09/2021_09_08_06_52_50_0.jpg"}],"variable":[]}},"response":[],"_postman_id":"b7505f8f-caa1-4905-a8ea-226ca56334ba"},{"name":"/units/sensors/recalc","id":"e6cca9ca-c162-4c2a-ae5b-a762aa3a6500","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"[\n {\n \"x\": 11,\n \"y\": 22\n },\n {\n \"x\": 33,\n \"y\": 5\n },\n {\n \"x\": 55,\n \"y\": 77\n },\n {\n \"x\": 1011,\n \"y\": 2022\n }\n]","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units/sensors/recalc","description":"Пересчет calibrationABlist или calibrationXYlist
\nМетод для пересчета calibrationABlist или calibrationXYlist. ДАННЫЕ НИГДЕ НЕ СОХРАНЯЮТСЯ. Метод изолированный, создан как вспомогательный.
В теле запроса передается массив, либо calibrationABlist, либо calibrationXYlist
Роль: Редактор и выше.
\nПример запроса с calibrationABlist:
\n\"[\n {'fromValue':5.0, 'a': 3.0, 'b': 12.0}, \n {'fromValue':1.0, 'a': 0.0, 'b': 1.0}, \n {'fromValue':38.0, 'a': 1.0, 'b': 0.0}\n]\"\n\nПример запроса с calibrationXYlist:
\n\"[\n {'x': 3.0, 'y': 12.0}, \n {'x': 0.0, 'y': 1.0}, \n {'x': 1.0, 'y': 0.0}\n]\"\n\nОтвет всегда одного типа:
\n \"{\n \"calibrationABlist\":\n [\n {\"fromValue\":1.0,\"a\":0.0,\"b\":1.0}, \n {\"fromValue\":5.0,\"a\":3.0,\"b\":12.0}, \n {\"fromValue\":38.0,\"a\":1.0,\"b\":0.0}\n ],\n \"calibrationXYlist\":\n [\n {\"x\":1.0,\"y\":1.0}, \n {\"x\":5.0,\"y\":27.0}, \n {\"x\":38.0,\"y\":38.0}\n ]\n }\"\n\nлибо, если ошибка, со статусом 422.
\n","urlObject":{"path":["api_v1","units","sensors","recalc"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e6cca9ca-c162-4c2a-ae5b-a762aa3a6500"},{"name":"/units/sensors/validate?terminal_type=Валидация списка датчиков
\nВ запросе отправляется массив датчиков .
terminal_type - ключ терминала объекта.
В ответе, если всё успешно, возвращается статус 200 с пустым телом. В случае ошибки возвращается соответствующий код ошибки и её описание.
Роль: Редактор и выше.
\nПример запроса:
\n[\n {\n \"name\": \"Sensor1\",\n \"type\": {\n \"key\": \"abs_motohours\",\n \"type\": \"sensor_type\",\n \"value\": \"Абсолютные моточасы\"\n },\n \"param1\": {\n \"param_key\": \"acc_x\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"param2\": {\n \"param_key\": \"\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"S1\",\n \"hide_in_reports\": false,\n \"invalid\": false\n }, {\n \"name\": \"Sensor2\",\n \"type\": {\n \"key\": \"abs_motohours\",\n \"type\": \"sensor_type\",\n \"value\": \"Абсолютные моточасы\"\n },\n \"param1\": {\n \"param_key\": \"acc_y\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"param2\": {\n \"param_key\": \"ewqeqwewqe\",\n \"smoothing\": 0.0,\n \"calibrationABlist\": [],\n \"calibrationXYlist\": []\n },\n \"formula\": \"EXPR\",\n \"expression\": \"$param1 + #fdsfdsf\",\n \"hide_in_reports\": false\n }\n]\n\nПолучение списка параметров датчика по каждой марке терминала
\nРоль: Читатель и выше.
\nОтвет:
\n\"[{\n \"navtelecom\":\"stamp, datepoint, imei_md5, latlon, bytes_out, bytes_in, speedkph, satellites, angle, altitude, pwr_ext, out_1_st\"\n },\n {\n \"mtstracker\":\"stamp, datepoint, imei_md5, latlon, bytes_out, bytes_in, speedkph, satellites, angle, mileage_cur, navi_sensor_st_rec, navi_sensor_st_valid, acc_x, acc_y, acc_z, acc_max_minus, \n\"}]\"\n\nМетод возвращает информацию о конкретной точке объекта (аннотация точки).
\nАннотация содержит в себе краткую информацию о точке:
datepoint - время данной точки.
speed - скорость в этой точке.
_marker_latlon - координата в формате [longitude, latitude].
<...далее идут все датчики юнита, со своими показаниями, пересчитанными по формуле. key - id датчика, name - имя...>
Параметр \"from\" опциональный. При его отсутствии будет возвращена последняя точка юнита.
\nПример запроса:
\n{ \n 'units': [ {'id': '9e86f2e9-3429-4674-945e-9519404451c0'} ], // берется только первый в массиве id, поэтому передавать несколько id не имеет смысла.\n 'from': '2020-01-06 13:26:42'\n}\n\nПример ответа:
\n{\n \"columns\": [\n {\n \"key\": \"datepoint\",\n \"name\": \"datepoint\",\n \"value\": \"2019-07-22 08:19:35\"\n },\n {\n \"key\": \"speed\",\n \"name\": \"speed\",\n \"value\": 0\n },\n {\n \"key\": \"_marker_latlon\",\n \"name\": \"_marker_latlon\",\n \"value\": [\n 63.534103,\n 53.1473\n ]\n },\n {\n \"key\": \"43eb314b-2eba-4f3f-aff8-2178a8d2431c\",\n \"name\": \"Топливо\",\n \"value\": 21505.1559\n },\n {\n \"key\": \"7bbd2122-7078-4b5e-91b1-a1cfc84480cd\",\n \"name\": \"Напряжение\",\n \"value\": 24.05\n },\n {\n \"key\": \"b4274fde-2f64-4144-9cfb-3a1223ba0ceb\",\n \"name\": \"Зажигание\",\n \"value\": 0.0\n }\n ]\n}\n\nПолучение объектов по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, возможные значения:
[\"name\", \"created\", \"type.key\", \"terminal_type.key\"]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - name (можно искать по неполному слову),
\"phonenumber\" - часть номера телефона,
\"imei\" - часть IMEI,
\"type.key\" - ключ тип объекта,
\"terminal_type.key\" - ключ тип терминала,
\"custom_fields\" - ,
\"sensors.name\" - название датчика,
\"sensors.param\" - параметр датчика,
\"sensors.type.key\" - ключ тип датчика,
\"events\" - события
Пример запроса:
\nПолучить первые 10 объектов, отсортированные по возрастанию по имени
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"name\",\n \"sortDesc\": \"false\",\n \"fields\": [\"name\", \"custom_fields.fuel_fillings_minfilling\", \"custom_fields.serial_number\"],\n \"conditions\": [\n {\n \"field\": \"name\",\n \"value\": \"НОДГП\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 150,\n \"list\": [\n {\n \"id\": \"55e41fea-614d-4103-9a82-887d15f76013\",\n \"name\": \"НОДГП-1 (НОДГП-1) Toyota Camry 110 АТ 03 Кокшетау\",\n \"services\": [],\n \"sensors\": [],\n \"custom_fields\": [\n {\n \"name\": \"Мин. объем заправки\",\n \"key\": \"fuel_fillings_minfilling\",\n \"value\": \"10\",\n \"group\": \"cf_fuel\",\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. время стоянки (сек)\",\n \"key\": \"tripdetector_minparktime\",\n \"value\": \"300\",\n \"group\": \"cf_trips\",\n \"sort\": 1,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Мин. скорость движ-я (км/ч)\",\n \"key\": \"tripdetector_minmovespeed\",\n \"value\": \"3\",\n \"group\": \"cf_trips\",\n \"sort\": 3,\n \"show_in_monitoring\": false\n },\n {\n \"name\": \"Серийный номер терминала\",\n \"key\": \"serial_number\",\n \"value\": \"265100022886\",\n \"group\": \"cf_etc\",\n \"sort\": 6,\n \"show_in_monitoring\": false\n }\n ]\n },\n ...\n ]\n}\n\nВалидация всех полей объекта
\nAPI для валидации всех полей объекта, без сохранения. При этом ошибка может быть в разных полях\\сущностях объекта.
Тело запроса, как при создании POST /units, и при обновлении PUT /units/:id
Роль: Читатель и выше.
\n","urlObject":{"path":["api_v1","units","validate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e38af77e-9d17-45be-9fe6-25e3c3ca2709"}],"id":"53900e41-6d7c-4916-8731-4dfb58ed963b","description":"API по работе с Объектами
\n","_postman_id":"53900e41-6d7c-4916-8731-4dfb58ed963b"},{"name":"Группы объектов","item":[{"name":"/unitsgroup?ids=:ids","id":"56cf5a8e-3b22-48bf-846b-5cef8309241f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/unitsgroup?ids=","description":"Получение групп объектов
\nПараметр 'ids' опциональный - в случае его отсутствия получим все группы по текущей активной компании.
\nЕсли в параметре ids указаны конкретные id групп (через запятую), то получим только их.
\nРоль: Читатель и выше.
\nПример ответа:
\n[ \n { \n \"id\":\"1a48c7d0-8ca7-4790-b001-7cc92075dabe\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testGroup\",\n \"units\":[ \n { \n \"id\":\"ccea7542-6016-4e77-b61b-31e957300de6\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testName-0\",\n \"type\":{ \n \"key\":\"farm_equipment\",\n \"type\":\"unit_type\",\n \"value\":\"Сельхозтехника\"\n },\n \"terminal_type\":{ \n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\":\"4690f00d-64a6-4326-95dd-acf64bbf02d9\",\n \"phonenumber\":\"8(914)3333333\",\n \"icon\":{ \n \"key\":\"school-bus_orange\",\n \"type\":\"unit_icon\",\n \"value\":\"иконка\"\n },\n \"services\":[ \n ],\n \"sensors\":[ \n ],\n \"custom_fields\":[ \n { \n \"key\":\"limit\",\n \"value\":\"123\"\n },\n { \n \"key\":\"power\",\n \"value\":\"123w\"\n }\n ]\n },\n { \n \"id\":\"df2415f9-7533-436e-9f93-78dbeacd8e29\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testName-1\",\n \"type\":{ \n \"key\":\"farm_equipment\",\n \"type\":\"unit_type\",\n \"value\":\"Сельхозтехника\"\n },\n \"terminal_type\":{ \n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\":\"225abdec-9f2d-4b98-89c7-a83993f97beb\",\n \"phonenumber\":\"8(914)3333333\",\n \"icon\":{ \n \"key\":\"school-bus_orange\",\n \"type\":\"unit_icon\",\n \"value\":\"иконка\"\n },\n \"services\":[ \n ],\n \"sensors\":[ \n ],\n \"custom_fields\":[ \n { \n \"key\":\"limit\",\n \"value\":\"123\"\n },\n { \n \"key\":\"power\",\n \"value\":\"123w\"\n }\n ]\n }\n ]\n }\n]\n\nСоздание группы
\nПараметры:
\n\"name\" - Имя группы. НЕ МОЖЕТ быть пустым или отсутствовать!
\"units\" - Массив существующих объектов, достаточно передать только id. Может быть пустым, либо вообще отсутствовать.
hide_in_lists, true если нужно \"Скрыть в списках\"
all_units_included, true если это группа Все объекты в которую автоматически попадают все создаваемые и копируемые объекты
\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"name\": \"testGroup\", // \n \"units\": [ // Массив существующих id объектов\n {\n \"id\": \"286e35d1-0d2e-481a-89b7-91755aabef54\"\n },\n {\n \"id\": \"abdb4866-1128-489d-8a2f-179533fd5971\"\n }\n ]\n}\n\nПример ответа:
\n{ \n \"id\":\"b6d098f8-dd71-48e0-b812-8460eadf7b2e\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testGroup\",\n \"units\":[ \n { \n \"id\":\"2ecbc434-c05c-4e8b-9905-ffa554fd18e0\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testName-0\",\n },\n { \n \"id\":\"8e42b82c-62bf-4678-b26e-b0636c9d7e66\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"testName-1\"\n }\n ],\n}\n\nПолучение списка групп
\nАналогично запросу POST /users/list
\nЗапрос:
\nВ fields указать нужные поля.
\nРоль: Редактор и выше.
\nОтвет:
\n\"id\"- Id группы
\n\"name\" - Имя группы.
\"units\" - Массив объектов в группе
\"users\" - Массив пользователей имеющий доступ в эту группу. Пустой, если группа не общедоступна внутри компании
Пример запроса:
\n{\"fields\":[\"id\",\"name\",\"units.id\",\"units.name\",\"users.id\",\"units.imei\"]}\n\nПример ответа:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"c6608022-7d69-4531-b8c5-190afc4aade1\",\n \"name\": \"Группа1\",\n \"units\": [\n {\n \"id\": \"b1c87520-e0b0-469f-baf7-4ec446679867\",\n \"name\": \"Ford Р024РХ790\",\n \"imei\": \"866854052110916\"\n },\n {\n \"id\": \"c5f41d3c-4388-47bc-b7d0-928415591218\",\n \"name\": \"МАЗ 606 TTA 03\",\n \"imei\": \"8628430418651631\"\n },\n {\n \"id\": \"cdac02c5-ac08-46bd-968d-91da19732784\",\n \"name\": \"IVECO 606 TВA 0323\",\n \"imei\": \"862843041865163\"\n }\n ],\n \"users\": [\n {\n \"id\": \"ec8dc446-f72e-4524-88be-2980c960706a\"\n },\n {\n \"id\": \"202cf740-d05d-4661-aaa9-c80e6a38c09a\"\n },\n {\n \"id\": \"c9bb3e9c-d02d-4ead-930b-2dd174da2f11\"\n }\n ]\n },\n {\n \"id\": \"3dfbed67-c6b1-4a2c-9781-db54f627bad8\",\n \"name\": \"Группа2\",\n \"units\": [\n {\n \"id\": \"8d09c650-d870-4677-9c22-a9977c347e49\",\n \"name\": \"С550ТК799 (#938)\",\n \"imei\": \"866854052154401\"\n },\n {\n \"id\": \"a9f4bd65-f56c-45ab-865f-9c36d04ce2c2\",\n \"name\": \"Ford Р024РХ790\",\n \"imei\": \"866854052110916\"\n },\n {\n \"id\": \"cfb99142-b07e-40ee-97f0-be19a99db46e\",\n \"name\": \"Кран Урал 676 STA 03\",\n \"imei\": \"860906049720870\"\n }\n ],\n \"users\": [\n {\n \"id\": \"7ddd3ef0-ea36-4000-997e-30a7954fc0bf\"\n },\n {\n \"id\": \"c69be66f-5bad-49cf-bdf6-53983eb9d234\"\n },\n {\n \"id\": \"28500618-ad5d-46d8-8f60-f3534d7af1d2\"\n }\n ]\n }\n ]\n}\n\nУдаление группы
\nГруппа удаляется физически.
\nРоль: Редактор и выше.
\nПример ответа:
\nпустая строка (при этом response status = 200)\n\nПланирование удаления группы объектов
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","unitsgroup"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"9ae0543d-2948-4335-916d-1a7187cf5db4"},{"name":"/unitsgroup","id":"bedd5cd5-54c6-4be5-ba2f-3e74db531691","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/unitsgroup","description":"Планирование удаления группы объектов
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","unitsgroup"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bedd5cd5-54c6-4be5-ba2f-3e74db531691"},{"name":"/unitsgroup/:unitsgroup_id ","id":"7bdb346f-157d-4887-b983-1a33131e1749","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"testGroup\",\n \"units\": [\n {\n \"id\": \"286e35d1-0d2e-481a-89b7-91755aabef54\"\n }\n ]\n}"},"url":"{{base_url}}/api_v1/unitsgroup/:unitsgroup_id","description":"Изменение группы
\nCписок units заменяется полностью.
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","unitsgroup",":unitsgroup_id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"unitsgroup_id"}]}},"response":[],"_postman_id":"7bdb346f-157d-4887-b983-1a33131e1749"}],"id":"05d84ab9-038c-4621-b852-56bda566853f","_postman_id":"05d84ab9-038c-4621-b852-56bda566853f","description":""},{"name":"Смены","item":[{"name":"/units_drivers","id":"733b1fad-eaf8-4f5f-882f-d685fa4a81c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"unit\" : {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\" : {\n \"id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\"\n}"},"url":"{{base_url}}/api_v1/units_drivers","description":"Создание смены
\nПараметры:
\n\"unit\": {\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"} указать ID объекта в unit.id, обязательно\n\"user\": {\"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"}, указать ID водителя(пользователя) в user.id, необязательно\n\"date_from\": \"2020-10-01 10:00:00\", дата и время от, обязательно\n\"date_to\": \"2020-11-01 18:00:00\", дата и время до, не обязательно\n\"custom_fields\": [ // пользовательские доп поля: // смотри GET /custom_fields\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синий\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n]\n\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"unit\" : {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\" : {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"custom_fields\": [\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n ]\n}\n\nПример ответа:
\nВозвращается созданная смена
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"custom_fields\": [\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n ]\n}\n\nСоздание нескольких смен
\nПараметры:
\n\"unit\": {\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"} указать ID объекта в unit.id, обязательно\n\"user\": {\"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"}, указать ID водителя(пользователя) в user.id, необязательно\n\"dates\" : [\n {\n \"date_from\": \"2021-02-01 18:00:00\",\n \"date_to\": \"2021-02-02 04:00:00\"\n },\n {\n \"date_from\": \"2021-02-03 18:00:00\",\n \"date_to\": \"2021-02-04 04:00:00\"\n },\n {\n \"date_from\": \"2021-02-10 18:00:00\",\n \"date_to\": \"2021-02-11 04:00:00\"\n }\n] // даты и время смены, date_from - начала, date_to - окончания\n\"custom_fields\": [ // пользовательские доп поля: // смотри GET /custom_fields\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n]\n\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"unit\" : {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\" : {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"dates\" : [\n {\n \"date_from\": \"2021-02-01 18:00:00\",\n \"date_to\": \"2021-02-02 04:00:00\"\n },\n {\n \"date_from\": \"2021-02-03 09:00:00\",\n \"date_to\": \"2021-02-03 18:00:00\"\n }\n ]\n \"custom_fields\": [\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n ]\n}\n\nПример ответа:
\nВозвращается созданные смены в виде массива - одна запись для каждой даты.
\n[\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2021-02-01 18:00:00\",\n \"date_to\": \"2021-02-02 04:00:00\",\n \"custom_fields\": [\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n ]\n},\n{\n \"id\": \"ed47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2021-02-03 09:00:00\",\n \"date_to\": \"2021-02-03 18:00:00\",\n \"custom_fields\": [\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n ]\n}\n]\n\nПоиск смен по ID (через запятую)
\nВозвращает массив смен.
Если параметр 'ids' пустой (т.е. запрос = 'GET /units_drivers', без параметра), то вернётся список всех связей всех компаний пользователя, из которого исключаются удаленные связи. Если ids не пустой (т.е. запрос = 'GET /units_drivers?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных связей.
Если в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная смена.
\nРоль: Читатель и выше.
\nПример запроса:
\n/units_drivers?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\nПример ответа:
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\"\n}\n\nОбновить данные смены
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /units_drivers
\nРоль: Редактор и выше.
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /units_drivers?ids=:id
\n","urlObject":{"path":["api_v1","units_drivers",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID смены
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"05faa359-ee58-4637-813e-70b5d36aaf6f"},{"name":"/units_drivers/:id","id":"23d31c61-f83e-4cad-bec7-f98b492462f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units_drivers/:id","description":"Удаление смены по ее id
\nПараметры:
\nid смены
\nРоль: Редактор и выше.
\nОтвет: 200
\nЕсли смена с таким id не найдена, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID смены
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"23d31c61-f83e-4cad-bec7-f98b492462f5"},{"name":"/units_drivers?ids=:ids","id":"82f99b7f-ca26-4a42-8a7f-c45d562e31a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units_drivers?ids=","description":"Планирование удаления связи объект-водитель
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units_drivers"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"82f99b7f-ca26-4a42-8a7f-c45d562e31a3"},{"name":"/units_drivers","id":"02b7fd84-84ee-4b25-90a7-88b032c2971b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_drivers","description":"Планирование удаления связи объект-водитель
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units_drivers"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"02b7fd84-84ee-4b25-90a7-88b032c2971b"},{"name":"/units_drivers/list","id":"73cb4862-116a-484c-9e73-e9001188be60","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_from\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_drivers/list","description":"Получить смены по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[date_from, date_to, created, is_delete]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - unit.id, user.id, date_from, date_to
Если использованы date_from, date_to тогда выбирается смены которые пересекаются с [date_from, date_to] интервалом.
Пример запроса:
\nПолучить первые 10 смен, отсортированные по возрастанию даты начала, связанные с объектом с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096 и в октябре 2020 года
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_from\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n {\n \"field\": \"date_from\",\n \"value\": \"2020-10-01 00:00:00\"\n },\n {\n \"field\": \"date_to\",\n \"value\": \"2020-11-01 00:00:00\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-09-05 10:00:00\",\n \"date_to\": \"2020-10-05 18:00:00\"\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-10-15 10:00:00\",\n \"date_to\": \"2020-11-21 18:00:00\"\n }\n ]\n}\n\nЕще один пример запроса:
\nПолучить первые 10 смен, отсортированные по возрастанию даты окончания по убыванию, связанные с водителем (пользователь) с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_to\",\n \"sortDesc\": \"true\",\n \"conditions\": [\n {\n \"field\": \"user.id\",\n \"value\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"f9c60641-0393-4345-aa2a-aadb869db3c9\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2021-01-01 10:00:00\"\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-11-01 10:00:00\",\n \"date_to\": \"2020-12-01 18:00:00\"\n },\n {\n \"id\": \"5acc2fd1-e63a-4c10-95d0-22eaf59439ae\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-09-01 10:00:00\",\n \"date_to\": \"2020-10-01 18:00:00\"\n }\n ]\n}\n\nAPI по работе со сменами
\n","_postman_id":"de9a1990-30f1-4d5d-9162-08dc313d2e21"},{"name":"Прицепы объектов","item":[{"name":"/units_trailers","id":"fc48b76d-7bc0-4463-9135-85444080ca7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"unit\" : {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\" : {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\"\n}"},"url":"{{base_url}}/api_v1/units_trailers","description":"Связать объект и прицеп на определенный период
\nПараметры:
\n\"unit\": {\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"} указать ID объекта в unit.id, обязательно\n\"trailer\": {\"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"}, указать ID прицепа в trailer.id, обязательно\n\"date_from\": \"2020-10-01 10:00:00\", дата и время от, обязательно\n\"date_to\": \"2020-11-01 18:00:00\", дата и время до, необязательно,\n\"min_speed\": 1.5, Мин. скорость в км/ч, необязательно,\n\"max_speed\": 10.5, Макс. скорость в км/ч, необязательно,\n\"work_type\": \"Обработка поля\" Тип работ, необязательно,\n\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"unit\" : {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\" : {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"min_speed\": 1.5,\n \"max_speed\": 10.5,\n \"work_type\": \"Обработка поля\"\n}\n\nПример ответа:
\nВозвращается созданная связь
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"min_speed\": 1.5,\n \"max_speed\": 10.5,\n \"work_type\": \"Обработка поля\"\n}\n\nПоиск связей по ID (через запятую)
\nВозвращает массив связей объектов и прицепов.
Если параметр 'ids' пустой (т.е. запрос = 'GET /units_trailers', без параметра), то вернётся список всех связей всех компаний пользователей, из которого исключаются удаленные связи. Если ids не пустой (т.е. запрос = 'GET /trailers?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных связей.
Если в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная связь.
\nРоль: Читатель и выше.
\nПример запроса:
\n/units_trailers?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\nПример ответа:
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\",\n \"min_speed\": 1.5,\n \"max_speed\": 10.5,\n \"work_type\": \"Обработка поля\"\n}\n\nОбновить данные связи
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /units_trailers
\nРоль: Редактор и выше.
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /units_trailers?ids=:id
\n","urlObject":{"path":["api_v1","units_trailers",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID связи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"55f8ee4c-fb91-4305-9385-501d7d9c0c0e"},{"name":"/units_trailers/:id","id":"27b512ee-711b-4e75-8cd7-96da577efaf5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units_trailers/:id","description":"Удаление связи по его ID
\nПараметры:
\nid связи
\nРоль: Редактор и выше.
\nОтвет:
\n200
\nЕсли связь с таким id не найдена, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID связи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"27b512ee-711b-4e75-8cd7-96da577efaf5"},{"name":"/units_trailers?ids=:ids","id":"268ec600-8b3f-4944-981b-dde3ce3502d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/units_trailers?ids=","description":"Планирование удаления связи прицепы-объекты
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units_trailers"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"268ec600-8b3f-4944-981b-dde3ce3502d8"},{"name":"/units_trailers","id":"378fed60-7406-4334-9cbf-a84f2878b456","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_trailers","description":"Планирование удаления связи прицепы-объекты
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units_trailers"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"378fed60-7406-4334-9cbf-a84f2878b456"},{"name":"/units_trailes/list","id":"dfbce730-7461-4a24-ab44-c4de8c64ab63","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 11,\n \"sortField\": \"date_from\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a097\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_trailers/list","description":"Получить связи объектов и прицепов по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[date_from, date_to, created, is_delete]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - unit.id, trailer.id
Пример запроса:
\nПолучить первые 10 связей, отсортированные по возрастанию даты начала, связанные с объектом с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_from\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\"\n },\n \"date_from\": \"2020-10-05 10:00:00\",\n \"date_to\": \"2020-11-05 18:00:00\"\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-11-01 10:00:00\",\n \"date_to\": \"2020-12-01 18:00:00\",\n \"min_speed\": 1.5,\n \"max_speed\": 10.5,\n \"work_type\": \"Обработка поля\"\n }\n ]\n}\n\nЕще один пример запроса:
\nПолучить первые 10 связей, отсортированные по возрастанию даты окончания, по убыванию, связанные с прицепом с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_to\",\n \"sortDesc\": \"true\",\n \"conditions\": [\n {\n \"field\": \"trailer.id\",\n \"value\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"f9c60641-0393-4345-aa2a-aadb869db3c9\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"trailer\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2021-01-01 10:00:00\"\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"trailer\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-11-01 10:00:00\",\n \"date_to\": \"2020-12-01 18:00:00\"\n },\n {\n \"id\": \"5acc2fd1-e63a-4c10-95d0-22eaf59439ae\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"trailer\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-09-01 10:00:00\",\n \"date_to\": \"2020-10-01 18:00:00\"\n }\n ]\n}\n\nAPI по работе со связью прицепов и объектов
\n","_postman_id":"f7fc0736-a5ea-458b-b2c8-b1317c045a7d"},{"name":"Состояния объекта","item":[{"name":"/units_states/:unit_id","id":"f6563bc6-1fa4-46dc-9696-8ea516eaa3db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/units_states/:unit_id","description":"Добавление нового состояния объекта
\nПараметр запроса unit_id - ID объекта
\nТело запроса JSON:
\nname - название состояния, обязательная строка.
\nfrom_date - дата состояния, обязательное в формате yyyy-MM-dd.
\nРоль: Редактор и выше.
\nПример запроса:
\nPOST /units_states/897c7708-6758-4da0-92f7-208d8caa2f07
\n{\n \"name\": \"Терминал Navtelecom\",\n \"date_from\": \"2022-10-09\"\n}\n\nПример ответа:
\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id
\n[\n {\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Navtelecom\",\n \"date_from\": \"2022-10-09\",\n \"state_unit\": {\n \"id\": \"897c7708-6758-4da0-92f7-208d8caa2f07\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n },\n {\n \"id\": \"57814be3-d38f-4540-b155-184204a0fe27\",\n \"name\": \"Начальное состояние\",\n \"date_from\": \"2020-12-09\",\n \"state_unit\": {\n \"id\": \"9d34e736-4565-4d1c-b83f-fab119b44e6f\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n }\n]\n\nID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"f6563bc6-1fa4-46dc-9696-8ea516eaa3db"},{"name":"/units_states/:id","id":"d6176aa6-e0be-45bc-9711-4ad099c30b77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Gelileo\",\n \"date_from\": \"2022-10-10\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_states/:id","description":"Обновление состояния объекта
\nПараметр запроса id - ID состояния
\nТело запроса JSON:
\nname - название состояния, обязательная строка.
\nfrom_date - дата состояния, обязательное в формате yyyy-MM-dd
\nРоль: Редактор и выше.
\nПример запроса:
\nPUT /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2
\n{\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Gelileo\",\n \"date_from\": \"2022-10-10\"\n}\n\nПример ответа:
\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id
\n[\n {\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Gelileo\",\n \"date_from\": \"2022-10-10\",\n \"state_unit\": {\n \"id\": \"04e234d4-1a35-402b-ad4b-16d0969e389e\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n },\n {\n \"id\": \"57814be3-d38f-4540-b155-184204a0fe27\",\n \"name\": \"Начальное состояние\",\n \"date_from\": \"2020-12-09\",\n \"state_unit\": {\n \"id\": \"9d34e736-4565-4d1c-b83f-fab119b44e6f\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n }\n]\n\nID состояния
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"d6176aa6-e0be-45bc-9711-4ad099c30b77"},{"name":"/units_states/:id/copy","id":"5b6db0b6-4d5b-4eb9-a71d-dade9f665e4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_states/:id/copy","description":"Копирование состояния объекта
\nПараметр запроса id - ID состояния
\nБез тела запроса.
\nРоль: Редактор и выше.
\nПример запроса:
\nPOST /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2/copy
\nПример ответа:
\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id
\n[\n {\n \"id\": \"5ec2659e-b05d-4907-9d6c-2ae595e361f0\",\n \"name\": \"Копия: Начальное состояние\",\n \"date_from\": \"2024-01-18\",\n \"state_unit\": {\n \"id\": \"04e234d4-1a35-402b-ad4b-16d0969e389e\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n },\n {\n \"id\": \"57814be3-d38f-4540-b155-184204a0fe27\",\n \"name\": \"Начальное состояние\",\n \"date_from\": \"2020-12-09\",\n \"state_unit\": {\n \"id\": \"0efe7ee0-4748-4f9c-a1b6-0d7c70afa628\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n }\n]\n\nID состояния
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"5b6db0b6-4d5b-4eb9-a71d-dade9f665e4b"},{"name":"/units_states/:id","id":"1357ac6f-048e-4b11-ae00-11fdf94a8a35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Gelileo\",\n \"date_from\": \"2022-10-10\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_states/:id","description":"Удаление состояния объекта
\nПараметр запроса id - ID состояния
\nПример запроса:
\nDELETE /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2
\nРоль: Редактор и выше.
\nПример ответа:
\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id
\n[\n {\n \"id\": \"57814be3-d38f-4540-b155-184204a0fe27\",\n \"name\": \"Начальное состояние\",\n \"date_from\": \"2020-12-09\",\n \"state_unit\": {\n \"id\": \"9d34e736-4565-4d1c-b83f-fab119b44e6f\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n }\n]\n\nID состояния
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"1357ac6f-048e-4b11-ae00-11fdf94a8a35"},{"name":"/units_states/:unit_id","id":"15bc39a8-0654-4f5d-9423-5d744340cecf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units_states/:unit_id","description":"Получение состояний объекта
\nПараметр запроса unit_id - ID объекта
\nЗапрос без тела
\nПример запроса:
\nGET /units_states/897c7708-6758-4da0-92f7-208d8caa2f07
\nПример ответа:
\nВ ответ приходят все состояния объекта в порядке убывания даты (date_from).
\nПоля:
\nid - ID состояния.
\nname - имя состояния.
\ndate_from - дата состояния.
\nstate_unit - Короткая информация об объекте в этом состоянии, имеет следующие поля:
\nid - объекта. При нажатии на редактирование необходимо открыть объект по этому ID.
\nterminal_type - тип терминала
\nimei - IMEI
\n[\n {\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Navtelecom\",\n \"date_from\": \"2022-10-09\",\n \"state_unit\": {\n \"id\": \"897c7708-6758-4da0-92f7-208d8caa2f07\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n },\n {\n \"id\": \"57814be3-d38f-4540-b155-184204a0fe27\",\n \"name\": \"Начальное состояние\",\n \"date_from\": \"2020-12-09\",\n \"state_unit\": {\n \"id\": \"9d34e736-4565-4d1c-b83f-fab119b44e6f\",\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"imei\": \"862273040906299\"\n }\n }\n]\n\nID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"unit_id"}]}},"response":[],"_postman_id":"15bc39a8-0654-4f5d-9423-5d744340cecf"},{"name":"/units_states_count","id":"3a53fde0-a906-4542-8372-4fb799faacd7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": \"2022-10-10 00:00:00\",\n \"to\": \"2024-11-10 00:00:00\",\n \"groups\": [\n {\"id\": \"6c39623d-9d91-45c6-8754-aba1de05ea5e\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_states_count","description":"Получение количества состояний объектов в группе на интервале
\nТела запроса JSON:
\nfrom - дата и время начала интервала.
\nto - дата и время окончания интервала.
\ngroups - группа объектов.
\nПример запроса:
\n{\n \"from\": \"2022-10-10 00:00:00\",\n \"to\": \"2024-11-10 00:00:00\",\n \"groups\": [\n {\"id\": \"6c39623d-9d91-45c6-8754-aba1de05ea5e\"}\n ]\n}\n\nПример ответа:
\nВозвращается JSON массив в формате элементов :<количество состояний>
\n[\n {\n \"216ee2cf-38d8-4ecc-a08f-c111a61ddf61\": 4\n },\n {\n \"20470514-e2b9-49b9-9470-e2a34cf8c1b4\": 1\n }\n]\n\nАрхив состояний объекта
\n","_postman_id":"a7d4a26b-4249-4ed3-8f5b-07cacc64fc48"},{"name":"Прицепы","item":[{"name":"/trailers","id":"8ba2dcfd-6db6-4397-b46f-ba54f68a7716","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"code\": \"XYZ111222333\",\n \"name\": \"Прецеп2\",\n \"description\": \"Описания прецепа2\",\n \"custom_fields\": [\n {\n \"name\": \"масса\",\n \"key\": \"масса\",\n \"value\": \"20 т\"\n },\n {\n \"name\": \"цвет\",\n \"key\": \"цвет\",\n \"value\": \"синый\"\n }\n ]\n}"},"url":"{{base_url}}/api_v1/trailers","description":"Создание прицепа
\nПараметры:
\n\"name\": строка, номер, наименование прецепа,\n\"code\": строка, уникальный код прицепа\n\"description\": строка, описания прицепа\n\"width\": число, ширина прицепа\n\"custom_fields\": [ // пользовательские доп поля: // смотри GET /custom_fields\n {\"name\": \"цвет\", 'key': 'цвет', \"value\": \"синый\"},\n {\"name\": \"масса\", \"key\": \"масса\", \"value\": \"20 т\"}\n\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"code\": \"XYZ111222333\",\n \"name\": \"Прецеп1\",\n \"description\": \"Описания прецепа1\",\n \"width\": 2.5,\n \"custom_fields\": [\n {\n \"name\": \"масса\",\n \"key\": \"масса\",\n \"value\": \"20 т\"\n },\n {\n \"name\": \"цвет\",\n \"key\": \"цвет\",\n \"value\": \"синый\"\n }\n ]\n}\n\nПример ответа:
\nВозвращается созданный прицеп
\n{\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"Прецеп1\",\n \"code\": \"XYZ111222333\",\n \"description\": \"Описания прецепа1\",\n \"width\": 2.5,\n \"custom_fields\": [\n {\n \"name\": \"масса\",\n \"key\": \"масса\",\n \"value\": \"20 т\",\n \"group\": \"custom\"\n },\n {\n \"name\": \"цвет\",\n \"key\": \"цвет\",\n \"value\": \"синый\",\n \"group\": \"custom\"\n }\n ]\n}\n\nПоиск прицепов по ID (через запятую)
\nВозвращает массив прицепов.
Если параметр 'ids' пустой (т.е. запрос = 'GET /trailers', без параметра), то вернётся список всех прицепов по всем компаниям пользователя, из которого исключаются удаленные прицепы.
Если ids не пустой (т.е. запрос = 'GET /trailers?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных прицепов.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный прицеп.
\nРоль: Читатель и выше.
\nПример запроса:
\n/trailers?ids=7c4253d5-4bc6-4885-bf25-985a75919fb4&\n\nПример ответа:
\n{\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"Прецеп1\",\n \"code\": \"XYZ111222333\",\n \"description\": \"Описания прецепа1\",\n \"width\": 2.5,\n \"custom_fields\": [\n {\n \"name\": \"масса\",\n \"key\": \"масса\",\n \"value\": \"20 т\",\n \"group\": \"custom\"\n },\n {\n \"name\": \"цвет\",\n \"key\": \"цвет\",\n \"value\": \"синый\",\n \"group\": \"custom\"\n }\n ]\n}\n\nОбновление данных прицепа
\nОбновляет переданные параметры
\nРоль: Редактор и выше.
\nПараметры:
\nсм метод POST /trailers
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /trailers?ids=:trailer_id
\n","urlObject":{"path":["api_v1","trailers",":trailer_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID прицепа
\n","type":"text/plain"},"type":"any","value":"","key":"trailer_id"}]}},"response":[],"_postman_id":"3dd87c86-a445-4661-a9e2-aa03a75b48dd"},{"name":"/trailers/:trailer_id","id":"39e382b8-f19d-4105-8172-eafdfcac585b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/trailers/:trailer_id","description":"Удаление прицепа по его id
\nПараметры:
\nid прицепа
\nРоль: Редактор и выше.
\nОтвет: 200
\nЕсли прицеп с таким id не найден возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID прицепа
\n","type":"text/plain"},"type":"any","value":"","key":"trailer_id"}]}},"response":[],"_postman_id":"39e382b8-f19d-4105-8172-eafdfcac585b"},{"name":"/trailers?ids=:ids","id":"acf28abc-79d8-437b-abd8-eeea8b78e3c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/trailers?ids=","description":"Планирование удаления прицепов
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","trailers"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"acf28abc-79d8-437b-abd8-eeea8b78e3c1"},{"name":"/trailers","id":"44462c72-b47e-40bf-a3be-0bcc42d61410","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/trailers","description":"Планирование удаления прицепов
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","trailers"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"44462c72-b47e-40bf-a3be-0bcc42d61410"},{"name":"/trailes/list","id":"885d3b2c-b5ff-422c-ba06-bd84f24326cb","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"name\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"name\",\n \"value\": \"Прецеп1 новая названия\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/trailers/list","description":"Получить прицепы по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[name, created, is_delete]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - name (можно искать по неполному слову), code, description
Роль: Читатель и выше.
\nПример запроса:
\nПолучить первые 10 прицепов, отсортированные по возрастанию, по имени, которые имеют ID прицепа 7e1aaba2-625a-4a4c-b765-9934bec5a096
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"name\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"name\",\n \"value\": \"Прицеп1 новое название\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 1,\n \"list\": [\n {\n \"id\": \"7c4253d5-4bc6-4885-bf25-985a75919fb4\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"Прицеп1 новое название\",\n \"code\": \"XYZ111222333\",\n \"description\": \"новое описание прецепа1\",\n \"width\": 2.5,\n \"custom_fields\": [\n {\n \"name\": \"масса\",\n \"key\": \"масса\",\n \"value\": \"19 т\",\n \"group\": \"custom\"\n },\n {\n \"name\": \"цвет\",\n \"key\": \"цвет\",\n \"value\": \"красный\",\n \"group\": \"custom\"\n },\n {\n \"name\": \"123\",\n \"key\": \"123\",\n \"value\": \"456\",\n \"group\": \"custom\"\n }\n ]\n }\n ]\n}\n\nAPI по работе с Прицепами
\n","_postman_id":"3a6d58b8-f270-4a6d-89f8-f53f7e6760fe"},{"name":"События","item":[{"name":"/events","id":"0d7c13ee-9a8d-4639-93fc-b2aa385be05c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"unit\" : {\n \"id\": \"58acca5a-1f17-4418-9143-3e4c8a320f3a\"\n },\n \"datetime\": \"2020-01-02 12:30:00\",\n \"type\": {\"key\": \"filling\"},\n \"deviation_minutes\": 20,\n \"filled\": 101.5\n}"},"url":"{{base_url}}/api_v1/events","description":"Создание события для объекта
\nПараметры:
\n\"unit\": {\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"} указать ID объекта в unit.id, обязательно\n\"type\": {\"key\": \"filling\"} // ключ типа события. Список типов может быть получен по запросу GET /dictionaries. Необходимо выбрать те записи у которых type=event_type, возможные значения: filling, theft, accident, service, waybill, random\nlatitude: Координата широты на карте. Вещественное значение\nlongitude: Координата долготы на карте. Вещественное значение\n latitude и longitude должны выбираться на стороне клиента для всех типов события, кроме \"путевые листы\" при смене даты с помощью метода POST /point. \nОстальные поля зависят от типа события\n1) Заправка - type.key=filling\n\"datetime\": \"2020-01-01 12:30:00\", обязательное, дата и время события\n\"deviation_minutes\": 100, Отклонение, мин.: (обязательное) - числовое поле от 0 до 1000\n\"filled\": 30.5 - Заправлено топлива, л: (обязательное) - числовое поле больше 0\n\"price\": 3050.7 - Стоимость (необязательное): - числовое поле от 0.\n\"description\": \"some details\", Описание: (необязательное) - текстовое поле\n2) Слив - type.key=theft\n\"datetime\": \"2020-01-01 12:30:00\", Дата время; (Как и в Заправках)\n\"deviation_minutes\": 100, Отклонение, мин.; (Как и в Заправках)\n\"stolen\": 20.8, Слито топлива, л; (Как “Заправлено топлива” и в Заправках)\n\"description\": \"some details\", Описание: (Как и в Заправках)\n3) ДТП - type.key=accident\n\"datetime\": \"2020-01-01 12:30:00\", Дата время; (Как и в Заправках)\n\"deviation_minutes\": 100, Отклонение, мин.; (Как и в Заправках)\n\"description\": \"some details\", Описание: (Как и в Заправках)\n4) Тех. обслуживание - type.key=service\n\"datetime\": \"2020-01-01 12:30:00\", Дата время; (Как и в Заправках)\n\"deviation_minutes\": 100, Отклонение, мин.; (Как и в Заправках)\n\"service_name\": \"Установка ДУТ\", Название сервиса\n\"motohours\": 2345.5, Моточасы, ч: (необязательное) - числовое поле\n\"millage\": 23453.5, Пробег, км: (необязательное) - числовое поле. \n\"duration_hours\": 3.5, Длительность, ч: (необязательное) - числовое поле. \n\"price\": 3000.4, Стоимость: (Как и в Заправках)\n\"guaranteed\": true, Гарантийный(обязательный): true/false.\n\"description\": \"some details\", Описание: (Как и в Заправках)\nПри создании события ТО вызывается метод POST /point для получения координаты. \nОн также возвращает показания датчиков.\nПолучить моточасы из записи, где group=\"sensors\" и type=\"abs_motohours\". \nА для пробега group=\"sensors\" и type=\"mileage\". \n5) Путевой лист - type.key=waybill\n\"start_date\": \"2020-01-03 12:30:00\", Начало: дата и времемя (обязательное)\n\"finish_date\": \"2020-01-05 18:00:00\", Окончание: дата и времемя (обязательное)\n\"user_id\": ID Водителя, (необязатльное) - выбор из списка Пользователей с отметкой водитель\n\"motohours\": 2345.5, Моточасы, ч: (необязательное) - числовое поле\n\"millage\": 23453.5, Пробег, км: (необязательное) - числовое поле.\n\"filled\": 30.5 - Заправлено топлива, л: (необязательное)\n6)Статус ТС - type.key=vehicle_status\n\"datetime\": \"2020-01-01 12:30:00\", Дата время; (Как и в Заправках)\n\"type_name\": \"В гараже\", Тип события (обязательное) текстовое поле\n\"description\": \"some details\", Описание: (Как и в Заправках\n7)Произвольное событие - type.key=random\n\"datetime\": \"2020-01-01 12:30:00\", Дата время; (Как и в Заправках)\n\"deviation_minutes\": 100, Отклонение, мин.; (Как и в Заправках)\n\"type_name\": \"Повышение скорости\", Тип события (обязательное) текстовое поле\n\"description\": \"some details\", Описание: (Как и в Заправках)\n\nРоль: Оператор и выше.
\nПример запроса:
\n{\n\"unit\" : {\n\"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n},\n\"datetime\": \"2020-01-02 12:30:00\",\n\"type\": {\"key\": \"filling\"},\n\"deviation_minutes\": 20,\n\"filled\": 101.5,\n\"price\": \"3532.7\",\n\"description\": \"som details\",\n\"latitude\": 53.343243,\n\"longitude\": 33.56432\n}\n\nПример ответа:
\nВозвращается созданное событие
\n{\n\"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n\"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n\"datetime\": \"2020-01-02 12:30:00\",\n\"type\": {\"key\": \"filling\"},\n\"deviation_minutes\": 20,\n\"filled\": 101.5,\n\"price\": \"3532.7\",\n\"description\": \"som details\",\n\"latitude\": 53.343243,\n\"longitude\": 33.56432\n}\n\nК событиям можно добавлять фотографии. Максимальное количество 10 шт. Максимальный размер одной фотографии 10 мб.
\nПеред отправкой события, фотографии должны быть загружены на сервер.
Загрузить фотографии нужно иcпользуя POST {{base_url}}/upload_photos/events.
В этот запрос нужно положить одно фото в поле file.
\nЗапрос должен быть в формате multipart/form-data
\nПример ответа:
\nВозвращается два поля в JSON small и original.
\n{\n \"small\": {\n \"url\": \"/photos/events/fa3357f6-7ff5-4f4a-9840-99eaf3bf1de5_300.png\",\n \"width\": 251,\n \"height\": 300,\n \"param_type\": \"events\"\n },\n \"original\": {\n \"url\": \"/photos/events/fa3357f6-7ff5-4f4a-9840-99eaf3bf1de5_original.png\",\n \"width\": 628,\n \"height\": 749,\n \"param_type\": \"events\"\n }\n}\n\nsmall - для загрузки изображения в списке.
\noriginal - для открытия оригинального фото с большим размером.
\nЗапросить нужное фото можно через роут {{base_url}}://api_v1/{url}.
Все добавленные фотографии необходимо отправлять в поле photos при создании и обновлении события.
Пример запроса:
POST /api_v1/events
{\n \"unit\": {\n \"id\": \"2bd74bab-8173-4c06-8fd8-ad923d3ad7d3\"\n },\n \"type\": {\n \"key\": \"accident\"\n },\n \"datetime\": \"2024-03-19 09:57:58\",\n \"deviation_minutes\": 10,\n \"description\": \"DPT\",\n \"latitude\": 55.6558837890625,\n \"longitude\": 37.83785629272461,\n \"photos\": [\n {\n \"small\": {\n \"url\": \"/photos/events/5e65cfe3-31e3-4bee-83ea-b7bf23ad6bd6_300.jpeg\",\n \"width\": 300,\n \"height\": 200,\n \"param_type\": \"events\"\n },\n \"original\": {\n \"url\": \"/photos/events/5e65cfe3-31e3-4bee-83ea-b7bf23ad6bd6_original.jpeg\",\n \"width\": 5184,\n \"height\": 3456,\n \"param_type\": \"events\"\n }\n },\n {\n \"small\": {\n \"url\": \"/photos/events/fa3357f6-7ff5-4f4a-9840-99eaf3bf1de5_300.png\",\n \"width\": 251,\n \"height\": 300,\n \"param_type\": \"events\"\n },\n \"original\": {\n \"url\": \"/photos/events/fa3357f6-7ff5-4f4a-9840-99eaf3bf1de5_original.png\",\n \"width\": 628,\n \"height\": 749,\n \"param_type\": \"events\"\n }\n }\n ]\n}\n\nПараметры:
\nТело запроса должно содержать массив объектов событий.
Общие поля (для каждого объекта в массиве):
\"unit\": {\"id\": \"UUID\"} — (обязательное) ID объекта, для которого создается событие.
\n\"type\": {\"key\": \"string\"} — (обязательное) Ключ типа события. Возможные значения: filling, theft, accident, service, waybill, vehicle_status, random.
\nlatitude: Координата широты на карте. Вещественное значение.
\nlongitude: Координата долготы на карте. Вещественное значение.
\nОстальные поля зависят от типа события (для каждого объекта в массиве):
\n1) Заправка — type.key=filling
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное) — дата и время события.
\n\"deviation_minutes\": 100 (обязательное) — Отклонение, мин. Числовое поле от 0 до 1000.
\n\"filled\": 30.5 (обязательное) — Заправлено топлива, л. Числовое поле больше 0.
\n\"price\": 3050.7 (необязательное) — Стоимость. Числовое поле от 0.
\n\"description\": \"some details\" (необязательное) — Описание. Текстовое поле.
\n2) Слив — type.key=theft
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное).
\n\"deviation_minutes\": 100 (обязательное).
\n\"stolen\": 20.8 (обязательное) — Слито топлива, л.
\n\"description\": \"some details\" (необязательное).
\n3) ДТП — type.key=accident
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное).
\n\"deviation_minutes\": 100 (обязательное).
\n\"description\": \"some details\" (необязательное).
\n4) Тех. обслуживание — type.key=service
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное).
\n\"deviation_minutes\": 100 (обязательное).
\n\"service_name\": \"Установка ДУТ\" (обязательное) — Название сервиса.
\n\"motohours\": 2345.5 (необязательное) — Моточасы, ч.
\n\"millage\": 23453.5 (необязательное) — Пробег, км.
\n\"duration_hours\": 3.5 (необязательное) — Длительность, ч.
\n\"price\": 3000.4 (необязательное) — Стоимость.
\n\"guaranteed\": true (обязательное) — Гарантийный: true/false.
\n\"description\": \"some details\" (необязательное).
\n5) Путевой лист — type.key=waybill
\n\"start_date\": \"2020-01-03 12:30:00\" (обязательное) — Начало: дата и время.
\n\"finish_date\": \"2020-01-05 18:00:00\" (обязательное) — Окончание: дата и время.
\n\"user_id\": ID Водителя (необязательное).
\n\"motohours\": 2345.5 (необязательное).
\n\"millage\": 23453.5 (необязательное).
\n\"filled\": 30.5 (необязательное).
\n6) Статус ТС — type.key=vehicle_status
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное).
\n\"type_name\": \"В гараже\" (обязательное) — Тип события, текстовое поле.
\n\"description\": \"some details\" (необязательное).
\n7) Произвольное событие — type.key=random
\n\"datetime\": \"2020-01-01 12:30:00\" (обязательное).
\n\"deviation_minutes\": 100 (обязательное).
\n\"type_name\": \"Повышение скорости\" (обязательное) — Тип события, текстовое поле.
\n\"description\": \"some details\" (необязательное).
\nРоль: Оператор и выше.
\nВажно:
Операция выполняется в одной транзакции. Если хотя бы одно событие в
списке не пройдет валидацию (или у пользователя нет доступа к указанному
объекту), ни одно событие не будет создано.
Пример запроса:
\n[\n {\n \"unit\": {\n \"id\": \"7547dfbc-4e2f-46a2-9f24-8e61a5cc646c\"\n },\n \"type\": {\n \"key\": \"filling\"\n },\n \"datetime\": \"2026-01-15 15:18:10\",\n \"deviation_minutes\": 23,\n \"filled\": 232,\n \"price\": 23,\n \"description\": \"Заправка на трассе\",\n \"latitude\": 53.13996,\n \"longitude\": 26.06976\n },\n {\n \"unit\": {\n \"id\": \"f449dd65-412f-4e79-83a8-838d8f5dcab7\"\n },\n \"type\": {\n \"key\": \"accident\"\n },\n \"datetime\": \"2026-01-15 15:20:10\",\n \"deviation_minutes\": 32,\n \"description\": \"ДТП\",\n \"latitude\": 53.95149,\n \"longitude\": 27.70800\n }\n]\n\nПример ответа:
\nВозвращается массив созданных событий.
\n[\n {\n \"id\": \"49bac727-0d5b-4e18-b71b-155437fe17a6\",\n \"company_id\": \"5ed16b37-23a4-4f03-806e-5e175f08c9a9\",\n \"unit\": {\n \"id\": \"7547dfbc-4e2f-46a2-9f24-8e61a5cc646c\",\n \"name\": \"unit name\"\n },\n \"type\": {\n \"key\": \"filling\",\n \"type\": null,\n \"value\": null\n },\n \"datetime\": \"2026-01-15 18:47:43\",\n \"deviation_minutes\": 123,\n \"filled\": 123.0,\n \"price\": 123.0,\n \"description\": \"123\",\n \"latitude\": 41.120174407958984,\n \"longitude\": 44.842220306396484,\n \"photos\": []\n },\n ...\n]\n\nРабота с фотографиями:
\nК событиям в массовом запросе также можно добавлять фотографии. Логика аналогична методу /create.
\nФотографии загружаются заранее через POST {{base_url}}/upload_photos/events.
\nПолученный JSON с small и original добавляется в массив photos нужного объекта события внутри общего списка.
\nПример части запроса с фото:
\n[\n {\n \"unit\": { \"id\": \"...\" },\n \"type\": { \"key\": \"filling\" },\n ...\n \"photos\": [\n {\n \"small\": {\n \"url\": \"/photos/events/fa3357f6..._300.png\",\n \"width\": 251,\n \"height\": 300,\n \"param_type\": \"events\"\n },\n \"original\": {\n \"url\": \"/photos/events/fa3357f6..._original.png\",\n \"width\": 628,\n \"height\": 749,\n \"param_type\": \"events\"\n }\n }\n ]\n },\n {\n \"unit\": { \"id\": \"...\" },\n ...\n }\n]\n\nПоиск событий по ID (через запятую)
\nВозвращает массив событий.
Если параметр 'ids' пустой (т.е. запрос = 'GET /events', без параметра), то вернётся список всех событий всех компаний пользователя, из которого исключаются удаленные связи. Если ids не пустой (т.е. запрос = 'GET /events?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных событий.
Если в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретное собитие.
\nПример запроса:
\n/events?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\nПример ответа:
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"datetime\": \"2020-01-02 12:30:00\",\n \"type\": {\"key\": \"filling\"},\n \"deviation_minutes\": 20,\n \"filled\": 101.5,\n \"price\": \"3532.7\",\n \"description\": \"som details\",\n \"latitude\": 53.343243,\n \"longitude\": 33.56432\n}\n\nОбновление данных события
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /events
\nРоль: Оператор и выше.
\nОтвет:
\nАналогичен одному событию из ответа метода GET /events?ids=:id
\n","urlObject":{"path":["api_v1","events",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID события
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"56bb4b56-b77f-4013-8e7c-a873d27e1e6e"},{"name":"/events/:id","id":"09f5c20b-4039-4b5c-b104-31aec253a4c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/events/:id","description":"Удаление события по его id
\nПараметры:
\nid события
\nРоль: Оператор и выше.
\nОтвет: 200
\nЕсли событие с таким id не найдено, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID события
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"09f5c20b-4039-4b5c-b104-31aec253a4c1"},{"name":"/events?ids=:ids","id":"ed1e6cee-aeff-477a-8004-35f45c2370dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/events?ids=","description":"Планирование удаления события
\nсм. DELETE /units?ids=:ids
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","events"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"ed1e6cee-aeff-477a-8004-35f45c2370dd"},{"name":"/events","id":"b94fd795-0755-456a-aebc-513b3438e90d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/events","description":"Планирование удаления события
\nсм. DELETE /units
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","events"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b94fd795-0755-456a-aebc-513b3438e90d"},{"name":"/events/list","id":"fd8ab6f1-036e-47f5-8541-ea5d4a274a4b","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"58acca5a-1f17-4418-9143-3e4c8a320f3a\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/events/list","description":"Получить события по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[type.key, unit.id]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - unit.id, type.key
Пример запроса:
\nПолучить первые 10 событий от 2020-01-01 00:00:00 до 2020-01-10 00:00:00, отсортированные по возрастанию type.key, для объекта с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"type.key\",\n \"sortDesc\": \"false\",\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n {\n \"field\": \"date_from\",\n \"value\": \"2020-01-01 00:00:00\"\n },\n {\n \"field\": \"date_to\",\n \"value\": \"2020-01-10 00:00:00\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"type\": {\n \"key\": \"filling\"\n },\n \"datetime\": \"2020-01-02 12:30:00\",\n \"deviation_minutes\": 20,\n \"filled\": 102.5\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"type\": {\n \"key\": \"filling\"\n },\n \"datetime\": \"2020-01-03 14:10:00\",\n \"deviation_minutes\": 20,\n \"filled\": 101.5\n }\n ]\n}\n\nПолучение всех названий ТО при создании события
\nВоозврашает Осмотр, Замена терминала, Установка ДУТ, Замена ДУТ, Калибровка ДУТ и новые введенные сервисы внутри компании
\nПример ответа:
\n[\n \"Осмотр\",\n \"Замена терминала\",\n \"Установка ДУТ\",\n \"Замена ДУТ\",\n \"Калибровка ДУТ\",\n \"21\",\n \"Terminal replacement\",\n \"Замена ремня ГРМ\",\n \"Новый сервмс\",\n \"Пищевая заправка\",\n \"Предыдущий сервис\",\n]\n\nAPI по работе с событиями
\n","_postman_id":"2d654a7c-7f01-4f05-a466-3c9b3f15af12"},{"name":"Мониторинг","item":[{"name":"/messages","id":"29c9d8d4-e44d-4648-9ee8-001853e3d007","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"wss://{{base_url}}/messages","description":"Получение аннотаций по объектам компании
\nИспользуется один вебсокет для получения следующих данных:
\nПоследнего сообщения от объекта.
\nУведомлений за последние сутки.
\nНовых уведомлений.
\nИзменения справочников.
\nЕсли сервер использует протокол HTTP, то вебсокет должен работать по протоколу WS. Аналогично, если сервер использует HTTPS, то вебсокет должен работать по протоколу WSS.
\nМожно также передать параметр ?from_time=1628259485000, где значение — это метка времени в формате Unix (в часовом поясе пользователя). Это нужно, если вы хотите получить данные, начиная с определённого момента времени. Например, если у вас уже есть закэшированные данные на клиенте, и вы хотите получить только новые сообщения, начиная с этого времени.
Формат получения изменений справочников имеет следующий вид:
\n{\n \"notify\": {\n \"time\": \"2020-10-16 17:03:16\", //время изменений\n \"objects\": \"units\", //изменяемая сущность - \"users\", \"units\", \"notifications\" и т.д.\n \"operation\": \"PUT\", // операция изменения - PUT,POST,DELETE,PATCH\n \"id\": \"9eb8b795-dfb0-46e7-a35d-0fc43512ba66\", //id изменяемой сущности\n \"msg\": \"Пользователь Mih обновил объект\" //сообщение \n }\n}\n\nПоследнее сообщение от объекта
Приходит массив, каждый элемент которого содержит информацию об одном объекте.
unit_id - ID объекта
unit_name - Имя объекта
company_id - ID компании
В поле columns приходит информация со следующими текстовыми полями:
key - уникальный ключ
name - Имя поля
value - Значение поля
group -Группа, с помощью этого поля вы можете группировать данные при показе.
Возможные значения:
main - Основные данные
gps - GPS данные
sensors - Значения датчиков
custom_fields - Допольнительные поля объекта
hidden - Скрытые поля
name и value отображается для пользователя.
\n[{\n \"unit_id\": \"a66563fd-8d3c-4de3-b8bb-25537f682dc7\",\n \"unit_name\": \"JCB 5637НТ 77\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"columns\": [{\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"JCB 5637НТ 77\",\n \"group\": \"main\"\n }, {\n \"key\": \"datepoint\",\n \"name\": \"Был на связи\",\n \"value\": \"2022-01-14 13:16:34\",\n \"group\": \"main\"\n }, {\n \"key\": \"_datepoint\",\n \"name\": \"_datepoint\",\n \"value\": \"2022-01-14 13:16:34\",\n \"group\": \"hidden\"\n }, {\n \"key\": \"speed\",\n \"name\": \"Скорость\",\n \"value\": 0,\n \"group\": \"gps\"\n }, {\n \"key\": \"satellites\",\n \"name\": \"Спутники\",\n \"value\": 16,\n \"group\": \"gps\"\n }, {\n \"key\": \"_angle\",\n \"name\": \"Угол\",\n \"value\": 161,\n \"group\": \"hidden\"\n }, {\n \"key\": \"address\",\n \"name\": \"Адрес\",\n \"value\": \"Овражная 10, Щербинка, Москва\",\n \"group\": \"gps\"\n }, {\n \"key\": \"_imei\",\n \"name\": \"imei\",\n \"value\": \"867459049507122\",\n \"group\": \"hidden\"\n }, {\n \"key\": \"_marker_latlon\",\n \"name\": \"_marker_latlon\",\n \"group\": \"hidden\",\n \"value\": [55.49406666666667, 37.555146666666666]\n }, {\n \"key\": \"4381edf7-2593-4ce7-abff-f1420460c64e\",\n \"name\": \"ДУТ-1\",\n \"value\": 48.806,\n \"group\": \"sensors\"\n }, {\n \"key\": \"46ac6ed0-4eef-4d1e-ba73-1a3f45a85f33\",\n \"name\": \"Зажигание\",\n \"value\": \"Вкл\",\n \"group\": \"sensors\"\n },\n {\n \"key\": \"analytic\",\n \"name\": \"Аналитик\",\n \"value\": \"Иванов B.\",\n \"group\": \"custom_fields\"\n }]\n}]\n\nПолучение дополнительной информации по объекту в мониторинге
\nВ теле запроса в units указать ID объектов.
\n{\n \"units\": [\n {\"id\": \"1478c4b7-464e-4f85-b962-afcc124755a2\"}\n ]\n}\n\nВозращает следующую информацию:
Последнюю поездку - начало, конец, длительность, нач. адрес, кон. адрес.
Последнюю остановку\\стоянку - начало, конец, длительность, нач. адрес, кон. адрес.
Последнюю заправку - начало, заправка, кон. адрес.
Последний слив - начало, слив, кон. адрес.
Ответ состоит из нескольких записей, каждое имеет поля key, name, value и columns. Каждый элемент в columns имеет поля key, name и value. Если нет информации, то column пустое.
\n[\n {\n \"key\": \"last_trip\",\n \"name\": \"Последняя поездка\",\n \"value\": \"3:48:23\",\n \"columns\": [\n {\n \"key\": \"first_datepoint\",\n \"name\": \"Начало\",\n \"value\": \"19/11/21 12:05\"\n },\n {\n \"key\": \"last_datepoint\",\n \"name\": \"Конец\",\n \"value\": \"19/11/21 15:54\"\n },\n {\n \"key\": \"sum_datepoint\",\n \"name\": \"Длит-сть\",\n \"value\": \"3:48:23\"\n },\n {\n \"key\": \"first_address\",\n \"name\": \"Нач. адрес\",\n \"value\": \"56.509 67.5143\"\n },\n {\n \"key\": \"last_address\",\n \"name\": \"Кон. адрес\",\n \"value\": \"57.0903 63.8347\"\n }\n ]\n },\n {\n \"key\": \"last_stop\",\n \"name\": \"Последняя остановка\",\n \"value\": \"0:04:54\",\n \"columns\": [\n {\n \"key\": \"first_datepoint\",\n \"name\": \"Начало\",\n \"value\": \"19/11/21 15:32\"\n },\n {\n \"key\": \"last_datepoint\",\n \"name\": \"Конец\",\n \"value\": \"19/11/21 15:37\"\n },\n {\n \"key\": \"sum_datepoint\",\n \"name\": \"Длит-сть\",\n \"value\": \"0:04:54\"\n },\n {\n \"key\": \"last_address\",\n \"name\": \"Кон. адрес\",\n \"value\": \"57.0992 64.1719\"\n }\n ]\n },\n {\n \"key\": \"last_filling\",\n \"name\": \"Последняя заправка\",\n \"value\": 186.49,\n \"columns\": [\n {\n \"key\": \"first_datepoint\",\n \"name\": \"Начало\",\n \"value\": \"19/11/21 11:56\"\n },\n {\n \"key\": \"stucked_fillings\",\n \"name\": \"Заправки\",\n \"value\": 186.49\n },\n {\n \"key\": \"last_address\",\n \"name\": \"Кон. адрес\",\n \"value\": \"56.5107 67.4843\"\n }\n ]\n },\n {\n \"key\": \"last_theft\",\n \"name\": \"Последний слив\",\n \"columns\": []\n }\n]\n\nЗапрос отчета
\nЗапрос отчета содержит следующие параметры:
\nunits - массив id объектов, по которым требуется сделать отчет. Если отчет по группам, тогда groups - массив id групп объектов, по которым требуется сделать отчет.
\ngeozones - список, который определяет геозоны используемые при генерации отчета. Если не передать, то используются все геозоны компании или геозоны указанные в таблице шаблона.
\ntemplate_tables - массив id таблиц. Используется ТОЛЬКО первая таблица.
\nfrom - время начала отчета в формате yyyy-mm-dd hh:mm:ss
\nto - время конца отчета в формате yyyy-mm-dd hh:mm:ss
\noffset - опционально. Параметр для пагинации. Определяет количество пропущенных строк, начиная с нулевой строки. Если параметр отсутствует в запросе, то по дефолту он равен 0.
\nmax - опционально. Параметр для пагинации. Определяет максимальное количество строк, выдаваемое в запросе. Если параметр отсутствует в запросе, то по дефолту он равен значению всех строк, которые удалось сформировать в отчете. (Для графика это количество максимальных точек в графике. Если не приходит или значение больше 5000, тогда по умолчанию выбирается 5000).
\nselected_columns - опционально. Только для графиков или для журналов (отчет с типом chart или journal), иначе просто игнорируется. Определяет набор данных (сырых или датчиков), которые будут возвращены, вместе с данными по датчикам. Выбирается из possible_columns. Например ('selected_columns': [{'key': '1a590afb-bfe5-44cf-8d78-f5137bfbb7ae', 'name': 'Напряжение', 'sensor': true},{'key': 'voltage_main', 'name': 'voltage_main', 'sensor': false}]).
\nonly_totals - опционально. Логическое значение. Если параметр отсутствует в запросе, то по дефолту он равен false. Если true, то возвращается только итоговые строки отчета.
\nsortField - опционально. Строка. Ключ поля, по которому нужно сортировать результат.
\nsortDesc - опционально. Логическое значение. True, если нужно сортировать по убыванию.
\ntime_group - Группировка по времени, моожно указать hour, day, week, month
\nОграничения:
\nПараметры offset и max следует использовать в паре.
\nПараметры sortField и sortDesc следует использовать в паре.
\nКолонки, ключи которых начинаются с \"_\", являются сервисными и не должны быть видимы на фронте, даже если у них случайно 'is_visible' = true.
Типы сервисных колонок:
- '_start_latlon_%ключ отчета%' - начальная координата\n - '_end_latlon_%ключ отчета%' - конечная координата\n - '_start_time_%ключ отчета%' - время начала\n - '_end_time_%ключ отчета%' - время конца\n - '_marker_latlon_%ключ отчета%' - координата маркера\n - '_is_total' - Определяет, является ли строка итоговой. Итоговые строки должны быть выделены жирным шрифтом.\n\nСтруктура отчета:
\n\"unit_id\": id объекта\n\"unit_name\": имя объекта\n\"report\": {\n \"name\": //название отчета, заданное пользователем, либо, если таблица дефолтная - дефолтное имя\n \"default_name\": //название дефолтной таблицы, если название таблицы отличается от название дефолтной таблицы.\n \"key\": //ключ отчета. Ключ не может быть произвольным и, если таблица создана пользователем, всегда должен быть равен ключу дефолтной таблицы, на основе которой таблица создавалась. см. GET /report_templates?ids=:ids\n \"possible_columns\": [ // список возможных полей, которые можно выбрать в журнале и графике\n {'key': '1a590afb-bfe5-44cf-8d78-f5137bfbb7ae', 'name': 'Напряжение', 'sensor': true},\n {'key': 'voltage_main', 'name': 'voltage_main'},\n {'key': 'angle', 'name': 'angle'},\n {'key': 'byte_in', 'name': 'byte_in'}\n ]\n \"columns\": [ //тех. информация о колонках отчета\n {\n \"key\": //тип колонки, определяет уникальность. Ключ заранее задается бэкендом.\n \"name\": //имя колонки. Задается юзером в таблице перед построением отчета.\n \"filter_min\": //мин. значение для фильтрации. Значения, не удовлетворяющие фильтру, не используются в построении отчета.\n \"filter_max\": //мин. значение для фильтрации.\n \"sort\": //порядковый номер колонки в отчете. Если у колонок совпадает sort, то очередность среди них определяется рандомно.\n \"is_visible\": //видимость колонки для пользователя.\n \"is_searchable\": //true, если можно фильтровать по этому полю.\n \"is_sortable\": //true, если можно сортировать по этому полю.\n }\n ],\n \"rows\": [ // строки отчета\n {\n \"№\": 1 //значение колонки, ассоциированное по принципу \"columns.key\":\"value\" \n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"first_datepoint\": \"2020-01-01 06:07:59\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"last_datepoint\": \"2020-01-02 14:01:50\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"_is_total\": false //данное значение является сервисным.\n }\n ],\n \"max_rows\": Общее количество строк отчета, которое было построено. Необходимо для пагинации. А для графика - это количество максимальных точек в терминале в указанном интервале времени запроса.\n\nПро дефолтные таблицы можно почитать здесь GET /report_templates?ids=:ids
\nПример запроса:
\n{ \n 'units': [{'id': '712ceae4-f112-4714-9a4d-afe141e47bf7'}],\n 'template_tables': [{'id': '275c6ee8-2933-4dd3-8adf-9544e26bf98a'}],\n 'from': '2020-01-01 00:00:00',\n 'to': '2020-01-06 00:00:00',\n 'offset': 0,\n 'max': 50\n}\n\nПример запроса с фильтром и сортировкой отчета:
\n{\n \"units\": [\n {\n \"id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }\n ],\n \"from\": \"2020-01-01 00:00:00\",\n \"to\": \"2020-01-06 00:00:00\",\n \"offset\": 0,\n \"max\": 50,\n \"sortField\": \"first_datepoint\",\n \"sortDesc\": true,\n \"conditions\": [\n {\n \"field\": \"sum_fillings\",\n \"value\": \"100\",\n \"operator\": \"ge\"\n }\n ]\n}\n\nПример ответа:
\n{\n \"unit_id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\",\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"report\": {\n \"name\": \"Cтоянки\",\n \"key\": \"stays\",\n \"columns\": [\n {\n \"key\": \"№\",\n \"name\": \"№\",\n \"filter_min\": 0,\n \"filter_max\": 0,\n \"sort\": 0,\n \"is_visible\": true\n },\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя объекта\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 1,\n \"is_visible\": true\n },\n {\n \"key\": \"first_datepoint\",\n \"name\": \"Начало\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 2,\n \"is_visible\": true\n },\n {\n \"key\": \"last_datepoint\",\n \"name\": \"Конец\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 3,\n \"is_visible\": true\n },\n {\n \"key\": \"sum_datepoint\",\n \"name\": \"Длительность\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 4,\n \"is_visible\": true\n },\n {\n \"key\": \"first_fillings_fuel\",\n \"name\": \"first_fillings\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 5,\n \"is_visible\": true\n },\n {\n \"key\": \"last_address\",\n \"name\": \"Конечный адрес\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 6,\n \"is_visible\": true\n },\n {\n \"key\": \"finish_fillings_fuel\",\n \"name\": \"finish_fillings\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 7,\n \"is_visible\": true\n },\n {\n \"key\": \"stucked_fillings_fuel\",\n \"name\": \"stucked_fillings\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 8,\n \"is_visible\": true\n },\n {\n \"key\": \"count_point\",\n \"name\": \"Кол-во сообщений\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 10,\n \"is_visible\": true\n },\n {\n \"key\": \"sum_fillings_fuel\",\n \"name\": \"расход\",\n \"filter_min\": 0,\n \"filter_max\": 1000,\n \"sort\": 13,\n \"is_visible\": true\n },\n {\n \"key\": \"_is_total\",\n \"name\": \"_is_total\",\n \"filter_min\": 0,\n \"filter_max\": 0,\n \"sort\": 99999,\n \"is_visible\": false\n }\n ],\n \"rows\": [\n {\n \"№\": 1,\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"first_datepoint\": \"2020-01-01 06:07:59\",\n \"last_datepoint\": \"2020-01-01 08:45:58\",\n \"sum_datepoint\": \"2:37:59\",\n \"first_fillings_fuel\": 263.61,\n \"last_address\": \"[lat: 52.984060, lon: 63.235077]\",\n \"finish_fillings_fuel\": 243.13,\n \"stucked_fillings_fuel\": 0,\n \"count_point\": 765,\n \"sum_fillings_fuel\": 20.48,\n \"_is_total\": false\n },\n {\n \"№\": 2,\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"first_datepoint\": \"2020-01-01 08:47:39\",\n \"last_datepoint\": \"2020-01-01 16:52:38\",\n \"sum_datepoint\": \"8:04:59\",\n \"first_fillings_fuel\": 243.15,\n \"last_address\": \"[lat: 52.983917, lon: 63.235310]\",\n \"finish_fillings_fuel\": 236.74,\n \"stucked_fillings_fuel\": 0,\n \"count_point\": 77,\n \"sum_fillings_fuel\": 6.41,\n \"_is_total\": false\n },\n {\n \"№\": 3,\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"first_datepoint\": \"2020-01-01 16:59:20\",\n \"last_datepoint\": \"2020-01-01 17:16:10\",\n \"sum_datepoint\": \"0:16:50\",\n \"first_fillings_fuel\": 234.81,\n \"last_address\": \"[lat: 52.982044, lon: 63.230095]\",\n \"finish_fillings_fuel\": 234.2,\n \"stucked_fillings_fuel\": 0,\n \"count_point\": 13,\n \"sum_fillings_fuel\": 0.61,\n \"_is_total\": false\n },\n {\n \"№\": 4,\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"first_datepoint\": \"2020-01-01 18:47:38\",\n \"last_datepoint\": \"2020-01-02 14:01:50\",\n \"sum_datepoint\": \"19:14:12\",\n \"first_fillings_fuel\": 218.77,\n \"last_address\": \"[lat: 52.827972, lon: 62.642530]\",\n \"finish_fillings_fuel\": 17697.64,\n \"stucked_fillings_fuel\": 0,\n \"count_point\": 82,\n \"sum_fillings_fuel\": 0,\n \"_is_total\": false\n },\n {\n \"№\": 5,\n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\",\n \"first_datepoint\": \"2020-01-01 06:07:59\",\n \"last_datepoint\": \"2020-01-02 14:01:50\",\n \"sum_datepoint\": \"29:42:12\",\n \"first_fillings_fuel\": 263.61,\n \"last_address\": \"[lat: 52.827972, lon: 62.642530]\",\n \"finish_fillings_fuel\": 17697.64,\n \"stucked_fillings_fuel\": 0,\n \"count_point\": 256,\n \"sum_fillings_fuel\": 27.61,\n \"_is_total\": true\n }\n ],\n \"max_rows\": 4\n }\n }\n\nПример запроса с переопределением геозон
\nЗапрос:
\n {\n \"from\": \"2022-08-02 00:00:00\",\n \"to\": \"2022-09-02 23:59:59\",\n \"templates\": [\n \"0a7606c0-5b63-451f-b5a1-752e816c76d1\"\n ],\n \"template_tables\": [{\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }],\n \"geozones\": [\n {\"id\":\"401817fc-a8f1-4d2e-8b51-caaf453ee455\"}\n ],\n \"units\": [\n {\"id\": \"350d511c-ed5f-424f-91f2-2b9259271ba6\"}\n ],\n \"offset\": 0,\n \"max\": 50,\n \"conditions\": [],\n \"sortField\": \"descending\",\n \"sortDesc\": false\n}\n\nОтвет:
\n\"unit_id\": id объекта\n\"unit_name\": имя объекта\n\"report\": {\n \"name\": //название отчета, заданное пользователем, либо, если таблица дефолтная - дефолтное имя\n \"default_name\": //название дефолтной таблицы, если название таблицы отличается от название дефолтной таблицы.\n \"key\": //ключ отчета. Ключ не может быть произвольным и, если таблица создана пользователем, всегда должен быть равен ключу дефолтной таблицы, на основе которой таблица создавалась. см. GET /report_templates?ids=:ids\n \"possible_columns\": [ // список возможных полей, которые можно выбрать в журнале и графике\n {'key': '1a590afb-bfe5-44cf-8d78-f5137bfbb7ae', 'name': 'Напряжение', 'sensor': true},\n {'key': 'voltage_main', 'name': 'voltage_main'},\n {'key': 'angle', 'name': 'angle'},\n {'key': 'byte_in', 'name': 'byte_in'}\n ]\n \"columns\": [ //тех. информация о колонках отчета\n {\n \"key\": //тип колонки, определяет уникальность. Ключ заранее задается бэкендом.\n \"name\": //имя колонки. Задается юзером в таблице перед построением отчета.\n \"filter_min\": //мин. значение для фильтрации. Значения, не удовлетворяющие фильтру, не используются в построении отчета.\n \"filter_max\": //мин. значение для фильтрации.\n \"sort\": //порядковый номер колонки в отчете. Если у колонок совпадает sort, то очередность среди них определяется рандомно.\n \"is_visible\": //видимость колонки для пользователя.\n \"is_searchable\": //true, если можно фильтровать по этому полю.\n \"is_sortable\": //true, если можно сортировать по этому полю.\n }\n ],\n \"rows\": [ // строки отчета\n {\n \"№\": 1 //значение колонки, ассоциированное по принципу \"columns.key\":\"value\" \n \"unit_name\": \"ДВД Актобе Уаз 186 КР 04\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"first_datepoint\": \"2020-01-01 06:07:59\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"last_datepoint\": \"2020-01-02 14:01:50\" //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"_unit_id\": \"350d511c-ed5f-424f-91f2-2b9259271ba6\", //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"_geozone_id\": \"401817fc-a8f1-4d2e-8b51-caaf453ee455\", //значение колонки, ассоциированное по принципу \"columns.key\":\"value\"\n \"_is_total\": false //данное значение является сервисным.\n }\n ],\n \"max_rows\": Общее количество строк отчета, которое было построено. Необходимо для пагинации. А для графика - это количество максимальных точек в терминале в указанном интервале времени запроса.\n\n\nПримеры запросов и ответов:
selected_columns - для журнала можно указать максимум 6 параметров, для графика максимум 2 параметра.
1) Журнал
\nЕсли не указан selected_columns, то приходят дефолтные поля (datepoint, speedkph, latitude, longitude и _marker_latlon_journal)
\nЗапрос:
\n{\n \"units\": [{\n \"id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\"\n }],\n \"template_tables\": [{\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }],\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-12-01 15:00:00\",\n \"offset\": 0,\n \"max\": 5\n}\n\nОтвет:
\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"НЖС-1 (ЭЧ-10) Уаз 860 AL 03 Астана\",\n \"report\": {\n \"name\": \"Журнал\",\n \"key\": \"journal\",\n \"possible_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }, {\n \"key\": \"785bb809-c6eb-4876-89c0-149f98775c70\",\n \"name\": \"Топливо\"\n }, {\n \"key\": \"dut_485_1\",\n \"name\": \"dut_485_1\"\n }, {\n \"key\": \"d7205a84-0c01-4c4d-9fb8-7d039a043e33\",\n \"name\": \"Зажигание\"\n }, {\n \"key\": \"vol_a_in_1\",\n \"name\": \"vol_a_in_1\"\n }, {\n \"key\": \"3efd7812-dcfd-4fa9-b5dc-a9f16ff8888d\",\n \"name\": \"Резкий поворот\"\n }, {\n \"key\": \"acc_right\",\n \"name\": \"acc_right\"\n }, {\n \"key\": \"1f742665-e78d-40e3-a4ec-369bdf5dfd28\",\n \"name\": \"Резкое ускорение\"\n }, {\n \"key\": \"acc_forward\",\n \"name\": \"acc_forward\"\n }, {\n \"key\": \"42773f51-cc5e-4c84-996a-e1f930d998ca\",\n \"name\": \"Резкое торможение\"\n }, {\n \"key\": \"acc_back\",\n \"name\": \"acc_back\"\n }, {\n \"key\": \"89fcedcf-9689-4ea5-bb9a-7879b5136427\",\n \"name\": \"Превышение скорости\"\n }, {\n \"key\": \"acc_speed\",\n \"name\": \"acc_speed\"\n }],\n \"columns\": [{\n \"key\": \"№\",\n \"name\": \"№\"\n }, {\n \"key\": \"_marker_latlon_journal\",\n \"name\": \"_marker_latlon_journal\"\n }, {\n \"key\": \"datepoint\",\n \"name\": \"datepoint\"\n }, {\n \"key\": \"speedkph\",\n \"name\": \"speedkph\"\n }, {\n \"key\": \"latitude\",\n \"name\": \"latitude\"\n }, {\n \"key\": \"longitude\",\n \"name\": \"longitude\"\n }],\n \"rows\": [{\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:26\",\n \"longitude\": 37.711567,\n \"№\": 1,\n \"_marker_latlon_journal\": [55.7962, 37.711567]\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"longitude\": 37.711567,\n \"№\": 2,\n \"_marker_latlon_journal\": [55.7962, 37.711567]\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"longitude\": 37.711567,\n \"№\": 3,\n \"_marker_latlon_journal\": [55.7962, 37.711567]\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"longitude\": 37.711567,\n \"№\": 4,\n \"_marker_latlon_journal\": [55.7962, 37.711567]\n }, {\n \"speedkph\": 0,\n \"latitude\": 51.80577,\n \"datepoint\": \"2020-11-01 13:40:55\",\n \"longitude\": 68.36547,\n \"№\": 5,\n \"_marker_latlon_journal\": [51.80577, 68.36547]\n }],\n \"max_rows\": 22406\n }\n}\n\nЕсли указан selected_columns, то приходят значения указанных параметров и дефолтные параметры.
\nЗапрос:
\n{\n \"units\": [{\n \"id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\"\n }],\n \"template_tables\": [{\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }],\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-12-01 15:00:00\",\n \"offset\": 0,\n \"max\": 100,\n \"selected_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }]\n}\n\nОтвет:
\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"НЖС-1 (ЭЧ-10) Уаз 860 AL 03 Астана\",\n \"report\": {\n \"name\": \"Журнал\",\n \"key\": \"journal\",\n \"possible_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }, {\n \"key\": \"785bb809-c6eb-4876-89c0-149f98775c70\",\n \"name\": \"Топливо\"\n }, {\n \"key\": \"dut_485_1\",\n \"name\": \"dut_485_1\"\n }, {\n \"key\": \"d7205a84-0c01-4c4d-9fb8-7d039a043e33\",\n \"name\": \"Зажигание\"\n }, {\n \"key\": \"vol_a_in_1\",\n \"name\": \"vol_a_in_1\"\n }, {\n \"key\": \"3efd7812-dcfd-4fa9-b5dc-a9f16ff8888d\",\n \"name\": \"Резкий поворот\"\n }, {\n \"key\": \"acc_right\",\n \"name\": \"acc_right\"\n }, {\n \"key\": \"1f742665-e78d-40e3-a4ec-369bdf5dfd28\",\n \"name\": \"Резкое ускорение\"\n }, {\n \"key\": \"acc_forward\",\n \"name\": \"acc_forward\"\n }, {\n \"key\": \"42773f51-cc5e-4c84-996a-e1f930d998ca\",\n \"name\": \"Резкое торможение\"\n }, {\n \"key\": \"acc_back\",\n \"name\": \"acc_back\"\n }, {\n \"key\": \"89fcedcf-9689-4ea5-bb9a-7879b5136427\",\n \"name\": \"Превышение скорости\"\n }, {\n \"key\": \"acc_speed\",\n \"name\": \"acc_speed\"\n }, {\n \"key\": \"acc_left\",\n \"name\": \"acc_left\"\n }, {\n \"key\": \"acc_max_angle\",\n \"name\": \"acc_max_angle\"\n }, {\n \"key\": \"acc_max_minus\",\n \"name\": \"acc_max_minus\"\n }, {\n \"key\": \"acc_max_plus\",\n \"name\": \"acc_max_plus\"\n }, {\n \"key\": \"acc_x\",\n \"name\": \"acc_x\"\n }, {\n \"key\": \"acc_y\",\n \"name\": \"acc_y\"\n }, {\n \"key\": \"acc_z\",\n \"name\": \"acc_z\"\n }],\n \"columns\": [{\n \"key\": \"№\",\n \"name\": \"№\"\n }, {\n \"key\": \"_marker_latlon_journal\",\n \"name\": \"_marker_latlon_journal\"\n }, {\n \"key\": \"datepoint\",\n \"name\": \"datepoint\"\n }, {\n \"key\": \"speedkph\",\n \"name\": \"speedkph\"\n }, {\n \"key\": \"latitude\",\n \"name\": \"latitude\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }, {\n \"key\": \"longitude\",\n \"name\": \"longitude\"\n }, {\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }],\n \"rows\": [{\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:26\",\n \"voltage_main\": 12251,\n \"longitude\": 37.711567,\n \"№\": 1,\n \"_marker_latlon_journal\": [55.7962, 37.711567],\n \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\": 12251.0\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"voltage_main\": 12123,\n \"longitude\": 37.711567,\n \"№\": 2,\n \"_marker_latlon_journal\": [55.7962, 37.711567],\n \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\": 12123.0\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"voltage_main\": 12123,\n \"longitude\": 37.711567,\n \"№\": 3,\n \"_marker_latlon_journal\": [55.7962, 37.711567],\n \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\": 12123.0\n }, {\n \"speedkph\": 0,\n \"latitude\": 55.7962,\n \"datepoint\": \"2020-11-01 13:39:55\",\n \"voltage_main\": 12121,\n \"longitude\": 37.711567,\n \"№\": 4,\n \"_marker_latlon_journal\": [55.7962, 37.711567],\n \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\": 12121.0\n }, {\n \"speedkph\": 0,\n \"latitude\": 51.80577,\n \"datepoint\": \"2020-11-01 13:40:55\",\n \"voltage_main\": 12088,\n \"longitude\": 68.36547,\n \"№\": 5,\n \"_marker_latlon_journal\": [51.80577, 68.36547],\n \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\": 12088.0\n }],\n \"max_rows\": 22406\n }\n}\n\n2) График
\nЕсли не указан selected_columns, то приходят поля с данными datepoint, speed, is_trip, trips_intervals и значения 2 первых датчиков (если есть).
\nЗапрос:
\n{\n \"units\": [{\n \"id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\"\n }],\n \"template_tables\": [{\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }],\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-12-01 00:00:00\"\n}\n\nОтвет:
\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"НЖС-1 (ЭЧ-10) Уаз 860 AL 03 Астана\",\n \"report\": {\n \"name\": \"график\",\n \"key\": \"chart\",\n \"possible_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }, {\n \"key\": \"785bb809-c6eb-4876-89c0-149f98775c70\",\n \"name\": \"Топливо\"\n }, {\n \"key\": \"dut_485_1\",\n \"name\": \"dut_485_1\"\n }, {\n \"key\": \"d7205a84-0c01-4c4d-9fb8-7d039a043e33\",\n \"name\": \"Зажигание\"\n }, {\n \"key\": \"vol_a_in_1\",\n \"name\": \"vol_a_in_1\"\n }, {\n \"key\": \"3efd7812-dcfd-4fa9-b5dc-a9f16ff8888d\",\n \"name\": \"Резкий поворот\"\n }, {\n \"key\": \"acc_right\",\n \"name\": \"acc_right\"\n }, {\n \"key\": \"1f742665-e78d-40e3-a4ec-369bdf5dfd28\",\n \"name\": \"Резкое ускорение\"\n }, {\n \"key\": \"acc_forward\",\n \"name\": \"acc_forward\"\n }, {\n \"key\": \"42773f51-cc5e-4c84-996a-e1f930d998ca\",\n \"name\": \"Резкое торможение\"\n }, {\n \"key\": \"acc_back\",\n \"name\": \"acc_back\"\n }, {\n \"key\": \"89fcedcf-9689-4ea5-bb9a-7879b5136427\",\n \"name\": \"Превышение скорости\"\n }, {\n \"key\": \"acc_speed\",\n \"name\": \"acc_speed\"\n }, {\n \"key\": \"acc_left\",\n \"name\": \"acc_left\"\n }],\n \"columns\": [{\n \"key\": \"datepoint\",\n \"name\": \"datepoint\",\n \"data\": [\"2020-11-01 13:39:26\", \"2020-11-01 13:50:12\", \"2020-11-01 14:04:40\", \"2020-11-01 16:29:09\", \"2020-11-01 19:00:52\", \"2020-11-01 19:48:12\", \"2020-11-01 20:34:44\", \"2020-11-01 21:19:05\", \"2020-11-01 21:57:05\", \"2020-11-01 22:30:46\"]\n }, {\n \"key\": \"speed\",\n \"name\": \"speed\",\n \"data\": [0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n }, {\n \"key\": \"is_trip\",\n \"name\": \"is_trip\",\n \"data\": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n }, {\n \"key\": \"trips_intervals\",\n \"name\": \"trips_intervals\",\n \"data\": [\n [\"2020-11-01 13:42:26\", \"2020-11-01 13:43:06\"],\n [\"2020-11-01 14:04:04\", \"2020-11-01 14:05:15\"],\n [\"2020-11-02 08:17:31\", \"2020-11-02 08:18:20\"],\n [\"2020-11-02 08:23:05\", \"2020-11-02 08:29:04\"],\n [\"2020-11-02 08:38:34\", \"2020-11-02 08:39:13\"],\n [\"2020-11-02 08:44:11\", \"2020-11-02 08:50:27\"],\n [\"2020-11-02 10:54:29\", \"2020-11-02 10:55:31\"],\n [\"2020-11-02 11:52:07\", \"2020-11-02 12:03:11\"],\n [\"2020-11-02 14:06:43\", \"2020-11-02 14:22:20\"],\n [\"2020-11-02 15:41:19\", \"2020-11-02 15:45:19\"]\n ]\n }, {\n \"key\": \"_marker_latlon_chart\",\n \"name\": \"_marker_latlon_chart\",\n \"data\": [\n [52.19, 65.45],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37]\n ]\n }, {\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\",\n \"data\": [12086.14, 12455.71, 11866.95, 11813.52, 11891.0, 11885.48, 11881.95, 11879.57, 11877.76, 11873.1]\n }, {\n \"key\": \"785bb809-c6eb-4876-89c0-149f98775c70\",\n \"name\": \"Топливо\",\n \"data\": [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]\n }],\n \"max_rows\": 1014\n }\n}\n\nЕсли указан selected_columns, то приходят поля с данными datepoint, speed, is_trip, trips_intervals и указанные параметры.
\nЗапрос:
\n{\n \"units\": [{\n \"id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\"\n }],\n \"template_tables\": [{\n \"id\": \"275c6ee8-2933-4dd3-8adf-9544e26bf98a\"\n }],\n \"from\": \"2020-11-01 00:00:00\",\n \"to\": \"2020-12-01 00:00:00\",\n \"selected_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"angle\",\n \"name\": \"angle\"\n }]\n}\n\nОтвет:
\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"НЖС-1 (ЭЧ-10) Уаз 860 AL 03 Астана\",\n \"report\": {\n \"name\": \"график\",\n \"key\": \"chart\",\n \"possible_columns\": [{\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\"\n }, {\n \"key\": \"voltage_main\",\n \"name\": \"voltage_main\"\n }, {\n \"key\": \"785bb809-c6eb-4876-89c0-149f98775c70\",\n \"name\": \"Топливо\"\n }, {\n \"key\": \"dut_485_1\",\n \"name\": \"dut_485_1\"\n }, {\n \"key\": \"d7205a84-0c01-4c4d-9fb8-7d039a043e33\",\n \"name\": \"Зажигание\"\n }, {\n \"key\": \"vol_a_in_1\",\n \"name\": \"vol_a_in_1\"\n }, {\n \"key\": \"3efd7812-dcfd-4fa9-b5dc-a9f16ff8888d\",\n \"name\": \"Резкий поворот\"\n }, {\n \"key\": \"acc_right\",\n \"name\": \"acc_right\"\n }, {\n \"key\": \"1f742665-e78d-40e3-a4ec-369bdf5dfd28\",\n \"name\": \"Резкое ускорение\"\n }, {\n \"key\": \"acc_forward\",\n \"name\": \"acc_forward\"\n }, {\n \"key\": \"42773f51-cc5e-4c84-996a-e1f930d998ca\",\n \"name\": \"Резкое торможение\"\n }, {\n \"key\": \"acc_back\",\n \"name\": \"acc_back\"\n }, {\n \"key\": \"89fcedcf-9689-4ea5-bb9a-7879b5136427\",\n \"name\": \"Превышение скорости\"\n }, {\n \"key\": \"acc_speed\",\n \"name\": \"acc_speed\"\n }, {\n \"key\": \"acc_left\",\n \"name\": \"acc_left\"\n }, {\n \"key\": \"acc_max_angle\",\n \"name\": \"acc_max_angle\"\n }, {\n \"key\": \"acc_max_minus\",\n \"name\": \"acc_max_minus\"\n }, {\n \"key\": \"acc_max_plus\",\n \"name\": \"acc_max_plus\"\n }, {\n \"key\": \"acc_x\",\n \"name\": \"acc_x\"\n }, {\n \"key\": \"acc_y\",\n \"name\": \"acc_y\"\n }, {\n \"key\": \"acc_z\",\n \"name\": \"acc_z\"\n }, {\n \"key\": \"altitude\",\n \"name\": \"altitude\"\n }, {\n \"key\": \"angle\",\n \"name\": \"angle\"\n }, {\n \"key\": \"box_crack\",\n \"name\": \"box_crack\"\n }, {\n \"key\": \"bth_conf_st\",\n \"name\": \"bth_conf_st\"\n }, {\n \"key\": \"bytes_in\",\n \"name\": \"bytes_in\"\n }, {\n \"key\": \"bytes_out\",\n \"name\": \"bytes_out\"\n }, {\n \"key\": \"can_accel_pos\",\n \"name\": \"can_accel_pos\"\n }, {\n \"key\": \"can_break_pos\",\n \"name\": \"can_break_pos\"\n }, {\n \"key\": \"can_disel_filter\",\n \"name\": \"can_disel_filter\"\n }],\n \"columns\": [{\n \"key\": \"datepoint\",\n \"name\": \"datepoint\",\n \"data\": [\"2020-11-01 13:39:26\", \"2020-11-01 13:50:12\", \"2020-11-01 14:04:40\", \"2020-11-01 16:29:09\", \"2020-11-01 19:00:52\", \"2020-11-01 19:48:12\", \"2020-11-01 20:34:44\", \"2020-11-01 21:19:05\", \"2020-11-01 21:57:05\", \"2020-11-01 22:30:46\"]\n }, {\n \"key\": \"speed\",\n \"name\": \"speed\",\n \"data\": [0, 1, 0, 3, 5, 6, 10, 20, 12, 0, 0]\n }, {\n \"key\": \"is_trip\",\n \"name\": \"is_trip\",\n \"data\": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n }, {\n \"key\": \"trips_intervals\",\n \"name\": \"trips_intervals\",\n \"data\": [\n [\"2020-11-01 13:42:26\", \"2020-11-01 13:43:06\"],\n [\"2020-11-01 14:04:04\", \"2020-11-01 14:05:15\"],\n [\"2020-11-02 08:17:31\", \"2020-11-02 08:18:20\"],\n [\"2020-11-02 08:23:05\", \"2020-11-02 08:29:04\"],\n [\"2020-11-02 08:38:34\", \"2020-11-02 08:39:13\"],\n [\"2020-11-02 08:44:11\", \"2020-11-02 08:50:27\"],\n [\"2020-11-02 10:54:29\", \"2020-11-02 10:55:31\"],\n [\"2020-11-02 11:52:07\", \"2020-11-02 12:03:11\"],\n [\"2020-11-02 14:06:43\", \"2020-11-02 14:22:20\"],\n [\"2020-11-02 15:41:19\", \"2020-11-02 15:45:19\"]\n ]\n }, {\n \"key\": \"_marker_latlon_chart\",\n \"name\": \"_marker_latlon_chart\",\n \"data\": [\n [52.19, 65.45],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37],\n [51.81, 68.37]\n ]\n }, {\n \"key\": \"1a590afb-bfe5-44cf-8d78-f5137bfbb7ae\",\n \"name\": \"Напряжение\",\n \"data\": [12086.14, 12455.71, 11866.95, 11813.52, 11891.0, 11885.48, 11881.95, 11879.57, 11877.76, 11873.1]\n }, {\n \"key\": \"angle\",\n \"name\": \"angle\",\n \"data\": [111.95, 125.38, 124.71, 37.0, 37.0, 37.0, 37.0, 37.0, 37.0, 37.0]\n }],\n \"max_rows\": 1014\n }\n}\n\nНовые поля для графика в template_tables:
\nЧекбокс \"Отображать сливы и заправки\" - show_fillings_thefts, boolean
\nЧекбокс \"Сделать отчет закрытым\" - closed_to_change, boolean
\nМаски названия датчиков топлива - fuel_sensor_name_masks, массив имеющий поле value, как в поле sensor_name_masks
\n\"Параметры\" - params, массив, имеет поля terminal_type_key - ключ типа протокола (если не указан или null, тогда это для всех протоколов), value-значение параметра
\nПример:
\n{\n \"id\": \"dc029d04-0ed7-4ddd-b243-d32bd9201671\",\n \"key\": \"chart\",\n \"name\": \"Журнал\",\n ..\n \"show_fillings_thefts\": true,\n \"fuel_sensor_name_masks\": [\n {\n \"value\": \"Топлива1\"\n },\n {\n \"value\": \"Топлива2\"\n }\n ],\n \"params\": [\n {\"terminal_type_key\": \"navtelecom\", \"value\": \"dut_485_1\"},\n {\"value\":\"speedkph\"}\n ],\n \"closed_to_change\": true,\n ...\n}\n\nПриходят новые элементы в columns: fillings_intervals - для заправок и thefts_intervals - для сливов. В data приходят даты начала и окончания, как в trips_intervals.
\nПример:
\n\"columns\": [\n ....\n {\n \"key\": \"fillings_intervals\",\n \"name\": \"fillings_intervals\",\n \"data\": [\n [\n \"2021-08-01 09:08:18\",\n \"2021-08-01 09:37:19\"\n ],\n [\n \"2021-08-10 08:51:51\",\n \"2021-08-10 09:02:20\"\n ],\n [\n \"2021-08-13 10:48:34\",\n \"2021-08-13 11:13:01\"\n ]\n ]\n },\n {\n \"key\": \"thefts_intervals\",\n \"name\": \"thefts_intervals\",\n \"data\": [\n [\n \"2021-08-11 00:00:30\",\n \"2021-08-12 00:08:19\"\n ]\n ]\n }\n ]\n\nПолучение данных для графика
\nПосле получения отчета (POST /report), если тег report.is_bar_chart ответа истинен (true), то для этого отчета можно получить данные для графика по этому запросу
\nТело запроса, как в POST /report, только без max и offset значений.
\nВ полученном отчете (структура данных, как и во всех report) будут колонки bar_chart_x и bar_chart_y, по ним нужно будет отобразить bar chart.
\nСтруктура ответа:
\n\"unit_id\": id объекта,если отчет построен по объекту.\n\"unit_name\": имя объекта, если отчет построен по объекту.\n\"group_id\": id группы, если отчет построен по группе.\n\"group_name\": имя группы, если отчет построен по группе.\n\"report\": {\n \"name\": название отчета, заданное пользователем, либо, если таблица дефолтная - дефолтное имя.\n \"key\": ключ отчета. Ключ не может быть произвольным и, если таблица создана юзером, всегда должен быть равен ключу дефолтной таблицы, на основе которой таблица создавалась. см. GET /report_templates?ids=:ids\n \"columns\": [ //тех. информация о колонках отчета\n {\n \"key\": тип колонки \n \"name\": имя колонки..\n }\n ],\n \"rows\": [ // строки отчета\n {\n \"bar_chart_x\" : Названия элемент,\n \"bar_chart_y\": Значение элемента\n }\n ]\n}\n\nПример запроса:
\n{\n \"groups\": [\n {\n \"id\": \"ae3f9037-9fcc-492c-9ba4-8063e737cf95\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"a5dc0870-78cd-4fa9-9522-eb658bb5806b\"\n }\n ],\n \"from\": \"2022-09-01 00:00:00\",\n \"to\": \"2022-10-01 00:00:00\"\n}\n\nПример ответа:
\n{\n \"group_name\": \"Камазы\",\n \"group_id\": \"ae3f9037-9fcc-492c-9ba4-8063e737cf95\"\n \"report\": {\n \"columns\": [\n {\n \"key\": \"bar_chart_x\",\n \"name\": \"Имя\"\n },\n {\n \"key\": \"bar_chart_y\",\n \"name\": \"Балл нарушения\"\n }\n ],\n \"rows\": [\n {\n \"bar_chart_x\": \"Объект 1\",\n \"bar_chart_y\": 68.0\n },\n {\n \"bar_chart_x\": \"Объект 10\",\n \"bar_chart_y\": 24.0\n },\n {\n \"bar_chart_x\": \"Объект 4\",\n \"bar_chart_y\": 63.0\n },\n {\n \"bar_chart_x\": \"Объект 6\",\n \"bar_chart_y\": 604.0\n },\n {\n \"bar_chart_x\": \"Объект 9\",\n \"bar_chart_y\": 255.0\n },\n {\n \"bar_chart_x\": \"Объект 3\",\n \"bar_chart_y\": 86.0\n },\n {\n \"bar_chart_x\": \"Объект 8\",\n \"bar_chart_y\": 123.0\n },\n {\n \"bar_chart_x\": \"Объект 5\",\n \"bar_chart_y\": 47.0\n },\n {\n \"bar_chart_x\": \"Объект 2\",\n \"bar_chart_y\": 267.0\n },\n {\n \"bar_chart_x\": \"Объект 7\",\n \"bar_chart_y\": 115.0\n }\n ]\n }\n}\n\nЗапрос отчета в формате excel
\nЗапрос отчета в формате excel. Параметры аналогичные /report.
\nРезультат - массив байт файла excel.
\n","urlObject":{"path":["api_v1","report_excel"],"host":["{{base_url}}"],"query":[{"key":"body","value":""}],"variable":[]}},"response":[],"_postman_id":"f6ac6dbe-0b46-4731-b73a-1b104774738b"},{"name":"/report_excel","id":"62657eeb-5836-4fba-b8e6-c887d027437d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"groups\": [\n {\n \"id\": \"5b5483dc-99bd-4577-820f-f1e4340cbd60\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"800c0795-5b79-40cd-bdeb-ab309228534b\"\n }\n ],\n \"from\": \"2022-03-05 00:00:00\",\n \"to\": \"2022-03-06 00:00:00\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/report_excel","description":"Запрос отчета в формате Excel
\nЗапрос отчета в формате excel. Параметры аналогичны /report.
\nРезультат - массив байт файла excel.
\n","urlObject":{"path":["api_v1","report_excel"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"62657eeb-5836-4fba-b8e6-c887d027437d"},{"name":"/report_pdf","id":"81496536-04e6-4566-95d2-b68449570044","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"units\": [\n {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"800c0795-5b79-40cd-bdeb-ab309228534b\"\n }\n ],\n \"from\": \"2022-04-28 00:00:00\",\n \"to\": \"2022-06-29 00:00:00\",\n \"files\": [\n \"c29tZV9maWxl\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/report_pdf","description":"Запрос генерации pdf отчета
\nЗапрос отчета в формате pdf. Параметры аналогичные /report.
\nВ поле files можно отправить Base64 код файлов.
Результат - массив байт файла pdf
Пример запроса:
\n{\n \"units\": [\n {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"800c0795-5b79-40cd-bdeb-ab309228534b\"\n }\n ],\n \"from\": \"2022-04-28 00:00:00\",\n \"to\": \"2022-06-29 00:00:00\",\n \"files\": [\n \"c29tZV9maWxlMQ==\",\n \"c29tZV9maWxlMg==\"\n ]\n}\n\nЗапрос генерации word отчета
\nЗапрос отчета в формате word. Параметры аналогичные /report.
\nВ поле files можно отправить Base64 код файлов.
Результат - массив байт файла word.
Пример запроса:
\n{\n \"units\": [\n {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"800c0795-5b79-40cd-bdeb-ab309228534b\"\n }\n ],\n \"from\": \"2022-04-28 00:00:00\",\n \"to\": \"2022-06-29 00:00:00\",\n \"files\": [\n \"c29tZV9maWxlMQ==\",\n \"c29tZV9maWxlMg==\"\n ]\n}\n\nЗапрос создания отчета по ключу отчета
\nПараметры аналогичные POST /report , только в template_tables можно отправить ключ (key) отчета.
\nПример запроса на получение журнала:
\n{\n \"units\": [\n {\n \"id\": \"6b68de17-f031-4371-a792-74670c58d3ce\"\n }\n ],\n \"template_tables\": [\n {\n \"key\": \"journal\"\n }\n ],\n \"from\": \"2023-04-25 00:00:00\",\n \"to\": \"2023-06-29 00:00:00\",\n \"max\": 100,\n \"offset\": 0\n}\n\nЗапрос финансового отчета
\nДля поиска нужно передвать {\"search\":\"Company\"}
\nРезультат - отчет, аналогичный получаемому по запросу POST /reports
\nРоль: Администратор и выше.
\n","urlObject":{"path":["api_v1","finance"],"host":["{{base_url}}"],"query":[{"key":"body","value":"{\"from\":0, \"count\":100}"}],"variable":[]}},"response":[],"_postman_id":"661298d4-b96a-4bd7-9bb4-435743d6486e"},{"name":"/heat_maps","id":"c5b8cbd6-e289-4301-9d38-b4f5c9125b21","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"max_radius\": 1000\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/heat_maps","description":"Выдача данных для отображения тепловых карт
\nВыдача данных для отображения тепловых картах в виде
\n[{\n \"density\": n,\n \"lat\": x,\n \"lon\": y\n}]\n\nгде n - количество точек, попавших в группу точности до 0.01 - т.е. в радиусе 1 км.
\nПараметры в теле запроса:
max_radius - максимальный радиюь в метрах
Роль: Читатель и выше.
\nПример запроса:
\n{\n \"max_radius\": 1000\n}\n\nПример ответа:
\nМаскимум 20 тыс записей в ответе.
\n[\n {\n \"density\": 10.5,\n \"lat\": 59.78,\n \"lon\": 57.06\n },\n {\n \"density\": 1.0,\n \"lat\": 55.57,\n \"lon\": 36.75\n }\n]\n\nПолучение последних данных по объектам
\nВ запросе можно указать объекты или одну группу
\nРоль: Читатель и выше.
\nПример запроса и объектами:
\n{\n \"units\": [\n {\n \"id\": \"2bd74bab-8173-4c06-8fd8-ad923d3ad7d3\"\n },\n {\n \"id\": \"655f9207-b19d-4df4-9cbe-442c8777baec\"\n }\n ]\n}\n\nПример запрос с группой:
\n{\n \"groups\": [\n {\n \"id\": \"5dabceab-ae23-493f-8c04-8028c7066e8a\"\n }\n ]\n}\n\nВ ответе возвращаются следующий поля:
\n**по объекту**\nunit.id\nunit.name\nunit.imei\nunit.custom_fields - Ваши параметры\n**Из последнего сообщения**\nunix_timestamp \nspeed\naltitude\nsatellites\nlatitude\nlogitude\naddress\ntrip_detector - стоит или едет c учетом минимальной скорости движения (\"stop\" or \"movement\")\n\n[\n {\n \"unit\": {\n \"id\": \"2bd74bab-8173-4c06-8fd8-ad923d3ad7d3\",\n \"imei\": \"8674590000000000\",\n \"name\": \"MAN К922ОС 77 (Main) \",\n \"custom_fields\": [\n {\n \"name\": \"S-2551\",\n \"value\": \"#1\"\n },\n {\n \"name\": \"Тип терминала\",\n \"value\": \"1\"\n },\n {\n \"name\": \"Осмотр 5\",\n \"value\": \"55555\"\n },\n {\n \"name\": \"Вторая sim\",\n \"value\": \"11111XYZV\"\n }\n ]\n },\n \"last_point\": {\n \"unix_timestamp\": 1707982594,\n \"speed\": 3,\n \"angle\": 318,\n \"altitude\": 1745,\n \"satellites\": 21,\n \"latitude\": 55.5130615234375,\n \"longitude\": 37.7850456237793,\n \"address\": \"Горки Ленинские, Ленинский городской округ, Московская область\",\n \"trip_detector\": \"movement\"\n }\n }\n]\n\nPOST /cancel_report\n{\n \"_reportId\": \".....\"\n}\n\nОстановить запущенный отчет.
\n_reportId формируется на вебе при формировании отчета.
\n","urlObject":{"path":["api_v1","cancel_report"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1079a247-a9d6-4814-9e84-345da48acd17"}],"id":"2c8da069-d777-4b30-a7f8-ff96a17e2767","_postman_id":"2c8da069-d777-4b30-a7f8-ff96a17e2767","description":""},{"name":"Шаблоны отчетов","item":[{"name":"/report_templates?ids=:ids","id":"aef8a4f5-031c-44c0-a245-f1aa9c4d38a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/report_templates?ids=","description":"Получить все шаблоны отчетов по компании
\nКаждый Шаблон по сути это именнованая группа Таблиц Шаблонов отчетов.
\nТаблица Шаблона - это набор Колонок Таблицы Шаблона + параметры.
\nВ самих Таблицах Шаблона задаются параметры для отображения отчета, например имя таблицы, группировка по определенной колонке, и т.д.
\nЛюбой запрос шаблонов, помимо пользовательских шаблонов, также выводит Базовный шаблон (с таблицами и колонками по умолчанию), у которого параметр 'is_default' = true и параметр 'company_id' пустой. Таблицы и колонки данного шаблона не изменяемы и используются только для создания на их основе пользовательских таблиц.
\nРоль: Читатель и выше.
\nОтвет:
\n[{\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id шаблона\n \"name\": \"шаблон2\", //имя\n \"template_tables\": [{\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\", //id таблицы\n \"id_template\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id родительского шаблона\n \"name\": \"Уведомления\", //имя таблицы\n \"key\": \"notifications\", //ключ таблицы (берется из справочников по типу 'report_template_table_type') ------ НЕ ИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"geozones\": [{ // список выбранных геозон\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\"\n // --------------- полный перечень полей геозоны ---------------------\n }],\n \"show_itog\": true, //показывать ли итог в таблице отчета\n \"intervals_priority_high\": true, // Приоритетны ли интервалы отчета или смены\n \"time_group\": \"nogrouping\", //временная группировка, возможные значения Без групперовки, По дням, По неделям, По месяцам (берется из справочников по типу 'report_template_table_type')\n \"column_group\": \"name\", // ключ колонки по которой происходит группировка\n \"template_columns\": [{ //колонки талбицы отчета, первоначально колонки берутся из справочника (для каждой таблицы предустановлены колонки) ------ НЕ ИЗМЕНЯЕМОЕ КОЛИЧЕСТО КОЛОНОК --------\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\",\n \"name\": \"Имя\", //имя колонки\n \"filter_min\": 0, //фильтрация строк по минимальному значению\n \"filter_max\": 1000, //фильтрация строк по максимльному значению\n \"user_filter\": false,//использовать фильтрацию filter_min и filter_max \n \"sort\": 0, //порядок колонки в отчете\n \"key\": \"name\", //ключ колонки ------ НЕ ИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"is_visible\": true //видима ли колонка в отчете \n }],\n \"template_sensors\": [{\n \"id\": \"8f05e497-bddc-4b6a-bedb-e1c6ab5b55f0\",\n \"sensor_type\": { // тип датчика, справочник типа sensor_type\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": { //значение датчика, справочник типа template_sensor_value_type\n \"key\": \"template_sensor_first_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Начальное значение\"\n },\n \"name_mask\": \"Пробег\" //string, маска по имени\n }, {\n \"id\": \"91100c04-9ca6-48b1-9201-715713d023cc\",\n \"sensor_type\": {\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": {\n \"key\": \"template_sensor_last_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Конечное значение\"\n },\n \"name_mask\": \"Пробег\"\n }],\n \"template_computable_columns\": [// вычисляемые колонки\n {\n \"name\": \"Тип / марка машины\", // название колонки\n \"value\": \"custom_fields.brand_name\"// значение колонки\n },\n {\n \"name\": \"Расход по показаниям системы SKIF APP, л.\",\n \"value\": \"columns.sum_fillings\"\n },\n {\n \"name\": % экономии от SKIF APP\",\n \"value\": \"columns.sum_fillings_plan / columns.sum_fillings * 100 - 100\"\n },\n ]\n }]\n}]\n\nСоздает свой шаблон отчетов
\nПо правилам, таблица шаблона должна строиться на основании дефолтного шаблона таблиц, т.е. путем копирования полей дефолтного шаблона и заполнения их пользовательскими значениями
(кроме поля 'key').
При создании Шаблона Таблицы:
- ключи таблиц должны быть в словаре таблиц см. /dictionaries (не допускаются произвольные ключи или пустые значения);
- количество колонок и их ключи должны совпадать с шаблоном конкретной таблицы Базового шаблона ;
Запрос для создания пустого шаблона:
\n{\"name\": \"Имя_шаблона\", \"template_tables\": []}\n\nРоль: Редактор и выше.
\nОтвет:
\n[{\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id шаблона\n \"name\": \"шаблон2\", //имя\n \"template_tables\": [{\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\", //id таблицы\n \"id_template\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id родительского шаблона\n \"name\": \"Уведомления\", //имя таблицы\n \"key\": \"notifications\", //ключ таблицы (берется из справочников по типу 'report_template_table_type') ------ НЕИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"attachments\": [{ //вложения\n \"id\": \"80a201ea-67e5-4cd9-aea5-591128d2855a\", //его id\n \"created\": \"2017-11-16 23:41:44\", //дата создания\n \"name\": \"test.doc\", //переданное название файла\n \"url\": \"/attachments/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\" //путь по которому доступен файл\n }], \n \"sensor_name_masks\":[ // Маски по названия датчиков\n {\"value\": \"Датчик1\"},\n {\"value\": \"Датчик2\"}\n ]\n \"geozones\": [{ // список выбранных геозон\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\"\n // --------------- полный перечень полей геозоны ---------------------\n }],\n \"default_template_table\": { //базовый шаблон таблицы, для базовой таблицы нет такого поля \n \"id\": \"800c0795-5b79-40cd-bdeb-ab309228534b\",\n \"name\": \"Поездки\"\n }\n \"show_itog\": true, //показывать ли итог в таблице отчета\n \"intervals_priority_high\": true, // Приоритетны ли интервалы отчета или смены\n \"time_group\": \"nogrouping\", //временная группировка. Возможные значения: Без групперовки, По дням, По неделям, По месяцам (берется из справочников по типу 'report_template_table_type')\n \"column_group\": \"name\", // ключ колонки, по которой происходит группировка\n \"used_geozones_filter\": true,//для включения фильтрации по геозонам, boolean.\n \"filter_geozones_type\": { //тип фильтрации по геозонам. Возможные значения получить из dictionaries, где type=filter_geozones_type\n \"key\": \"filter_geozones_include\",\n \"type\": \"filter_geozones_type\",\n \"value\": \"Включение\"\n },\n \"geozones\": [ //выбранные геозоны\n {\n \"id\": \"3fa1a644-bee4-4823-940b-b7542b3a9919\"\n },\n {\n \"id\": \"a671e052-f44d-4787-a3b4-6b3cac711a47\"\n }\n ], // geozones_groups если используются группы геозонов вместо геозоны.\n \"template_columns\": [{ //колонки талбицы отчета, первоначально колонки берутся из справочника (для каждой таблицы предустановлены колонки) ------ НЕИЗМЕНЯЕМОЕ КОЛИЧЕСТО КОЛОНОК --------\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\",\n \"name\": \"Имя\", //имя колонки\n \"filter_min\": 0, //фильтрация строк по минимальному значению\n \"filter_max\": 1000, //фильтрация строк по максимльному значению\n \"user_filter\": true // использовать фильтр для поля\n \"sort\": 0, //порядок колонки в отчете\n \"key\": \"name\", //ключ колонки ------ НЕИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"is_visible\": true //видима ли колонка в отчете \n }],\n \"template_sensors\": [{ // датчиковые поля\n \"id\": \"8f05e497-bddc-4b6a-bedb-e1c6ab5b55f0\",\n \"sensor_type\": { // тип датчика, справочник типа sensor_type\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": { //значение датчика, справочник типа template_sensor_value_type\n \"key\": \"template_sensor_first_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Начальное значение\"\n },\n \"name_mask\": \"Пробег\", //string, маска по имени\n \"column_name\": \"Среднее\" // Название колонки\n }, {\n \"id\": \"91100c04-9ca6-48b1-9201-715713d023cc\",\n \"sensor_type\": {\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": {\n \"key\": \"template_sensor_last_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Конечное значение\"\n },\n \"name_mask\": \"Пробег\",\n \"column_name\": \"Конечное\"\n }],\n \"template_computable_columns\": [// вычисляемые колонки\n {\n \"name\": \"Тип / марка машины\", // название колонки\n \"value\": \"custom_fields.brand_name\"// значение колонки\n \"total_ops\": \"take_first\" //способ формирования итога для этой колонки, получается из справочника type=report_column_total_type, отправляется ключ (key)\n },\n {\n \"name\": \"Расход по показаниям системы SKIF APP, л.\",\n \"value\": \"columns.sum_fillings\",\n \"total_ops\": \"sum\"\n },\n {\n \"name\": % экономии от SKIF APP\",\n \"value\": \"columns.sum_fillings_plan / columns.sum_fillings * 100 - 100\",\n \"total_ops\": \"max\"\n },\n ],\n \"weekdays\": [1,2,4,7], // \n \"crop_intervals\": true,// активировать обрезание интервалов\n \"time_intervals\": [ // временные интервалы для фильтрации\n {\n \"from\": \"10:00\",\n \"to\": \"12:00\"\n },\n {\n \"from\": \"15:30\",\n \"to\": \"17:45\"\n }\n ]\n }]\n}]\n\nЗапрос списка шаблонов отчетов
\nВсе также как и в /units/list.
\nВозможные значения:
SortField = [\"name\", \"\"]
Conditions.Field = [\"name\", \"\"]
Роль: Читатель и выше.
\n","urlObject":{"path":["api_v1","report_templates","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"88c8f156-2c31-4bb6-8671-f9722f5bf926"},{"name":"/report_templates/computable_table_fields?table_key=:table_key","id":"fdc09fbd-f565-4f7e-ac55-5239eee58c7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/report_templates/computable_table_fields?table_key=","description":"Получение возможных ссылок на значения для формулы в колонке отчета
\ntable_key - ключ таблицы
Возвращает все преобразования:
{\n \"custom_fields.fuel_fillings_minfilling\": \"Доп. поля объекта/Мин. объем заправки\",\n \"custom_fields.fuel_fillings_msgignorestart\": \"Доп. поля объекта/Игнор-ть сообщ-я после начала движения\",\n \"custom_fields.fuel_fillings_minstaytheft\": \"Доп. поля объекта/Мин. время остановки для опр-ия слива\",\n \"custom_fields.fuel_fillings_minitheft\": \"Доп. поля объекта/Мин. объем слива\",\n \"custom_fields.fuel_consumption_summerconsump\": \"Доп. поля объекта/Расход летом (л/100км.)\",\n \"custom_fields.fuel_consumption_winterconsump\": \"Доп. поля объекта/Расход зимой (л/100км.)\",\n \"custom_fields.fuel_math_idlingsummer\": \"Доп. поля объекта/На холостом ходу летом (л./час.)\",\n \"custom_fields.fuel_math_idlingwinter\": \"Доп. поля объекта/На холостом ходу зимой (л./час.)\",\n \"custom_fields.fuel_math_coeffunderload\": \"Доп. поля объекта/Коэф. при движении под нагрузкой\",\n \"custom_fields.fuel_consumption_winterfrom\": \"Доп. поля объекта/Первый месяц зимы (январь-1)\",\n \"custom_fields.fuel_consumption_winterto\": \"Доп. поля объекта/Последний месяц зимы (январь-1)\",\n \"custom_fields.fuel_price\": \"Доп. поля объекта/Стоимость (1 л.)\",\n \"custom_fields.tripdetector_minparktime\": \"Доп. поля объекта/Мин. время стоянки (сек)\",\n \"custom_fields.advanced_mileagecoeff\": \"Доп. поля объекта/Коэф. пробега\",\n \"custom_fields.tripdetector_minmovespeed\": \"Доп. поля объекта/Мин. скорость движ-я (км/ч)\",\n \"custom_fields.tripdetector_mintripdist\": \"Доп. поля объекта/Мин. расст-ие поездки (м)\",\n \"custom_fields.advanced_maxintervalmsg\": \"Доп. поля объекта/Макс. интервал между сообщ-ми (сек)\",\n \"custom_fields.tripdetector_maxdistancemsg\": \"Доп. поля объекта/Макс. расст-ие между сообщ-ми (м)\",\n \"custom_fields.tripdetector_mintriptime\": \"Доп. поля объекта/Мин. время поездки (сек)\",\n \"custom_fields.key_tripdetector_movedetect\": \"Доп. поля объекта/Опр-ие движ-я\",\n \"custom_fields.tripdetector_mileagedetect\": \"Доп. поля объекта/Определение пробега\",\n \"custom_fields.key_motohourdetector\": \"Доп. поля объекта/Определение моточасов\",\n \"custom_fields.analyst\": \"Доп. поля объекта/Аналитик\"\n \"custom_fields.installer\": \"Доп. поля объекта/Установщик\",\n \"custom_fields.install_date\": \"Доп. поля объекта/Дата установки\",\n \"custom_fields.install_place\": \"Доп. поля объекта/Место установки в ТС\",\n \"custom_fields.serial_number\": \"Доп. поля объекта/Серийный номер терминала\",\n \"custom_fields.serial_number_dut\": \"Доп. поля объекта/Серийный номер ДУТ\",\n \"custom_fields.dut_seal_serial_number\": \"Доп. поля объекта/Серийный номер пломбы ДУТ\",\n \"custom_fields.license_plate_number\": \"Доп. поля объекта/Гос номер\",\n \"custom_fields.hours_rate\": \"Доп. поля объекта/Норма часов в день\",\n \"custom_fields.block_date\": \"Доп. поля объекта/Дата блокировки(yyyy-MM-dd)\",\n \"custom_fields.kp\": \"Доп. поля объекта/КП\",\n \"custom_fields.dut\": \"Доп. поля объекта/ДУТ\",\n \"custom_fields.second_sim\": \"Доп. поля объекта/Вторая sim\",\n \"custom_fields.serial_number_dut_1\": \"Доп. поля объекта/Серийный номер ДУТ 1\",\n \"custom_fields.serial_number_dut_2\": \"Доп. поля объекта/Серийный номер ДУТ 2\",\n \"custom_fields.brand_name\": \"Доп. поля объекта/Тип/марка машины\",\n \"custom_fields.fuel_type\": \"Доп. поля объекта/Вид топлива (бенз., д/т)\",\n \"report_columns.unit_name\": \"Колонки отчета/Имя\",\n \"report_columns.first_datepoint\": \"Колонки отчета/Начало\",\n \"report_columns.last_datepoint\": \"Колонки отчета/Конец\",\n \"report_columns.count_point\": \"Колонки отчета/Кол-во сообщ-й\",\n \"report_columns.sum_distance\": \"Колонки отчета/Пробег\",\n \"report_columns.stucked_fillings\": \"Колонки отчета/Заправки\",\n \"report_columns.drained_fillings\": \"Колонки отчета/Сливы топл.\",\n \"report_columns.avg_speedkph\": \"Колонки отчета/Ср-яя скор-ть\",\n \"report_columns.fuel_price\": \"Колонки отчета/Затраты на топливо\",\n \"report_columns.fuel_price_plan\": \"Колонки отчета/Затраты на топл. по нормам\",\n \"report_columns.sum_fillings_idling\": \"Колонки отчета/Расход на холостом\",\n \"report_columns.sum_fillings_idling_plan\": \"Колонки отчета/Расход по нормам на холостом\",\n \"report_columns.sum_fillings_idling_deviation\": \"Колонки отчета/Откл. расхода на холостом\",\n \"report_columns.sum_fillings_plan\": \"Колонки отчета/Расход по нормам\",\n \"report_columns.sum_fillings\": \"Колонки отчета/Израсх-но топл.\",\n \"report_columns.sum_fillings_absolute\": \"Колонки отчета/Расход по ДАРТ\",\n \"report_columns.sum_fillings_instant\": \"Колонки отчета/Расход по ДМРТ\",\n \"report_columns.max_speedkph\": \"Колонки отчета/Макс. скор-ть\",\n \"report_columns.sum_fillings_deviation\": \"Колонки отчета/Отклонение расхода\",\n \"report_columns.first_fillings\": \"Колонки отчета/Нач. знач. топл.\",\n \"report_columns.finish_fillings\": \"Колонки отчета/Кон. знач. топл.\",\n \"report_columns.fuel_consumption_rates\": \"Колонки отчета/Расх. топл.(л\\100км)\",\n \"report_columns.motohour_idling\": \"Колонки отчета/Холостой ход\",\n \"report_columns.motohours\": \"Колонки отчета/Моточасы\",\n \"report_columns.motohour_moving\": \"Колонки отчета/В движении\",\n \"report_columns.driver\": \"Колонки отчета/Водитель\",\n \"report_columns.trailer\": \"Колонки отчета/Прицеп\",\n \"report_columns.work_types\": \"Колонки отчета/Вид работ\",\n \"report_columns.groups_of_unit\": \"Колонки отчета/Группы\"\n}\n\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","report_templates","computable_table_fields"],"host":["{{base_url}}"],"query":[{"key":"table_key","value":""}],"variable":[]}},"response":[],"_postman_id":"fdc09fbd-f565-4f7e-ac55-5239eee58c7d"},{"name":"/report_templates/excel_table_fields?table_key=:table_key","id":"36f026ad-6140-4146-be2a-446220693564","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/report_templates/excel_table_fields?table_key=","description":"Получение возможных ссылок на значения для формулы в шаблоне эксель
\ntable_key - ключ таблицы
Возвращает все возможные поля:
[\n {\n \"key\": \"company.name\",\n \"name\": \"Название компании\"\n },\n {\n \"key\": \"unit.name\",\n \"name\": \"Название объекта\"\n },\n {\n \"key\": \"unit.type\",\n \"name\": \"Тип объекта\"\n },\n {\n \"key\": \"shift.start_time\",\n \"name\": \"Запланированное время начала смена\"\n },\n {\n \"key\": \"shift.end_time\",\n \"name\": \"Запланированное время окончания смена\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minfilling\",\n \"name\": \"Доп. поля объекта/Мин. объем заправки\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_msgignorestart\",\n \"name\": \"Доп. поля объекта/Игнор-ть сообщ-я после начала движения(с)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minstaytheft\",\n \"name\": \"Доп. поля объекта/Мин. время остановки для опр-ия слива(с)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minitheft\",\n \"name\": \"Доп. поля объекта/Мин. объем слива\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_summerconsump\",\n \"name\": \"Доп. поля объекта/Расход летом (л/100км.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterconsump\",\n \"name\": \"Доп. поля объекта/Расход зимой (л/100км.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_idlingsummer\",\n \"name\": \"Доп. поля объекта/На холостом ходу летом (л./час.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_idlingwinter\",\n \"name\": \"Доп. поля объекта/На холостом ходу зимой (л./час.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_coeffunderload\",\n \"name\": \"Доп. поля объекта/Коэф. при движении под нагрузкой\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterfrom\",\n \"name\": \"Доп. поля объекта/Первый месяц зимы (январь-1)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterto\",\n \"name\": \"Доп. поля объекта/Последний месяц зимы (январь-1)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_price\",\n \"name\": \"Доп. поля объекта/Стоимость (1 л.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_type\",\n \"name\": \"Доп. поля объекта/Вид топлива (бенз., д/т)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_mark\",\n \"name\": \"Доп. поля объекта/Марка горючего\"\n },\n {\n \"key\": \"unit.custom_fields.fueler_distance\",\n \"name\": \"Доп. поля объекта/Радиус приближения как Топливозаправщик(м)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_minparktime\",\n \"name\": \"Доп. поля объекта/Мин. время стоянки (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.advanced_mileagecoeff\",\n \"name\": \"Доп. поля объекта/Коэф. пробега\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_minmovespeed\",\n \"name\": \"Доп. поля объекта/Мин. скорость движ-я (км/ч)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mintripdist\",\n \"name\": \"Доп. поля объекта/Мин. расст-ие поездки (м)\"\n },\n {\n \"key\": \"unit.custom_fields.advanced_maxintervalmsg\",\n \"name\": \"Доп. поля объекта/Макс. интервал между сообщ-ми (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_maxdistancemsg\",\n \"name\": \"Доп. поля объекта/Макс. расст-ие между сообщ-ми (м)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mintriptime\",\n \"name\": \"Доп. поля объекта/Мин. время поездки (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.key_tripdetector_movedetect\",\n \"name\": \"Доп. поля объекта/Опр-ие движ-я\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mileagedetect\",\n \"name\": \"Доп. поля объекта/Определение пробега\"\n },\n {\n \"key\": \"unit.custom_fields.key_motohourdetector\",\n \"name\": \"Доп. поля объекта/Определение моточасов\"\n },\n {\n \"key\": \"unit.custom_fields.analyst\",\n \"name\": \"Доп. поля объекта/Аналитик\"\n },\n {\n \"key\": \"unit.custom_fields.installer\",\n \"name\": \"Доп. поля объекта/Установщик\"\n },\n {\n \"key\": \"unit.custom_fields.install_date\",\n \"name\": \"Доп. поля объекта/Дата установки(формат год-месяц-день, например 2019-03-07)\"\n },\n {\n \"key\": \"unit.custom_fields.install_place\",\n \"name\": \"Доп. поля объекта/Место установки в ТС\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number\",\n \"name\": \"Доп. поля объекта/Серийный номер терминала\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.dut_seal_serial_number\",\n \"name\": \"Доп. поля объекта/Серийный номер пломбы ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.license_plate_number\",\n \"name\": \"Доп. поля объекта/Гос номер\"\n },\n {\n \"key\": \"unit.custom_fields.hours_rate\",\n \"name\": \"Доп. поля объекта/Норма часов в день\"\n },\n {\n \"key\": \"unit.custom_fields.block_date\",\n \"name\": \"Доп. поля объекта/Дата блокировки(формат год-месяц-день, например 2019-03-07)\"\n },\n {\n \"key\": \"unit.custom_fields.kp\",\n \"name\": \"Доп. поля объекта/КП\"\n },\n {\n \"key\": \"unit.custom_fields.dut\",\n \"name\": \"Доп. поля объекта/ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.second_sim\",\n \"name\": \"Доп. поля объекта/Вторая sim\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut_1\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ 1\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut_2\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ 2\"\n },\n {\n \"key\": \"unit.custom_fields.brand_name\",\n \"name\": \"Доп. поля объекта/Марка машины\"\n },\n {\n \"key\": \"unit.custom_fields.brand_code\",\n \"name\": \"Доп. поля объекта/Код марки\"\n },\n {\n \"key\": \"unit.custom_fields.video_device_name\",\n \"name\": \"Доп. поля объекта/Видео устройство\"\n },\n {\n \"key\": \"unit.custom_fields.video_device_id\",\n \"name\": \"Доп. поля объекта/ID-видео устройства\"\n },\n {\n \"key\": \"unit.custom_fields.video_cameras\",\n \"name\": \"Доп. поля объекта/Камеры\"\n },\n {\n \"key\": \"unit.custom_fields.max_speed\",\n \"name\": \"Доп. поля объекта/Максимальная скорость в сообщениях\"\n },\n {\n \"key\": \"unit.custom_fields.min_satellites\",\n \"name\": \"Доп. поля объекта/Минимальное количество спутников\"\n },\n {\n \"key\": \"unit.custom_fields.max_hdop\",\n \"name\": \"Доп. поля объекта/Максимальное значение dhop\"\n },\n {\n \"key\": \"report.unit_name\",\n \"name\": \"Колонки отчета/Имя\"\n },\n {\n \"key\": \"report.first_datepoint\",\n \"name\": \"Колонки отчета/Начало\"\n },\n {\n \"key\": \"report.last_datepoint\",\n \"name\": \"Колонки отчета/Конец\"\n },\n {\n \"key\": \"report.sum_datepoint\",\n \"name\": \"Колонки отчета/Длит-сть\"\n },\n {\n \"key\": \"report.driver\",\n \"name\": \"Колонки отчета/Водитель\"\n },\n {\n \"key\": \"report.first_address\",\n \"name\": \"Колонки отчета/Нач. адрес\"\n },\n {\n \"key\": \"report.first_fillings\",\n \"name\": \"Колонки отчета/Нач. знач. топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.finish_fillings\",\n \"name\": \"Колонки отчета/Кон. знач. топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.last_address\",\n \"name\": \"Колонки отчета/Кон. адрес\"\n },\n {\n \"key\": \"report.sum_fillings_plan_in_moving\",\n \"name\": \"Колонки отчета/Расход по нормам в движении\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_consumption_rates\",\n \"name\": \"Колонки отчета/Расх. топл.(л\\\\100км)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.avg_speedkph\",\n \"name\": \"Колонки отчета/Ср-яя скор-ть\"\n },\n {\n \"key\": \"report.sum_distance\",\n \"name\": \"Колонки отчета/Пробег(км)\"\n },\n {\n \"key\": \"report.drained_fillings\",\n \"name\": \"Колонки отчета/Сливы топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_absolute\",\n \"name\": \"Колонки отчета/Расход по ДАРТ\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_absolute\",\n \"name\": \"Колонки отчета/Пробег по датчику\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_absolute_error\",\n \"name\": \"Колонки отчета/Погрешность пробега по датчику(%)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings\",\n \"name\": \"Колонки отчета/Израсх-но топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_instant\",\n \"name\": \"Колонки отчета/Расход по ДМРТ\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_deviation\",\n \"name\": \"Колонки отчета/Отклонение расхода\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_plan\",\n \"name\": \"Колонки отчета/Расход по нормам\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_absolute_error\",\n \"name\": \"Колонки отчета/Погрешность расхода по ДАРТ(%)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_price_plan\",\n \"name\": \"Колонки отчета/Затраты на топл. по нормам\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_price\",\n \"name\": \"Колонки отчета/Затраты на топливо\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_consumption_rates_absolut\",\n \"name\": \"Колонки отчета/Расх. топл. по ДАРТ(л\\\\100км)\"\n },\n {\n \"key\": \"report.last_accumulate_sensor\",\n \"name\": \"Колонки отчета/Кон. знач. Накоп. датч.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.last_mileagecurr\",\n \"name\": \"Колонки отчета/Пробег\"\n },\n {\n \"key\": \"report.sum_accumulate_sensor\",\n \"name\": \"Колонки отчета/Накоп. датч. (сум)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.max_speedkph\",\n \"name\": \"Колонки отчета/Макс. скор-ть\"\n },\n {\n \"key\": \"report.sum_counter\",\n \"name\": \"Колонки отчета/Счетчик (сум)\"\n },\n {\n \"key\": \"report.count_point\",\n \"name\": \"Колонки отчета/Кол-во сообщ-й\"\n },\n {\n \"key\": \"report.first_accumulate_sensor\",\n \"name\": \"Колонки отчета/Нач. знач. Накоп. датч.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.max_temperature\",\n \"name\": \"Колонки отчета/Макс. темп.\"\n },\n {\n \"key\": \"report.min_temperature\",\n \"name\": \"Колонки отчета/Мин. темп.\"\n },\n {\n \"key\": \"report.avg_temperature\",\n \"name\": \"Колонки отчета/Ср-я темп.\"\n },\n {\n \"key\": \"report.last_stamp\",\n \"name\": \"Колонки отчета/Время приема\"\n },\n {\n \"key\": \"report.sharp_accel\",\n \"name\": \"Колонки отчета/Резкое ускорение\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sharp_braking\",\n \"name\": \"Колонки отчета/Резкое торможение\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sharp_turn\",\n \"name\": \"Колонки отчета/Резкий поворот\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.jump\",\n \"name\": \"Колонки отчета/Скачок\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.over_speed\",\n \"name\": \"Колонки отчета/Превышение скорости\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_corrected\",\n \"name\": \"Колонки отчета/Пробег (скоррект.)\"\n },\n {\n \"key\": \"report.violation_score\",\n \"name\": \"Колонки отчета/Балл нарушения\"\n },\n {\n \"key\": \"report.trailer\",\n \"name\": \"Колонки отчета/Прицеп\"\n },\n {\n \"key\": \"report.work_types\",\n \"name\": \"Колонки отчета/Вид работ\"\n },\n {\n \"key\": \"report.groups_of_unit\",\n \"name\": \"Колонки отчета/Группы\"\n }\n]\n\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","report_templates","excel_table_fields"],"host":["{{base_url}}"],"query":[{"key":"table_key","value":""}],"variable":[]}},"response":[],"_postman_id":"36f026ad-6140-4146-be2a-446220693564"},{"name":"/report_templates/excel_table_fields?table_id=:table_id","id":"824da988-e34b-44c6-b5f0-54733c29f61f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/report_templates/excel_table_fields?table_id=","description":"Получение возможных ссылок на значения для формулы в шаблоне эксель
\ntable_id - id таблицы
\nВозвращает все возможные поля в массиве:
\nkey - ключ колонки, текстовое поле
\nname - имя колонки, текстовое поле
\nhas_sensor - true, если для этого столбца можно указать датчик.
\ntype - ключ категории
\ntype_name - имя категории
\nРоль: Читатель и выше.
\nПример запроса:
\n\nОтвет:
\n[\n {\n \"key\": \"company.name\",\n \"name\": \"Название компании\"\n },\n {\n \"key\": \"unit.name\",\n \"name\": \"Название объекта\"\n },\n {\n \"key\": \"unit.type\",\n \"name\": \"Тип объекта\"\n },\n {\n \"key\": \"shift.start_time\",\n \"name\": \"Запланированное время начала смена\"\n },\n {\n \"key\": \"shift.end_time\",\n \"name\": \"Запланированное время окончания смена\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minfilling\",\n \"name\": \"Доп. поля объекта/Мин. объем заправки\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_msgignorestart\",\n \"name\": \"Доп. поля объекта/Игнор-ть сообщ-я после начала движения(с)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minstaytheft\",\n \"name\": \"Доп. поля объекта/Мин. время остановки для опр-ия слива(с)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_fillings_minitheft\",\n \"name\": \"Доп. поля объекта/Мин. объем слива\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_summerconsump\",\n \"name\": \"Доп. поля объекта/Расход летом (л/100км.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterconsump\",\n \"name\": \"Доп. поля объекта/Расход зимой (л/100км.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_idlingsummer\",\n \"name\": \"Доп. поля объекта/На холостом ходу летом (л./час.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_idlingwinter\",\n \"name\": \"Доп. поля объекта/На холостом ходу зимой (л./час.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_math_coeffunderload\",\n \"name\": \"Доп. поля объекта/Коэф. при движении под нагрузкой\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterfrom\",\n \"name\": \"Доп. поля объекта/Первый месяц зимы (январь-1)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_consumption_winterto\",\n \"name\": \"Доп. поля объекта/Последний месяц зимы (январь-1)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_price\",\n \"name\": \"Доп. поля объекта/Стоимость (1 л.)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_type\",\n \"name\": \"Доп. поля объекта/Вид топлива (бенз., д/т)\"\n },\n {\n \"key\": \"unit.custom_fields.fuel_mark\",\n \"name\": \"Доп. поля объекта/Марка горючего\"\n },\n {\n \"key\": \"unit.custom_fields.fueler_distance\",\n \"name\": \"Доп. поля объекта/Радиус приближения как Топливозаправщик(м)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_minparktime\",\n \"name\": \"Доп. поля объекта/Мин. время стоянки (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.advanced_mileagecoeff\",\n \"name\": \"Доп. поля объекта/Коэф. пробега\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_minmovespeed\",\n \"name\": \"Доп. поля объекта/Мин. скорость движ-я (км/ч)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mintripdist\",\n \"name\": \"Доп. поля объекта/Мин. расст-ие поездки (м)\"\n },\n {\n \"key\": \"unit.custom_fields.advanced_maxintervalmsg\",\n \"name\": \"Доп. поля объекта/Макс. интервал между сообщ-ми (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_maxdistancemsg\",\n \"name\": \"Доп. поля объекта/Макс. расст-ие между сообщ-ми (м)\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mintriptime\",\n \"name\": \"Доп. поля объекта/Мин. время поездки (сек)\"\n },\n {\n \"key\": \"unit.custom_fields.key_tripdetector_movedetect\",\n \"name\": \"Доп. поля объекта/Опр-ие движ-я\"\n },\n {\n \"key\": \"unit.custom_fields.tripdetector_mileagedetect\",\n \"name\": \"Доп. поля объекта/Определение пробега\"\n },\n {\n \"key\": \"unit.custom_fields.key_motohourdetector\",\n \"name\": \"Доп. поля объекта/Определение моточасов\"\n },\n {\n \"key\": \"unit.custom_fields.analyst\",\n \"name\": \"Доп. поля объекта/Аналитик\"\n },\n {\n \"key\": \"unit.custom_fields.installer\",\n \"name\": \"Доп. поля объекта/Установщик\"\n },\n {\n \"key\": \"unit.custom_fields.install_date\",\n \"name\": \"Доп. поля объекта/Дата установки(формат год-месяц-день, например 2019-03-07)\"\n },\n {\n \"key\": \"unit.custom_fields.install_place\",\n \"name\": \"Доп. поля объекта/Место установки в ТС\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number\",\n \"name\": \"Доп. поля объекта/Серийный номер терминала\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.dut_seal_serial_number\",\n \"name\": \"Доп. поля объекта/Серийный номер пломбы ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.license_plate_number\",\n \"name\": \"Доп. поля объекта/Гос номер\"\n },\n {\n \"key\": \"unit.custom_fields.hours_rate\",\n \"name\": \"Доп. поля объекта/Норма часов в день\"\n },\n {\n \"key\": \"unit.custom_fields.block_date\",\n \"name\": \"Доп. поля объекта/Дата блокировки(формат год-месяц-день, например 2019-03-07)\"\n },\n {\n \"key\": \"unit.custom_fields.kp\",\n \"name\": \"Доп. поля объекта/КП\"\n },\n {\n \"key\": \"unit.custom_fields.dut\",\n \"name\": \"Доп. поля объекта/ДУТ\"\n },\n {\n \"key\": \"unit.custom_fields.second_sim\",\n \"name\": \"Доп. поля объекта/Вторая sim\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut_1\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ 1\"\n },\n {\n \"key\": \"unit.custom_fields.serial_number_dut_2\",\n \"name\": \"Доп. поля объекта/Серийный номер ДУТ 2\"\n },\n {\n \"key\": \"unit.custom_fields.brand_name\",\n \"name\": \"Доп. поля объекта/Марка машины\"\n },\n {\n \"key\": \"unit.custom_fields.brand_code\",\n \"name\": \"Доп. поля объекта/Код марки\"\n },\n {\n \"key\": \"unit.custom_fields.video_device_name\",\n \"name\": \"Доп. поля объекта/Видео устройство\"\n },\n {\n \"key\": \"unit.custom_fields.video_device_id\",\n \"name\": \"Доп. поля объекта/ID-видео устройства\"\n },\n {\n \"key\": \"unit.custom_fields.video_cameras\",\n \"name\": \"Доп. поля объекта/Камеры\"\n },\n {\n \"key\": \"unit.custom_fields.max_speed\",\n \"name\": \"Доп. поля объекта/Максимальная скорость в сообщениях\"\n },\n {\n \"key\": \"unit.custom_fields.min_satellites\",\n \"name\": \"Доп. поля объекта/Минимальное количество спутников\"\n },\n {\n \"key\": \"unit.custom_fields.max_hdop\",\n \"name\": \"Доп. поля объекта/Максимальное значение dhop\"\n },\n {\n \"key\": \"report.unit_name\",\n \"name\": \"Колонки отчета/Имя\"\n },\n {\n \"key\": \"report.first_datepoint\",\n \"name\": \"Колонки отчета/Начало\"\n },\n {\n \"key\": \"report.last_datepoint\",\n \"name\": \"Колонки отчета/Конец\"\n },\n {\n \"key\": \"report.sum_datepoint\",\n \"name\": \"Колонки отчета/Длит-сть\"\n },\n {\n \"key\": \"report.driver\",\n \"name\": \"Колонки отчета/Водитель\"\n },\n {\n \"key\": \"report.first_address\",\n \"name\": \"Колонки отчета/Нач. адрес\"\n },\n {\n \"key\": \"report.first_fillings\",\n \"name\": \"Колонки отчета/Нач. знач. топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.finish_fillings\",\n \"name\": \"Колонки отчета/Кон. знач. топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.last_address\",\n \"name\": \"Колонки отчета/Кон. адрес\"\n },\n {\n \"key\": \"report.sum_fillings_plan_in_moving\",\n \"name\": \"Колонки отчета/Расход по нормам в движении\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_consumption_rates\",\n \"name\": \"Колонки отчета/Расх. топл.(л\\\\100км)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.avg_speedkph\",\n \"name\": \"Колонки отчета/Ср-яя скор-ть\"\n },\n {\n \"key\": \"report.sum_distance\",\n \"name\": \"Колонки отчета/Пробег(км)\"\n },\n {\n \"key\": \"report.drained_fillings\",\n \"name\": \"Колонки отчета/Сливы топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_absolute\",\n \"name\": \"Колонки отчета/Расход по ДАРТ\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_absolute\",\n \"name\": \"Колонки отчета/Пробег по датчику\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_absolute_error\",\n \"name\": \"Колонки отчета/Погрешность пробега по датчику(%)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings\",\n \"name\": \"Колонки отчета/Израсх-но топл.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_instant\",\n \"name\": \"Колонки отчета/Расход по ДМРТ\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_deviation\",\n \"name\": \"Колонки отчета/Отклонение расхода\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_plan\",\n \"name\": \"Колонки отчета/Расход по нормам\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_fillings_absolute_error\",\n \"name\": \"Колонки отчета/Погрешность расхода по ДАРТ(%)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_price_plan\",\n \"name\": \"Колонки отчета/Затраты на топл. по нормам\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_price\",\n \"name\": \"Колонки отчета/Затраты на топливо\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.fuel_consumption_rates_absolut\",\n \"name\": \"Колонки отчета/Расх. топл. по ДАРТ(л\\\\100км)\"\n },\n {\n \"key\": \"report.last_accumulate_sensor\",\n \"name\": \"Колонки отчета/Кон. знач. Накоп. датч.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.last_mileagecurr\",\n \"name\": \"Колонки отчета/Пробег\"\n },\n {\n \"key\": \"report.sum_accumulate_sensor\",\n \"name\": \"Колонки отчета/Накоп. датч. (сум)\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.max_speedkph\",\n \"name\": \"Колонки отчета/Макс. скор-ть\"\n },\n {\n \"key\": \"report.sum_counter\",\n \"name\": \"Колонки отчета/Счетчик (сум)\"\n },\n {\n \"key\": \"report.count_point\",\n \"name\": \"Колонки отчета/Кол-во сообщ-й\"\n },\n {\n \"key\": \"report.first_accumulate_sensor\",\n \"name\": \"Колонки отчета/Нач. знач. Накоп. датч.\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.max_temperature\",\n \"name\": \"Колонки отчета/Макс. темп.\"\n },\n {\n \"key\": \"report.min_temperature\",\n \"name\": \"Колонки отчета/Мин. темп.\"\n },\n {\n \"key\": \"report.avg_temperature\",\n \"name\": \"Колонки отчета/Ср-я темп.\"\n },\n {\n \"key\": \"report.last_stamp\",\n \"name\": \"Колонки отчета/Время приема\"\n },\n {\n \"key\": \"report.sharp_accel\",\n \"name\": \"Колонки отчета/Резкое ускорение\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sharp_braking\",\n \"name\": \"Колонки отчета/Резкое торможение\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sharp_turn\",\n \"name\": \"Колонки отчета/Резкий поворот\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.jump\",\n \"name\": \"Колонки отчета/Скачок\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.over_speed\",\n \"name\": \"Колонки отчета/Превышение скорости\",\n \"has_sensor\": true\n },\n {\n \"key\": \"report.sum_distance_corrected\",\n \"name\": \"Колонки отчета/Пробег (скоррект.)\"\n },\n {\n \"key\": \"report.violation_score\",\n \"name\": \"Колонки отчета/Балл нарушения\"\n },\n {\n \"key\": \"report.trailer\",\n \"name\": \"Колонки отчета/Прицеп\"\n },\n {\n \"key\": \"report.work_types\",\n \"name\": \"Колонки отчета/Вид работ\"\n },\n {\n \"key\": \"report.groups_of_unit\",\n \"name\": \"Колонки отчета/Группы\"\n }\n]\n\nПроверка формулы в колонке отчета
\n\"table_key\" - ключ таблицы, текстовое.
\"formula\" - формула, которую нужно проверить.
Роль: Редактор и выше.
\nВозвращает 200, если формула валидная, иначе 422 с текстом ошибки
\n{\n \"table_key\": \"trips\",\n \"formula\": \"({report_columns.sum_fillings_plan} - {report_columns.sum_fillings}) * {custom_fields.fuel_price} / 1000.\"\n}\n\nОтвет 200:
\n{\n \"table_key\": \"trips\",\n \"formula\": \"xyz\"\n}\n\nОтвет 422
\n{\n \"code\": 4220,\n \"field\": \"\",\n \"message\": \"Неправильная формула в таблице \"Поездки\"\"\n}\n\nВалидация отдельной таблицы
\nВ теле запроса указать все поля таблицы.
Возвращает 200, если формула валидная, иначе 422 с текстом ошибки.
Роль: Редактор и выше.
\n{\n \"name\": \"Поездки\",\n \"key\": \"trips\",\n \"show_itog\": \"true\",\n \"time_group\": \"week\",\n \"column_group\": \"\",\n \"template_sensors\": [{\n \"sensor_type\": {\n \"key\": \"fuelsensor\"\n },\n \"name_mask\": \"топлива\",\n \"column_name\": \"Начала топл\",\n \"sensor_value\": {\n \"key\": \"template_sensor_first_value\"\n }\n }, {\n \"sensor_type\": {\n \"key\": \"ignition\"\n },\n \"name_mask\": \"Зажи1\",\n \"sensor_value\": {\n \"key\": \"template_sensor_last_value\"\n }\n }],\n \"template_computable_columns\": [{\n \"name\": \"Тип / марка машины\",\n \"value\": \"{custom_fields.brand_name}\"\n }, {\n \"name\": \"Расход по показаниям системы SKIF APP, л.\",\n \"value\": \"{report_columns.sum_fillings}\"\n }, {\n \"name\": \"Расход по базовой норме, л.\",\n \"value\": \"{report_columns.sum_fillings_plan}\"\n }, {\n \"name\": \"Экономия, л.\",\n \"value\": \"{report_columns.sum_fillings_plan} - {report_columns.sum_fillings}\"\n }, {\n \"name\": \"% экономии от SKIF APP\",\n \"value\": \"{report_columns.sum_fillings_plan} / {report_columns.sum_fillings} * 100 - 100\"\n }, {\n \"name\": \"Экономия в тыс.тг.\",\n \"value\": \"({report_columns.sum_fillings_plan} - {report_columns.sum_fillings}) * {custom_fields.fuel_price} / 1000.\"\n }, {\n \"name\": \"Тестовая колонка\",\n \"value\": \"({sensors.Начала топл} - {report_columns.sum_fillings}) * {computable_columns.Экономия в тыс.тг.}\"\n }],\n \"template_columns\": [{\n \"name\": \"translate.reports.default_template.columns._unit_id\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"1\",\n \"key\": \"_unit_id\",\n \"is_visible\": \"false\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.unit_name\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2\",\n \"key\": \"unit_name\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.first_datepoint\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"3\",\n \"key\": \"first_datepoint\",\n \"is_visible\": \"true\",\n \"type\": \"date\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.last_datepoint\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"4\",\n \"key\": \"last_datepoint\",\n \"is_visible\": \"true\",\n \"type\": \"date\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.count_point\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"5\",\n \"key\": \"count_point\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_distance\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"6\",\n \"key\": \"sum_distance\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n }, {\n \"name\": \"translate.reports.default_template.columns.stucked_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"100000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"stucked_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.drained_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"100000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"drained_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.avg_speedkph\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"avg_speedkph\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_deviation\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_deviation\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_absolute\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_absolute\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_instant\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_instant\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_distance_absolute_error\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_distance_absolute_error\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_distance_absolute\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_distance_absolute\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n }, {\n \"name\": \"translate.reports.default_template.columns.max_speedkph\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"max_speedkph\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling_deviation\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling_deviation\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.fuel_price_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"fuel_price_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.fuel_price\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"fuel_price\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_absolute_error\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"9\",\n \"key\": \"sum_fillings_absolute_error\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.first_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"9\",\n \"key\": \"first_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.finish_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"10\",\n \"key\": \"finish_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.fuel_consumption_rates\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"11\",\n \"key\": \"fuel_consumption_rates\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.fuel_consumption_rates_absolut\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"fuel_consumption_rates_absolut\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.motohour_idling\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"motohour_idling\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n }, {\n \"name\": \"translate.reports.default_template.columns.motohours\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"motohours\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n }, {\n \"name\": \"translate.reports.default_template.columns.motohour_moving\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"13\",\n \"key\": \"motohour_moving\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n }, {\n \"name\": \"translate.reports.default_template.columns.driver\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2000\",\n \"key\": \"driver\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.trailer\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2100\",\n \"key\": \"trailer\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.work_types\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2200\",\n \"key\": \"work_types\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }, {\n \"name\": \"translate.reports.default_template.columns.groups_of_unit\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"3000\",\n \"key\": \"groups_of_unit\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }]\n}\n\nОтвет 200
\n{\n \"name\": \"Поездки\",\n \"key\": \"trips\",\n \"show_itog\": \"true\",\n \"time_group\": \"week\",\n \"column_group\": \"\",\n \"template_computable_columns\": [\n {\n \"name\": \"Тестовая колонка\",\n \"value\": \"(1000 - {report_columns.sum_fillings}) * {computable_columns.Тестовая колонка2}\"\n },\n {\n \"name\": \"Тестовая колонка2\",\n \"value\": \"(300 + {report_columns.sum_fillings}) * {computable_columns.Тестовая колонка3}\"\n },\n {\n \"name\": \"Тестовая колонка3\",\n \"value\": \"(1000 - {report_columns.sum_fillings}) * {computable_columns.Тестовая колонка}\"\n }\n ],\n \"template_columns\": [\n {\n \"name\": \"translate.reports.default_template.columns._unit_id\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"1\",\n \"key\": \"_unit_id\",\n \"is_visible\": \"false\",\n \"type\": \"string\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.unit_name\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2\",\n \"key\": \"unit_name\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.first_datepoint\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"3\",\n \"key\": \"first_datepoint\",\n \"is_visible\": \"true\",\n \"type\": \"date\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.last_datepoint\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"4\",\n \"key\": \"last_datepoint\",\n \"is_visible\": \"true\",\n \"type\": \"date\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.count_point\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"5\",\n \"key\": \"count_point\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_distance\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"6\",\n \"key\": \"sum_distance\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.avg_speedkph\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"avg_speedkph\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.drained_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"100000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"drained_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.stucked_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"100000\",\n \"use_filter\": null,\n \"sort\": \"7\",\n \"key\": \"stucked_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_distance_absolute_error\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_distance_absolute_error\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_distance_absolute\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_distance_absolute\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.max_speedkph\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"max_speedkph\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"trips\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_idling_deviation\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_idling_deviation\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.fuel_price_plan\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"fuel_price_plan\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.fuel_price\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"fuel_price\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_absolute\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_absolute\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_instant\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_instant\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_deviation\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"8\",\n \"key\": \"sum_fillings_deviation\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.sum_fillings_absolute_error\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"9\",\n \"key\": \"sum_fillings_absolute_error\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.first_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"9\",\n \"key\": \"first_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.finish_fillings\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"10\",\n \"key\": \"finish_fillings\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.fuel_consumption_rates\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"11\",\n \"key\": \"fuel_consumption_rates\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.motohours\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"motohours\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.motohour_idling\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"motohour_idling\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.fuel_consumption_rates_absolut\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"12\",\n \"key\": \"fuel_consumption_rates_absolut\",\n \"is_visible\": \"true\",\n \"type\": \"number\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.motohour_moving\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"13\",\n \"key\": \"motohour_moving\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"motohour\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.driver\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2000\",\n \"key\": \"driver\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.trailer\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2100\",\n \"key\": \"trailer\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.work_types\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"2200\",\n \"key\": \"work_types\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n },\n {\n \"name\": \"translate.reports.default_template.columns.groups_of_unit\",\n \"filter_min\": \"0\",\n \"filter_max\": \"1000\",\n \"use_filter\": null,\n \"sort\": \"3000\",\n \"key\": \"groups_of_unit\",\n \"is_visible\": \"true\",\n \"type\": \"string\",\n \"meta\": \"total\"\n }\n ]\n}\n\nОтвет 422
\n{\n \"errors\": [\n {\n \"code\": 4221,\n \"field\": \"\",\n \"message\": \"В дополнительных колонок таблицы Поездки есть циклические зависимости: Тестовая колонка->Тестовая колонка2->Тестовая колонка3->Тестовая колонка\"\n }\n ],\n \"code\": 4220,\n \"message\": \"В дополнительных колонок таблицы Поездки есть циклические зависимости: Тестовая колонка->Тестовая колонка2->Тестовая колонка3->Тестовая колонка\"\n}\n\nУдаление шаблона
\nУдаление физическое. При успехе - ответ 200
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","report_templates",":template_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID шаблона
\n","type":"text/plain"},"type":"any","value":"","key":"template_id"}]}},"response":[],"_postman_id":"5d6e0fab-83c7-4d6a-a373-2045b3022511"},{"name":"/report_templates?ids=:ids","id":"96236b64-7e74-41cf-9b97-34c7f8e0f423","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/report_templates?ids=","description":"Планирование удаление шаблона отчетов
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","report_templates"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"96236b64-7e74-41cf-9b97-34c7f8e0f423"},{"name":"/report_templates","id":"cf249ff2-3a1a-4260-8c1c-da0d0e321b77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/report_templates","description":"Планирование удаления шаблона отчетов
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","report_templates"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cf249ff2-3a1a-4260-8c1c-da0d0e321b77"},{"name":"/report_templates/:template_id","id":"3b64cc3f-1a1b-47ef-9408-ba3720e954b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/report_templates/:template_id","description":"Создает свой шаблон отчетов
\nПо правилам, таблица шаблона должна строится на основании дефолтного шаблона таблиц, т.е. путем копирования полей дефолтного шаблона и заполнения их пользовательскими значениями
(кроме поля 'key').
Запрос для создания пустого шаблона:
\n{\"name\": \"Имя_шаблона\", \"template_tables\": []}\n\nРоль: Редактор и выше.
\nОтвет:
\n[{\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id шаблона\n \"name\": \"шаблон2\", //имя\n \"template_tables\": [{\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\", //id таблицы\n \"id_template\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\", //id родительского шаблона\n \"name\": \"Уведомления\", //имя таблицы\n \"attachments\": [{\n \"id\": \"80a201ea-67e5-4cd9-aea5-591128d2855a\", //его id\n \"created\": \"2017-11-16 23:41:44\", //дата создания\n \"name\": \"test.doc\", //переданное название файла\n \"url\": \"/attachments/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\" //путь, по которому доступен файл\n }], //вложения\n \"key\": \"notifications\", //ключ таблицы (берется из справочников по типу 'report_template_table_type') ------ НЕИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"geozones\": [{ // список выбранных геозон\n \"id\": \"d3134efa-9e9f-4be1-9459-1ded125ea73a\"\n // --------------- полный перечень полей геозоны ---------------------\n }],\n \"template_sensors\": [{\n \"id\": \"8f05e497-bddc-4b6a-bedb-e1c6ab5b55f0\",\n \"sensor_type\": { // тип датчика, справочник типа sensor_type\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": { //значение датчика, справочник типа template_sensor_value_type\n \"key\": \"template_sensor_first_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Начальное значение\"\n },\n \"name_mask\": \"Пробег\" //string, маска по имени\n }, {\n \"id\": \"91100c04-9ca6-48b1-9201-715713d023cc\",\n \"sensor_type\": {\n \"key\": \"digital_sensors\",\n \"type\": \"sensor_type\",\n \"value\": \"Датчик\"\n },\n \"sensor_value\": {\n \"key\": \"template_sensor_last_value\",\n \"type\": \"template_sensor_value_type\",\n \"value\": \"Конечное значение\"\n },\n \"name_mask\": \"Пробег\"\n }],\n \"show_itog\": true, //показывать ли итог в таблице отчета\n \"time_group\": \"nogrouping\", //временная группировка. Возможные значения: Без групперовки, По дням, По неделям, По месяцам (берется из справочников по типу 'report_template_table_type')\n \"column_group\": \"name\", // ключ колонки, по которой происходит группировка\n \"template_columns\": [{ //колонки таблицы отчета, первоначально колонки берутся из справочника (для каждой таблицы предустановлены колонки) ------ НЕИЗМЕНЯЕМОЕ КОЛИЧЕСТО КОЛОНОК --------\n \"id\": \"27aaa1b1-0510-4b7b-b020-99837f5621f0\",\n \"name\": \"Имя\", //имя колонки\n \"filter_min\": 0, //фильтрация строк по минимальному значению\n \"filter_max\": 1000, //фильтрация строк по максимльному значению\n \"sort\": 0, //порядок колонки в отчете\n \"key\": \"name\", //ключ колонки ------ НЕИЗМЕНЯЕМОЕ ПОЛЕ --------\n \"is_visible\": true //видима ли колонка в отчете \n }]\n }]\n}]\n\nID шаблона
\n","type":"text/plain"},"type":"any","value":"","key":"template_id"}]}},"response":[],"_postman_id":"3b64cc3f-1a1b-47ef-9408-ba3720e954b7"},{"name":"/report_templates/time_groups?table_key=Получение списка группировок для таблицы отчета
\nПример запроса:
\nhttps://dev5.skif.pro/api_v1/report_templates/time_groups?table_key=trips
\nВозвращается массив, каждый элемент которого имеет поля key и name.
\nРоль: Читатель и выше.
\nПример ответа:
\n[\n {\n \"key\": \"day\",\n \"name\": \"По дням\"\n },\n {\n \"key\": \"week\",\n \"name\": \"По неделям\"\n },\n {\n \"key\": \"month\",\n \"name\": \"По месяцам\"\n },\n {\n \"key\": \"unit\",\n \"name\": \"По объектам\"\n },\n {\n \"key\": \"driver\",\n \"name\": \"По водителям\"\n },\n {\n \"key\": \"shift\",\n \"name\": \"По сменам\"\n }\n]\n\nИзменение порядка шаблонов отчетов
\nВ теле запроса в поле order необходимо отправить идентификаторы шаблонов (поле id) в желаемом порядке.
\nРоль: Редактор и выше.
\nПример запроса:
\nPATCH https://dev5.skif.pro/api_v1/report_templates/reorder
\n{\n \"order\": [\n \"9341dc4e-e7f1-4695-b166-5c84dce2a199\",\n \"2f25afc4-42e5-40bc-b6c4-4f41c6ff3b5a\",\n \"a53a0781-7064-4a50-a190-432bf0e8338c\",\n \"13fb2731-4a0f-427d-af66-b16107d1d936\"\n ]\n}\n\nВозвращает ответ 200 без тела в случае успеха или ошибку с текстом.
\n","urlObject":{"path":["api_v1","report_templates","reorder"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3c45b981-2570-43c4-8721-52c50e51ad54"}],"id":"2ac40dae-8a76-45b8-951d-94186dec5ce9","_postman_id":"2ac40dae-8a76-45b8-951d-94186dec5ce9","description":""},{"name":"Треки","item":[{"name":"/fasttracks","id":"21209019-96de-43ef-a994-a93e31fe98ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"zoom\": 14,\n\t\"units\": [{\n\t\t\"id\": \"350d511c-ed5f-424f-91f2-2b9259271ba6\"\n\t}],\n\t\"from\": \"2021-05-03 00:00:00\",\n\t\"to\": \"2021-05-24 00:00:00\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/fasttracks","description":"Запрос на получение трека юнита
\nЗапрос состоит из 4 параметров.
\nunits - id объекта, берется всегда ПЕРВЫЙ объект, передавать несколько объектов не имеет смысла.
\nfrom - начало периода
\nto - конец периода
\nzoom - зумирование трека. Чем выше значение, тем больше точек будет пропущено (исключено из выборки) и тем менее точным будет сам трек. По сути, это площадь вокруг текущей точки. Будет отрисована та следующая точка, которая не попадёт в эту площадь, т.е. некий шаг пропуска.
\nВесь трек состоит из суб-треков, так называемых отрезков, которые в свою очередь состоят из конкретных точек, в которых содержится информация о состоянии объекта в конкретный момент времени.
\nОтвет имеет две колонки: columns и values.
\nprocess_id - уникальный идентификатор для выделение трека в области карты.
\nColumns - это набор полей объекта. Данная колонка всегда статична, поэтому индекс поля в этой колонке всегда равен индексу поля в конкретных точках (т.е. Если longitude в Columns имеет индекс 2, то в каждой точке мы найдем конкретное значение для longitude под индексом 2).
\nПример ответа:
\n{\n \"columns\": [\n {\n \"key\": \"datepoint\",\n \"value\": \"Дата\"\n },\n {\n \"key\": \"longitude\",\n \"value\": \"Широта\"\n },\n {\n \"key\": \"latitude\",\n \"value\": \"Долгота\"\n },\n {\n \"key\": \"speed\",\n \"value\": \"Скорость\"\n },\n {\n \"key\": \"angle\",\n \"value\": \"Угол\"\n },\n {\n \"key\": \"distance\",\n \"value\": \"Дистанция\"\n }\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578131434,\n 63.5339,\n 53.1475,\n 0,\n 101,\n 0\n ],\n [\n 1578198784,\n 63.5347,\n 53.1472,\n 0,\n 159,\n 62.35\n ],\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 118.67\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 1682.05\n ],\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 1682.05\n ]\n ]\n },\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 742.77\n ],\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 742.77\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 1800.23\n ],\n [\n 1578199320,\n 63.5797,\n 53.1518,\n 43,\n 30,\n 1800.23\n ],\n [\n 1578199513,\n 63.5941,\n 53.1667,\n 51,\n 25,\n 1921.08\n ]\n ]\n }\n\nЗапрос на получение трека в прямоугольной области карты
\nЗапрос состоит из 2 параметров:
\nprocess_id - уникальный идентификатор, полученный в ответе на запрос /fasttracks .
\nbox - массив [latitude1, longitude1, latitude2, longitude2].
\nlatitude1, longitude1 - координаты нижнего левого угла прямоугольника.
\nlatitude2, longitude2 - координаты верхного правого угла прямоугольника.
\nzoom - зумирование .
\nОтвет имеет такую же структуру, как в запросе POST /fasttracks.
\nПример запроса:
\n{\n \"process_id\": \"fed93e82-6c86-4cfd-bcf2-637bd3dfecaa\",\n \"box\": [\n 55.775519, 37.934139, 55.956245, 38.342490\n ],\n \"zoom\": 18\n}\n\nПример ответа:
\n{\n \"columns\": [\n {\n \"key\": \"datepoint\",\n \"value\": \"Дата\"\n },\n {\n \"key\": \"longitude\",\n \"value\": \"Широта\"\n },\n {\n \"key\": \"latitude\",\n \"value\": \"Долгота\"\n },\n {\n \"key\": \"speed\",\n \"value\": \"Скорость\"\n },\n {\n \"key\": \"angle\",\n \"value\": \"Угол\"\n },\n {\n \"key\": \"distance\",\n \"value\": \"Дистанция\"\n }\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578131434,\n 63.5339,\n 53.1475,\n 0,\n 101,\n 0\n ],\n [\n 1578198784,\n 63.5347,\n 53.1472,\n 0,\n 159,\n 62.35\n ],\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 118.67\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 1682.05\n ],\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 1682.05\n ]\n ]\n },\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 742.77\n ],\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 742.77\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 1800.23\n ],\n [\n 1578199320,\n 63.5797,\n 53.1518,\n 43,\n 30,\n 1800.23\n ],\n [\n 1578199513,\n 63.5941,\n 53.1667,\n 51,\n 25,\n 1921.08\n ]\n ]\n }\n\nЗапрос на получение трека юнита
\nЗапрос состоит из 4 параметров:
\nЕсли нужен трек для несколько объектов, то необходимо передать ID объектов в units : \"units\": [{\"id\": \"c4e945a2-eb38-448c-b843-c2a5c72f55eb\"}, {\"id\", \"992806ef-ed56-492f-9787-3963f1db53fa\"}, ...]
\nЕсли нужен трек для группы объектов, то необходимо передать groups: \"groups\": [{\"id\": \"7e58cc3c-2ce3-4597-80da-ed63e5d64c8a\"}]
\nfrom - начало периода
\nto - конец периода
\nzoom - зумирование трека. Чем выше значение, тем больше точек будет пропущено (исключено из выборки) и тем менее точным будет сам трек. По сути, это площадь вокруг текущей точки. Будет отрисована та следующая точка, которая не попадёт в эту площадь, т.е. некий шаг пропуска.
\nВесь трек состоит из суб-треков, так называемых отрезков, которые в свою очередь состоят из конкретных точек, в которых содержится информация о состоянии объекта в конкретный момент времени.
\nОтвет имеет массив результатов.
Каждый эдемент массива:
unit_id, unit_name, color, columns и values.
unit_id - ID объекта,
unit_name - имя объекта,
color - цвет трека
Columns - это набор полей объекта. Данная колонка всегда статична, поэтому индекс поля в этой колонке всегда равен индексу поля в конкретных точках (т.е. если longitude в Columns имеет индекс 2, то в каждой точке мы найдем конкретное значение для longitude под индексом 2).
Пример запроса:
\n{ \n 'units': [{'id': '712ceae4-f112-4714-9a4d-afe141e47bf7'}, {'id': 'fc0a7f07-f04f-42de-8b77-9d0625a163c4'}],\n 'from': '2020-01-01 00:00:00',\n 'to': '2020-01-30 00:00:00',\n 'zoom': 1000 \n}\n\nПример ответа:
\n[\n{\n \"unit_id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\",\n \"unit_name\": \"unit1\",\n \"color\": \"#641e16\",\n \"columns\": [\n {\n \"key\": \"datepoint\",\n \"value\": \"Дата\"\n },\n {\n \"key\": \"longitude\",\n \"value\": \"Широта\"\n },\n {\n \"key\": \"latitude\",\n \"value\": \"Долгота\"\n },\n {\n \"key\": \"speed\",\n \"value\": \"Скорость\"\n },\n {\n \"key\": \"angle\",\n \"value\": \"Угол\"\n },\n {\n \"key\": \"distance\",\n \"value\": \"Дистанция\"\n }\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578131434,\n 63.5339,\n 53.1475,\n 0,\n 101,\n 0\n ],\n [\n 1578198784,\n 63.5347,\n 53.1472,\n 0,\n 159,\n 62.35\n ],\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 118.67\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 1682.05\n ],\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 1682.05\n ]\n ]\n },\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 742.77\n ],\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 742.77\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 1800.23\n ],\n [\n 1578199320,\n 63.5797,\n 53.1518,\n 43,\n 30,\n 1800.23\n ],\n [\n 1578199513,\n 63.5941,\n 53.1667,\n 51,\n 25,\n 1921.08\n ]\n ]\n },\n {\n \"unit_id\": \"fc0a7f07-f04f-42de-8b77-9d0625a163c4\",\n \"unit_name\": \"unit2\",\n \"color\": \"#641e16\",\n \"columns\": [\n {\n \"key\": \"datepoint\",\n \"value\": \"Дата\"\n },\n {\n \"key\": \"longitude\",\n \"value\": \"Широта\"\n },\n {\n \"key\": \"latitude\",\n \"value\": \"Долгота\"\n },\n {\n \"key\": \"speed\",\n \"value\": \"Скорость\"\n },\n {\n \"key\": \"angle\",\n \"value\": \"Угол\"\n },\n {\n \"key\": \"distance\",\n \"value\": \"Дистанция\"\n }\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578131434,\n 63.5339,\n 53.1475,\n 0,\n 101,\n 0\n ],\n [\n 1578198784,\n 63.5347,\n 53.1472,\n 0,\n 159,\n 62.35\n ],\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 118.67\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578198974,\n 63.5337,\n 53.1464,\n 17,\n 160,\n 1682.05\n ],\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 1682.05\n ]\n ]\n },\n {\n \"style\": \"style_0\",\n \"points\": [\n [\n 1578199107,\n 63.5548,\n 53.1381,\n 51,\n 132,\n 742.77\n ],\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 742.77\n ]\n ]\n },\n {\n \"style\": \"style_40\",\n \"points\": [\n [\n 1578199192,\n 63.5659,\n 53.1379,\n 39,\n 11,\n 1800.23\n ],\n [\n 1578199320,\n 63.5797,\n 53.1518,\n 43,\n 30,\n 1800.23\n ],\n [\n 1578199513,\n 63.5941,\n 53.1667,\n 51,\n 25,\n 1921.08\n ]\n ]\n }\n]\n\nПолучение краткой информации (аннотации) о конкретной/последней точке
\nПараметр \"from\" должен быть равен или быть максимально приближен к искомой точке. Если данный параметр отсутствует, то возвращается последняя точка объекта.
\n","urlObject":{"path":["api_v1","point"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"75b5fd4a-1478-4d06-abde-a7383b2f4f1e"},{"name":"/point/batch","id":"e919c212-c532-40e9-8ca2-cd11de02707a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"\n{\n \"from\":\"2020-04-07 07:41:35\",\n \"units\":[\n {\n \"id\":\"31e92253-1e70-4bb2-9b6f-385e9eed9ba4\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/point/batch","description":"Получение краткой информации (аннотации) о конкретной/последней точке для нескольк объектов
\nПараметр \"from\" должен быть равен или быть максимально приближен к искомой точке. Если данный параметр отсутствует, то возвращается последняя точка объекта.
\nПример запроса:
\n{\n \"units\":[\n {\n \"id\": \"eb74af80-32eb-48a5-aea4-00ed26fa1d21\"\n },\n {\n \"id\": \"d8497f29-5eb8-4810-9931-3f1ac05aeef4\"\n }\n ]\n}\n\nОтвет возвращает массив JSON, каждый элемент которого представляет собой аннотацию об объекте.
\nПример ответа:
\n[\n {\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"Урал АТЗ М199ХМ 124\",\n \"group\": \"main\"\n }\n ]\n },\n {\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"KAMAZ (без номера) 22.06.2020\",\n \"group\": \"main\"\n },\n {\n \"key\": \"datepoint\",\n \"name\": \"Дата и время\",\n \"value\": \"2024-10-15 05:17:56\",\n \"group\": \"main\"\n },\n {\n \"key\": \"_datepoint\",\n \"name\": \"_datepoint\",\n \"value\": \"2024-10-15 05:17:56\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_unix_timestamp\",\n \"name\": \"_unix_timestamp\",\n \"value\": 1728958676,\n \"group\": \"hidden\"\n },\n {\n \"key\": \"speed\",\n \"name\": \"Скорость\",\n \"value\": 128,\n \"group\": \"gps\"\n },\n {\n \"key\": \"satellites\",\n \"name\": \"Спутники\",\n \"value\": 18,\n \"group\": \"gps\"\n },\n {\n \"key\": \"_angle\",\n \"name\": \"Угол\",\n \"value\": 0,\n \"group\": \"hidden\"\n },\n {\n \"key\": \"address\",\n \"name\": \"Адрес\",\n \"value\": \"52.888 83.4898\",\n \"group\": \"gps\"\n },\n {\n \"key\": \"_imei\",\n \"name\": \"imei\",\n \"value\": \"866795035899259\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_sim1\",\n \"name\": \"sim1\",\n \"value\": \"79269570356\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_sim2\",\n \"name\": \"sim2\",\n \"value\": \"3197002530218\",\n \"group\": \"hidden\"\n },\n {\n \"key\": \"_marker_latlon\",\n \"name\": \"_marker_latlon\",\n \"value\": [\n 52.887977600097656,\n 83.48977661132812\n ],\n \"group\": \"hidden\"\n },\n {\n \"key\": \"0b7185cf-f594-4ed8-aef1-35457ea5debe\",\n \"name\": \"ДУТ-1\",\n \"type\": \"fuelsensor\",\n \"value\": 153.34,\n \"group\": \"sensors\"\n },\n {\n \"key\": \"b78689f9-e433-4a19-8dd7-653a56636f2a\",\n \"name\": \"Зажигание\",\n \"type\": \"ignition\",\n \"value\": \"Выкл\",\n \"group\": \"sensors\",\n \"_value\": 0\n },\n {\n \"key\": \"9b722af0-4fb2-458e-a47e-56fb38a52ae2\",\n \"name\": \"ДУТ-2\",\n \"type\": \"fuelsensor\",\n \"value\": 0,\n \"group\": \"sensors\"\n },\n {\n \"key\": \"78e0a8e1-b293-4cd7-b8fb-1ec9fb4827b3\",\n \"name\": \"Пробег\",\n \"type\": \"mileage\",\n \"value\": 435243.34,\n \"group\": \"sensors\"\n }\n ]\n }\n]\n\nПолучение номера записи в журнале по искомой дате
\nunits - объект.
from - начало интервала журнала.
datepoint - искомая дата.
Пример запроса:
\n{\n \"units\": [\n {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n ],\n \"from\": \"2022-12-16 00:00:00\",\n \"datepoint\": \"2022-12-16 12:40:36\"\n}\n\nПример ответа:
\n{\n \"index\": 2006\n}\n\nСоздание геозоны на основе трека объекта
\nunits - id объекта, берется всегда ПЕРВЫЙ объект, передавать несколько объектов не имеет смысла.
\nfrom - начало периода
\nto - конец периода
\ngeozone - все данные для создания геозоны, кроме точек (geometry). см. POST /geozones
\nОтвет - Поля отправленные в geozone в запросе + geometry - координаты
\nПример запроса:
\n{\n \"units\": [\n {\n \"id\": \"194659d6-b51c-4da7-b3e0-a9fd0c08bd08\"\n }\n ],\n \"geozone\": {\n \"name\": \"Геозона\",\n \"width\": 1,\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"icon\": {\n \"key\": \"territory\",\n \"type\": \"geo_icon\",\n \"value\": \"Территория\"\n },\n \"color\": {\n \"key\": \"#E68A2F\",\n \"type\": \"color_code\",\n \"value\": \"Оранжевый\"\n }\n },\n \"from\": \"2022-05-01 00:00:00\",\n \"to\": \"2022-05-08 00:00:00\"\n}\n\nПример ответа:
\n{\n \"name\": \"Геозона\",\n \"width\": 1,\n \"type\": {\n \"key\": \"polygon\",\n \"type\": \"geozone_type\",\n \"value\": \"Полигон\"\n },\n \"icon\": {\n \"key\": \"territory\",\n \"type\": \"geo_icon\",\n \"value\": \"Территория\"\n },\n \"color\": {\n \"key\": \"#E68A2F\",\n \"type\": \"color_code\",\n \"value\": \"Оранжевый\"\n },\n \"geometry\": [\n [\n 58.477291107177734,\n 56.41659164428711\n ],\n [\n 58.477989196777344,\n 56.414066314697266\n ],\n [\n 58.478939056396484,\n 56.41456985473633\n ],\n [\n 58.47801971435547,\n 56.41176986694336\n ],\n [\n 58.47996139526367,\n 56.41171646118164\n ],\n [\n 58.49407196044922,\n 56.43291091918945\n ],\n [\n 58.455448150634766,\n 56.4921875\n ],\n [\n 58.44243621826172,\n 56.5400390625\n ],\n [\n 58.435298919677734,\n 56.54085922241211\n ],\n [\n 58.432525634765625,\n 56.539642333984375\n ],\n [\n 58.42418670654297,\n 56.52698516845703\n ],\n [\n 58.390262603759766,\n 56.50182342529297\n ],\n [\n 58.37371063232422,\n 56.48448944091797\n ],\n [\n 58.35701370239258,\n 56.47863006591797\n ],\n [\n 58.34515380859375,\n 56.46323013305664\n ],\n [\n 58.34355545043945,\n 56.44695281982422\n ],\n [\n 58.33879852294922,\n 56.43614959716797\n ],\n [\n 58.32884216308594,\n 56.43088912963867\n ],\n [\n 58.316139221191406,\n 56.43156814575195\n ],\n [\n 58.31150436401367,\n 56.42858123779297\n ],\n [\n 58.30974197387695,\n 56.42164611816406\n ],\n [\n 58.302207946777344,\n 56.417686462402344\n ],\n [\n 58.3018913269043,\n 56.41263961791992\n ],\n [\n 58.306488037109375,\n 56.40105056762695\n ],\n [\n 58.30192565917969,\n 56.412593841552734\n ],\n [\n 58.30179214477539,\n 56.41674041748047\n ],\n [\n 58.30784606933594,\n 56.42136764526367\n ],\n [\n 58.30413818359375,\n 56.43191146850586\n ],\n [\n 58.309669494628906,\n 56.4671516418457\n ],\n [\n 58.305442810058594,\n 56.47206115722656\n ],\n [\n 58.29851150512695,\n 56.47565841674805\n ],\n [\n 58.294681549072266,\n 56.481937408447266\n ],\n [\n 58.300418853759766,\n 56.484275817871094\n ],\n [\n 58.30851364135742,\n 56.48251724243164\n ],\n [\n 58.31448745727539,\n 56.46957015991211\n ],\n [\n 58.31837463378906,\n 56.46688461303711\n ],\n [\n 58.3328742980957,\n 56.47914123535156\n ],\n [\n 58.335201263427734,\n 56.47939682006836\n ],\n [\n 58.33803939819336,\n 56.47685623168945\n ],\n [\n 58.34174728393555,\n 56.467525482177734\n ],\n [\n 58.34584426879883,\n 56.46585464477539\n ],\n [\n 58.358394622802734,\n 56.47978973388672\n ],\n [\n 58.373939514160156,\n 56.48464584350586\n ],\n [\n 58.38987350463867,\n 56.50153350830078\n ],\n [\n 58.42338180541992,\n 56.52629089355469\n ],\n [\n 58.43311309814453,\n 56.54020309448242\n ],\n [\n 58.442684173583984,\n 56.540000915527344\n ],\n [\n 58.4559440612793,\n 56.49037551879883\n ],\n [\n 58.45564651489258,\n 56.43037414550781\n ],\n [\n 58.4511833190918,\n 56.422027587890625\n ],\n [\n 58.455528259277344,\n 56.43009567260742\n ],\n [\n 58.45490646362305,\n 56.43424987792969\n ],\n [\n 58.45737075805664,\n 56.4296989440918\n ],\n [\n 58.456932067871094,\n 56.42644119262695\n ],\n [\n 58.463802337646484,\n 56.39642333984375\n ],\n [\n 58.470794677734375,\n 56.39438247680664\n ],\n [\n 58.47585678100586,\n 56.407806396484375\n ],\n [\n 58.47556686401367,\n 56.40900802612305\n ],\n [\n 58.474639892578125,\n 56.40435028076172\n ],\n [\n 58.47453689575195,\n 56.409210205078125\n ],\n [\n 58.47787094116211,\n 56.41158676147461\n ],\n [\n 58.47735595703125,\n 56.416500091552734\n ],\n [\n 58.477962493896484,\n 56.41410446166992\n ],\n [\n 58.478851318359375,\n 56.41459655761719\n ],\n [\n 58.47584915161133,\n 56.409793853759766\n ],\n [\n 58.470985412597656,\n 56.39485168457031\n ],\n [\n 58.468772888183594,\n 56.39400100708008\n ],\n [\n 58.464168548583984,\n 56.395565032958984\n ],\n [\n 58.45691680908203,\n 56.42605972290039\n ],\n [\n 58.457672119140625,\n 56.42924118041992\n ],\n [\n 58.45512390136719,\n 56.434085845947266\n ],\n [\n 58.45643997192383,\n 56.467201232910156\n ],\n [\n 58.45261764526367,\n 56.464988708496094\n ],\n [\n 58.45439147949219,\n 56.46688461303711\n ],\n [\n 58.456478118896484,\n 56.466243743896484\n ],\n [\n 58.45513916015625,\n 56.43400955200195\n ],\n [\n 58.457672119140625,\n 56.428993225097656\n ],\n [\n 58.45687484741211,\n 56.426273345947266\n ],\n [\n 58.46389389038086,\n 56.396141052246094\n ],\n [\n 58.47080612182617,\n 56.39448928833008\n ],\n [\n 58.47549819946289,\n 56.40879821777344\n ],\n [\n 58.47584915161133,\n 56.407806396484375\n ],\n [\n 58.47478485107422,\n 56.40472412109375\n ],\n [\n 58.47456359863281,\n 56.409278869628906\n ],\n [\n 58.47783660888672,\n 56.41162872314453\n ],\n [\n 58.47768020629883,\n 56.41593933105469\n ],\n [\n 58.4779167175293,\n 56.411678314208984\n ],\n [\n 58.47163009643555,\n 56.410831451416016\n ],\n [\n 58.46517562866211,\n 56.41938018798828\n ],\n [\n 58.460968017578125,\n 56.4117431640625\n ],\n [\n 58.45635986328125,\n 56.43159484863281\n ],\n [\n 58.451236724853516,\n 56.4222526550293\n ],\n [\n 58.44839096069336,\n 56.42311477661133\n ],\n [\n 58.45040512084961,\n 56.42209243774414\n ],\n [\n 58.452735900878906,\n 56.42485809326172\n ],\n [\n 58.45558166503906,\n 56.43049240112305\n ],\n [\n 58.4548454284668,\n 56.434326171875\n ],\n [\n 58.45744323730469,\n 56.4295539855957\n ],\n [\n 58.45690155029297,\n 56.42661666870117\n ],\n [\n 58.460601806640625,\n 56.41170883178711\n ],\n [\n 58.464805603027344,\n 56.4195442199707\n ],\n [\n 58.47134780883789,\n 56.41114044189453\n ],\n [\n 58.47795486450195,\n 56.41222381591797\n ],\n [\n 58.47724914550781,\n 56.4166259765625\n ]\n ]\n}\n\nЗапрос для получения трека
\nТело запроса JSON
\nПоля запроса :
\nunit_id - ID объекта
\nfrom - начало периода, в формате yyyy-MM-dd HH:mm:ss, необходимо отправлять в UTC+0
\nto - конеч периода, в формате yyyy-MM-dd HH:mm:ss, необходимо отправлять в UTC+0
\nmin_lat - Минимальное значение широты, вещественное число
\nmax_lat - Максимальное значение широты, вещественное число
\nmin_lon - Минимальное значение долготы, вещественное число
\nmax_lon - Максимальное значение долготы, вещественное число
\nzoom - зум, целое число
\nprocess_id - опциональное поле, для указания идентификатор запроса на клиенте
\nНа странице локатора дополнительно отправить параметр locator_id - ID локатора
\nПример запроса:
\nGET https://dev5.skif.pro/api_v1/tracks/get_tracks
\n{\n \"unit_id\": \"93a62a79-a117-4b4e-b53a-568e1d06e603\",\n \"from\": \"2023-10-01 00:00:00\",\n \"to\": \"2024-12-01 00:00:00\",\n \"min_lat\": 34.323233,\n \"min_lon\": 20.343545,\n \"max_lat\": 80.34324,\n \"max_lon\": 88.32321,\n \"zoom\": 10,\n \"process_id\": \"4c658ab8-2ef6-460c-aee2-ecc4a1486df8\"\n}\n\nОтвет:
\nКаждый элемент массива points в таком формате: [datepoint_delta,latitude,longitude,speed]
\ndatepoint_delta - разница datepoint от предыдущей записи в секундах. Для первого элемента это разница от from. datepoint в unix timestamp.
\nПример ответа:
\n{\n \"points\": [\n [\n 17140501,\n 59.959656,\n 30.311783,\n 16\n ],\n [\n 222,\n 59.956139,\n 30.320679,\n 45\n ],\n [\n 244,\n 59.950233,\n 30.326031,\n 13\n ]\n ],\n \"process_id\": \"4c658ab8-2ef6-460c-aee2-ecc4a1486df8\"\n}\n\nПолучение пересечений треков объектов с геозонами
\nРоль: Администратор и выше.
\nПример запроса:
\n{\n \"units\": [{\n \"id\": \"59c3b12d-583b-4e0d-bf69-05b73b7a0707\"\n }],\n \"geozones\": [{\n \"id\": \"951f0dbd-eb26-4585-b8b2-a25f899cfaba\"\n }, {\n \"id\": \"352838a8-3073-4143-a824-5556acfe9457\"\n }],\n \"from\": \"2021-02-01 00:00:00\",\n \"to\": \"2021-02-06 00:00:00\"\n}\n\nunits - массив id объектов, не более 300 объектов.
\ngeozones - массив id геозон, в которых могут быть объекты.
\nfrom, to - период, за который получаем данные, не более 7 дней.
\nПример ответа:
\n[\n [\n 63.90916,\n 52.02023,\n 0.0,\n \"59c3b12d-583b-4e0d-bf69-05b73b7a0707\",\n \"352838a8-3073-4143-a824-5556acfe9457\",\n 1612145853,\n \"2021-02-01 08:17:33\"\n ],\n [\n 63.909298,\n 52.020153,\n 0.0,\n \"59c3b12d-583b-4e0d-bf69-05b73b7a0707\",\n \"352838a8-3073-4143-a824-5556acfe9457\",\n 1612145880,\n \"2021-02-01 08:18:00\"\n ],\n...\n\nОтвет - массив данных следующего содержания:
\n1 элемент - longitude
\n2 - latitude
\n3 - speed
\n4 - unit id
\n5 - geozeon id
\n6 - unix time
\n7 - user time
\n","urlObject":{"path":["api_v1","points_geozones"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"990cca9d-bf2b-4108-a257-dcdba197e213"}],"id":"dc291ef1-af58-499f-8ed1-295a6121f0c2","_postman_id":"dc291ef1-af58-499f-8ed1-295a6121f0c2","description":""},{"name":"Уведомления","item":[{"name":"/notifications?ids=:ids","id":"483b2644-fd7c-4178-ac05-c311e33871f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/notifications?ids=","description":"Получение шаблона уведомления
\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","notifications"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"483b2644-fd7c-4178-ac05-c311e33871f2"},{"name":"/notifications","id":"ea2374a9-6830-4443-8d9b-e690ce981522","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"units\":[{\"id\":\"7e078c26-3043-4117-a822-54b29785c086\"},{\"id\":\"4b8f9e89-cc66-43b4-bafe-bf08fac8b211\"}],\n \"units_groups\": [{\"id\":\"266b1737-e85f-4ba0-9985-dbeefa2dd697\"}],\n\t\"type\":{\"key\":\"sensor_notification\"},\n \"sound\":{\"key\":\"8tone\"},\n\t\"delivery_emails\":[\"test1@mail.uk\",\"test2@mail.uk2\"],\n\t\"delivery_sms\":[\"12345644848\",\"12345644849\"],\n\t\"delivery_push\":[\"990cb3e1-474a-4f07-95b9-8568c194d801\",\"b1fd9628-9f72-4e72-9da8-f5ca4e2fffc1\"],\n \"delivery_commands\": [\n {\n \"terminal_type_key\": \"navtelecom\",\n \"command\": \"*?V\"\n },\n {\n \"terminal_type_key\": \"galileo\",\n \"command\": \"Info\"\n }\n ],\n \"delivery_http_requests\" : [\n {\n \"url\": \"http://example.com\",\n \"method\" : \"post\",\n \"jsonBody\" : \"{ 'invalid syntax': 'json' }\", // в этом примере возвращается ошибка. нужно отправить { \"valid syntax\": \"json\" }\n \"headers\": [\n {\n \"name\" : \"headerName\",\n \"value\": \"headerValue\"\n }\n ]\n }\n\n ],\n \"timeout_conditions_type\": {\n \"key\": \"timeout_conditions_min\"\n },\n \"timeout_conditions_value\": 1,\n\t\"name\":\"testNotification\",\n\t\"is_active\":true,\n\t\"notificationtext\":\"some text\",\n\t\"is_show_online\": true,\n\t\"isdeliveryemail\": true,\n \"isdeliverysms\": true,\n \"isdeliverypush\": true,\n \"isdeliverycommand\": true,\n \"isviolation\": false,\n \"isdeliveryhttp\": true,\n \"isevent\": true,\n \n \"weeks_control\": true,\n \"wc_active_1\":true,\n \"wc_from_1\": 4124,\n \"wc_to_1\": 4200,\n \n\t\"geozones\":[{\"id\":\"79883ab2-968a-405d-839e-fad90e92a3d0\"},{\"id\":\"266b1737-e85f-4ba0-9985-dbeefa2dd697\"}],\n\t\"sensor_type\":{\"key\":\"ignition\"},\n\t\"name_mask\": \"CustomFuelSenso\",\n\t\"in_geozone\": true,\n\t\"in_interval\": false,\n\t\"speed_notless\": 12.0,\n\t\"speed_notmore\": 15.0,\n\t\"sensor_notless\": 333.0,\n\t\"sensor_notmore\": 555.0,\n\t\"duration\": 10,\n\t\"interval_milage\": 34000,\n\t\"interval_days\": 90,\n \n \"isdeliveryaddtogroup\": true,\n \"isdeliveryremovefromgroup\" : true,\n \"delivery_add_unit_group\": [\"9fd6f8d7-0d9a-4a8a-93f7-a2b0c28fcee4\"],\n \"delivery_remove_unit_from_group\": [\"9fd6f8d7-0d9a-4a8a-93f7-a2b0c28fcee4\"]\n\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/notifications","description":"Создание нового шаблона уведомлений
\nМодель шаблона:
\n Unit[] units - обязательный параметр. Должен быть хотя бы один юнит.\n units_groups[] units_groups - Новый параметр для уведомлений по группе объектов\n Dictionary type - виды уведомлений - Контроль скорости, Контроль геозон, Контроль значения датчика, Тревожная кнопка, Потеря связи, Простой ТС, Контроль ТО. Ключи можно получить через запрос GET /dictionaries/notification_type\n Dictionary sound - Звук, Ключи можно получить через запрос GET /dictionaries, тип - notify_sounds\n String[] delivery_emails - массив строк с емейлами\n String[] delivery_sms - массив строк с телефонами\n UUID[] delivery_push - массив uuid юзеров\n Long[] delivery_telegram - массив id-рассылки для Telegram. Массив целых чисел. Выбирается из пользователей из поля telegram_chat_id\n В запросе должен быть хотя бы один из этих 4 параметров.\n List<DeliveryCommand> delivery_commands - массив настройки для отправки команды, каждый элемент \n состоит из полей terminal_type_key - ключ тип протокола, command - текст команды.\n List<DeliveryHttpRequest> delivery_http_requests - массив настройки для отправки GET/POST запросов\n UUID[] delivery_add_unit_group - массив UUID групп объектов для \"Добавление объекта в группы\"\n UUID[] delivery_remove_unit_from_group - UUID групп объектов для \"Удаление объекта из группы\"\n Dictionary delivery_unit_icon - изменение иконки объекта\n String name - имя шаблона. Обязательный параметр.\n Boolean is_active; //деактивация\n String notificationtext - шаблон текста уведомления. Обязательный параметр.\n Boolean is_show_online; // включить показать онлайн\n Boolean isdeliveryemail; // включить отправку на почту\n Boolean isdeliverysms; // включить отправку sms\n Boolean isdeliverypush; //включить отправку push\n Boolean isdeliverytelegram; //включить отправку на телеграм\n Boolean isdeliverycommand; // включить отправку команды \n Boolean isdeliveryhttp; // включить отправку GET/POST\n Boolean isdeliveryaddtogroup; // включить добавление объекта из группы\n Boolean isdeliveryremovefromgroup; // включить удаление объекта из группы\n Boolean isdeliverychangeicon; // включить изменение иконки объекта\nBoolean isviolation;\n Boolean isevent;\n Boolean weeks_control; //контроль по дням недели\n Boolean wc_active_1; //monday\n Boolean wc_active_2;\n Boolean wc_active_3;\n Boolean wc_active_4;\n Boolean wc_active_5;\n Boolean wc_active_6;\n Boolean wc_active_7;\n String wc_from_1; //from for monday\n String wc_from_2;\n String wc_from_3;\n String wc_from_4;\n String wc_from_5;\n String wc_from_6;\n String wc_from_7;\n String wc_to_1; //to for monday\n String wc_to_2;\n String wc_to_3;\n String wc_to_4;\n String wc_to_5;\n String wc_to_6;\n String wc_to_7;\n Geozones[] geozones - массив геозон. Должна быть хотя бы одна геозона в массиве, если type = 'geozone_notification' или 'velocity_notification'.\n GeozonesGroup[] geozones_groups - массив групп геозон. \n Dictionary sensor_type - ключ типа сенсора. Список типов может быть получен по запросу GET /dictionaries/sensor_type\n String name_mask - маска имени сенсора.\n В случае, если type = 'sensor_notification', то должен быть заполнен хотя бы один из этих 2 параметров.\n Boolean in_geozone - тип триггера для геозон. false - выход из геозоны, true - вход в геозону. Является обязательным, если type = 'geozone_notification'.\n Boolean in_interval - тип триггера для датчика. false - вне установленных рамок, true - в установленных рамках. Является обязательным, если type = 'sensor_notification'.\n Double speed_notless - скорость \"не менее\". Параметр используется только если type = 'velocity_notification'\n Double speed_notmore - скорость \"не более\". Параметр используется только если type = 'velocity_notification' или 'idle_notification'.\n Если type = 'velocity_notification', то должен быть заполнен хотя бы 1 параметр из этих двух. \n Double sensor_notless - значение датчика \"не менее\". Параметр используется только если type = 'sensor_notification'\n Double sensor_notmore - значение датчика \"не более\". Параметр используется только если type = 'sensor_notification'\n Если type = 'sensor_notification', то должен быть заполнен хотя бы 1 параметр из этих двух. \n Double lostsignal_notless - минимальное время потери сигнала. Параметр используется только если type = 'sensor_notification' и в этом случае является обязательным.\n Integer duration - Длительность простоя. Используется только если type = 'idle_notification' и в таком случае является обязательным. \n Также, если type = 'idle_notification', то параметр speed_notmore является обязательным.\n Integer interval_milage - интервал пробега. Используется только если type = 'service_notification'.\n Integer interval_days - интервал по дням. Используется только если type = 'service_notification'.\n Integer interval_motohours - интервал моточасы\nИспользуется только если type = 'service_notification'.\n Если type = 'service_notification', то должен быть заполнен хотя бы 1 параметр из этих трех. \n Dictionary timeout_conditions_type - Виды таймаута проверки условия. Возможные ключи: timeout_conditions_sec, timeout_conditions_min, timeout_conditions_hour\n Integer timeout_conditions_value - Значение таймаута проверки условия. \n\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ea2374a9-6830-4443-8d9b-e690ce981522"},{"name":"/notifications/:notification_id","id":"40cf67c9-5627-4e6d-bade-5bb72843237d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n\t\"is_active\": \"false\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/notifications/:notification_id","description":"Изменение активности уведомлений
\nПараметры:
notification_id - ID уведомления
Тело запроса:
Чтобы сделать активным, необходимо отправить запрос с таким телом:
{\n \"is_active\": true\n}\nили\n{\n \"is_active\": \"true\"\n}\nили\n{\n \"is_active\": 1\n}\n\nЧтобы сделать неактивным, необходимо отправить запрос с таким телом:
\n{\n \"is_active\": false\n}\nили\n{\n \"is_active\": \"false\"\n}\nили\n{\n \"is_active\": 0\n}\n\nВ ответе возвращается обновленный объект notification , как в PUT /notifications/:notification_id
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications",":notification_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID уведомления
\n","type":"text/plain"},"type":"any","value":"","key":"notification_id"}]}},"response":[],"_postman_id":"40cf67c9-5627-4e6d-bade-5bb72843237d"},{"name":"/notifications/list","id":"3fa0c849-025a-4448-b209-462457799905","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/notifications/list","description":"Роль: Читатель и выше.
\n","urlObject":{"path":["api_v1","notifications","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3fa0c849-025a-4448-b209-462457799905"},{"name":"/notifications/:notification_id","id":"f507a84f-a9e4-49df-ae61-65f29f8ff699","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/notifications/:notification_id","description":"Роль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications",":notification_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID уведомления
\n","type":"text/plain"},"type":"any","value":"","key":"notification_id"}]}},"response":[],"_postman_id":"f507a84f-a9e4-49df-ae61-65f29f8ff699"},{"name":"/notifications/:notification_id","id":"7e9b7c72-43d5-4865-9b1f-e55cb9c9a3ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/notifications/:notification_id","description":"Удаление шаблона уведомлений
\nУдаление физическое.
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications",":notification_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID уведомления
\n","type":"text/plain"},"type":"any","value":"","key":"notification_id"}]}},"response":[],"_postman_id":"7e9b7c72-43d5-4865-9b1f-e55cb9c9a3ff"},{"name":"/notifications?ids=:ids","id":"26482a09-1d8e-449c-b6fa-b53c11d36ce9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/notifications?ids=","description":"Планирование удаления шаблона уведомления
\nсм. DELETE /units?ids=:ids
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"26482a09-1d8e-449c-b6fa-b53c11d36ce9"},{"name":"/notifications","id":"c95bee41-a01b-430e-981b-46ed3b1ee111","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/notifications","description":"Планирование удаления шаблона уведомления
\nсм. DELETE /units
\nРоль: Оператор и выше.
\n","urlObject":{"path":["api_v1","notifications"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c95bee41-a01b-430e-981b-46ed3b1ee111"},{"name":"/messages","id":"eb49d2d7-a2b4-4c0b-b6f9-bc837707956b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"wss://{{base_url}}/notifications/messages","description":"Получение уведомлений
\nИспользуется один вебсокет для получения следующих данных:
\nпоследнего сообщения от объекта
\nуведомлений за последние сутки
\nновых уведомлений
\nизменения справочников
\nПосле открытия сокета сервер будет присылать уведомления вида:
\n[{\n \"id\": \"27379574-a367-4864-a2de-b236aa22dbd4\",\n \"template\": {},\n \"notificationtext\": \"Камаз P 293 BT Костанай в 2020-07-21 15:49:00 зафиксирован вход в геозону / выход из геозоны ... на скорости 10 возле Нефтебаза. \",\n \"time\": \"2020-07-21 15:49:00\",\n \"unit\": {},\n \"latitude\": 53.2038766,\n \"longitude\": 63.583665\n}]\n\nСоздание новой рассылки
\nМодель рассылки:
\n name - название рассылки, строка, обязательно\n Unit unit - объект\n UnitsGroup units_group - группа объектов, в одно и той же время надо указать или unit или units_group\n ReportTemplate report_template - шаблон отчета, обязательно\n periodic - период отправки письма, целое положительное число, обязательно\n periodic_type - тип периода отправки, получается из справочника по типу periodic_type, обязательно\n weekdays - список дней недели, в которых надо отправить письмо, обязательно\n delivery_emails - список почт\n delivery_telegram - список телеграм чатов\n last_run - дата и время последней отправки, необязательно\n msg - сообщение, текст\n is_active - признак активности, булеан\n\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"name\": \"New mailing\",\n \"unit\": {\n \"id\": \"b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"type\": \"periodic_type\",\n \"key\": \"periodic_days\"\n },\n \"weekdays\": [\n {\n \"type\": \"weekdays_type\",\n \"key\": \"monday\"\n },\n {\n \"type\": \"weekdays_type\",\n \"key\": \"friday\"\n }\n ],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"delivery_telegram\": [\n 484392478323,\n -13894857843\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": true\n}\n\nОтвет:
\n{\n \"id\": \"afa8dc0f-4e8f-422d-9059-2fedb9039f4e\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"key\": \"periodic_days\",\n \"type\": \"periodic_type\",\n \"value\": \"По дням\"\n },\n \"weekdays\": [\n {\n \"key\": \"monday\",\n \"type\": \"weekdays_type\",\n \"value\": \"Понедельник\"\n },\n {\n \"key\": \"friday\",\n \"type\": \"weekdays_type\",\n \"value\": \"Пятница\"\n }\n ],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"delivery_telegram\": [\n 484392478323,\n -13894857843\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": true,\n \"_active\": true\n}\n\nЗапрос по группе объектов:
\n{\n \"name\": \"New mailing\",\n \"units_group\": {\n \"id\": \"09581d93-a351-44de-9f33-1d4b0a1b0b48\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"type\": \"periodic_type\",\n \"key\": \"periodic_days\"\n },\n \"weekdays\": [\n {\n \"type\": \"weekdays_type\",\n \"key\": \"monday\"\n },\n {\n \"type\": \"weekdays_type\",\n \"key\": \"friday\"\n }\n ],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"delivery_telegram\": [\n 484392478323,\n -13894857843\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": true\n}\n\nИзменение активности рассылки
\nПараметры:
id - ID рассылки
Чтобы сделать активным, необходимо отправить запрос с таким телом:
\n{\n \"is_active\": true\n}\nили\n{\n \"is_active\": \"true\"\n}\nили\n{\n \"is_active\": 1\n}\n\nЧтобы сделать неактивным, необходимо отправить запрос с таким телом:
\n{\n \"is_active\": false\n}\nили\n{\n \"is_active\": \"false\"\n}\nили\n{\n \"is_active\": 0\n}\n\nВ ответе возвращается обновленный объект mailing как в PUT /mailings/:id
\n","urlObject":{"path":["api_v1","mailings",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID рассылки
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"5182d2ae-4bc2-4508-a7c1-ca1880a3df10"},{"name":"/mailings/list","id":"6aab59fd-6549-4f36-999a-428715a28977","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\"\n }\n ]\n}"},"url":"{{base_url}}/api_v1/mailings/list","description":"Получить рассылки по фильтру
\nАналогичнао запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[\"periodic\", \"last_run\", created, is_delete]
sortDesc - сортировка по убыванию, значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - \"units_group.id\", \"unit.id\", \"is_active\", \"msg\"
Роль: Читатель и выше.
\nПример запроса:
\nПолучить первые 10 связей, отсортированные по возрастанию даты создания объект с ID равным b8b1f330-52cf-46c6-a41e-ab0f70a0cce5
\n{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"afa8dc0f-4e8f-422d-9059-2fedb9039f4e\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"New mailing\",\n \"unit\": {\n \"id\": \"b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"key\": \"periodic_days\",\n \"type\": null,\n \"value\": null\n },\n \"weekdays\": [],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": true,\n \"_active\": true\n },\n {\n \"id\": \"13b37095-f2eb-4c3f-804b-6f780281e398\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"New mailing2\",\n \"units_group\": {\n \"id\": \"09581d93-a351-44de-9f33-1d4b0a1b0b48\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"key\": \"periodic_days\",\n \"type\": null,\n \"value\": null\n },\n \"weekdays\": [],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": false,\n \"_active\": false\n }\n ]\n}\n\nЕще один пример запроса:
\nПолучить первые 10 связей, отсортированные по возрастанию даты окончания по убыванию, связаные с водителем (пользователем) с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3
\n{\n \"from\": 0,\n \"count\": 10,\n \"sortField\": \"date_to\",\n \"sortDesc\": \"true\",\n \"conditions\": [\n {\n \"field\": \"user.id\",\n \"value\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"f9c60641-0393-4345-aa2a-aadb869db3c9\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2021-01-01 10:00:00\"\n },\n {\n \"id\": \"d604452b-9e9d-4e01-817d-b0d391138569\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"7e1aaba2-625a-4a4c-b765-9934bec5a096\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-11-01 10:00:00\",\n \"date_to\": \"2020-12-01 18:00:00\"\n },\n {\n \"id\": \"5acc2fd1-e63a-4c10-95d0-22eaf59439ae\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"unit\": {\n \"id\": \"cc1c4c33-5895-4fec-9295-020ffcee9372\"\n },\n \"user\": {\n \"id\": \"22ae4a3c-f742-460c-9479-63f08c81b5c3\"\n },\n \"date_from\": \"2020-09-01 10:00:00\",\n \"date_to\": \"2020-10-01 18:00:00\"\n }\n ]\n}\n\nОбновить данные рассылки
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /mailings
\nРоль: Редактор и выше.
\nОтвет:
\nАналогичен одному объекту из возврата метода GET /mailings?ids=:id
\n","urlObject":{"path":["api_v1","notifications",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID рассылки
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"a7527fa0-fccb-40d5-898c-6a5c95527e81"},{"name":"/mailings/:id","id":"f83d87c2-c670-45ae-b20d-0555249bc616","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/mailings/:id","description":"Удаление рассылки
\nУдаление физическое.
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","mailings",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID рассылки
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"f83d87c2-c670-45ae-b20d-0555249bc616"},{"name":"/mailings?ids=:ids","id":"4d5c1589-47eb-431b-82ba-1eb4a278534a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/mailings?ids=","description":"Планирование удаление рассылки
\nсм. DELETE /units?ids=:ids
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","mailings"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"4d5c1589-47eb-431b-82ba-1eb4a278534a"},{"name":"/mailings","id":"893f1b10-1b96-46e9-af43-97c87bf5caf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/mailings","description":"Планирование удаления рассылки
\nсм. DELETE /units
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","mailings"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"893f1b10-1b96-46e9-af43-97c87bf5caf4"},{"name":"/mailings?ids=:ids","id":"445b989a-6822-428e-af1b-65ebddd196c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/mailings?ids=","description":"Получение рассылок по их ID (через запятую)
\nВозвращает массив рассылок.
Если параметр 'ids' пустой (т.е. запрос = 'GET /units_trailers', без параметра), то вернётся список всех связей всех компаний пользователя, из которого исключаются удаленные связей. Если ids не пустой (т.е. запрос = 'GET /mailings?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных связей.
Если в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная связь.
\nРоль: Читатель и выше.
\nПример запроса:
\n/mailings?ids=13b37095-f2eb-4c3f-804b-6f780281e398\n\nПример ответа:
\n{\n \"id\": \"13b37095-f2eb-4c3f-804b-6f780281e398\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"name\": \"New mailing\",\n \"units_group\": {\n \"id\": \"09581d93-a351-44de-9f33-1d4b0a1b0b48\"\n },\n \"report_template\": {\n \"id\": \"76c4d2a4-5c89-494d-9c26-fbfcfa144601\"\n },\n \"periodic\": 2,\n \"periodic_type\": {\n \"key\": \"periodic_days\",\n \"type\": \"periodic_type\",\n \"value\": \"По дням\"\n },\n \"weekdays\": [\n {\n \"key\": \"monday\",\n \"type\": \"weekdays_type\",\n \"value\": \"Понедельник\"\n },\n {\n \"key\": \"friday\",\n \"type\": \"weekdays_type\",\n \"value\": \"Пятница\"\n }\n ],\n \"delivery_emails\": [\n \"test@mail.ru\",\n \"xyz@gmail.com\"\n ],\n \"last_run\": \"2020-10-05 10:25:45\",\n \"msg\": \"Some message\",\n \"is_active\": false,\n \"_active\": false\n}\n\nЗапрос на получение данных для оплаты текущей компании на сумму, указанную в теле запроса
\nПример запроса:
\n{\n \"amount\": 300,\n \"skip_init_payment\": true\n}\n\nЧтобы начать автоплатеж нужно указать start_recurrent=1
\n{\n \"amount\": 300,\n \"start_recurrent\": 1,\n \"skip_init_payment\": true\n}\n\nВ ответ приходят данные, которые необходимо преобразовать в формат www-form-urlencoded и отправить запрос
\n\n\nPOST
\n
в ответ на который вернется страница с формой для оплаты.
\nРоль: Читатель и выше.
\nПример ответа:
\n{\n \"merchant\": \"60ddcdb9-a37a-438b-8a43-ba9e04400aff\",\n \"amount\": 150,\n \"order_id\": \"7f6e0b1e-4874-426e-849e-a47ff2cf4aba\",\n \"custom_order_id\": \"297-7ee49\",\n \"description\": \"Пополнение кошелька SKIF PRO\",\n \"success_url\": \"https://pay.modulbank.ru/success\",\n \"testing\": 1,\n \"callback_url\": \"https://dev.skif.pro/api_v1/billing_success\",\n \"receipt_items\": [\n {\n \"name\": \"Пополнение кошелька SKIF PRO\",\n \"payment_method\": \"full_payment\",\n \"payment_object\": \"payment\",\n \"quantity\": \"1\",\n \"sno\": \"usn_income\",\n \"vat\": \"none\"\n }\n ],\n \"unix_timestamp\": 1627568279,\n \"signature\": \"60efe5ef7c1292efa0b0e10c44147f8ba408c488\"\n}\n\nДля Paybox
\n{\n \"pg_merchant_id\": \"12345\",\n \"pg_amount\": 3000,\n \"pg_order_id\": \"d4ce08d6-7313-49dd-abb4-9d08b37096b9\",\n \"pg_description\": \"Пополнение кошелька SKIF PRO\",\n \"pg_success_url\": \"https://dev.skif.pro\",\n \"pg_salt\": \"659bc044-a8d8-4da5-95a2-0a3fea31dd18\",\n \"customOrderId\": \"612-9c00c\",\n \"pg_testing_mode\": 1,\n \"pg_result_url\": \"https://dev.skif.pro/api_v1/billing_success\",\n \"pg_receipt_positions\": [\n {\n \"name\": \"Пополнение кошелька SKIF PRO\",\n \"paymentMethod\": \"full_payment\",\n \"paymentObject\": \"payment\",\n \"price\": \"3000.0\",\n \"count\": \"1\",\n \"sno\": \"usn_income\",\n \"vat\": \"none\",\n \"tax_type\": 0\n }\n ],\n \"unixTimestamp\": 1670310278,\n \"pg_sig\": \"a7065338d399008135d354284ff0e388\"\n}\n\nЗапрос который вызывается банковским сервисом, должен проходить по NO_ACCESS.
В теле запроса данные о подтверждении успешной транзакции в формате www-form-urlencoded
Роль: Читатель и выше.
\nПример запроса:
\ntesting:1\npan_mask:220011**4440\nunix_timestamp:1570161434\nsalt:DB9481A6554924BFD2F2279B5AD05B9D\nrrn:927703219385\ntransaction_id:0EyuFLLZ9DagCXy8O67Q6x\noriginal_amount:10.00\nauth_number:2164219385\namount:10.00\ncreated_datetime:2019-10-04 03:56:09\nauth_code:201471\nsignature:622e1486dba17d05d080c6734131205a75d59188\nclient_phone:+79999999999\nclient_email:example@example.ru\nstate:COMPLETE\norder_id:697144\ncurrency:RUB\nmerchant:51cb8a0f-6fb8-4a20-98b1-9fd85dc47500\npayment_method:card\nmeta:'{\"bill_id\": \"vlICmFjY7nST9KARa5RsSJ\"}'\n\nРоль: Редактор тарифа и выше.
\n","urlObject":{"path":["api_v1","bill_set_billing"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c60f6f17-f5ea-4c26-a8e0-016f69ffd02b"},{"name":"/bill_transactions","id":"00564703-bd83-4619-97e7-da9561b4cb8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"max_rows\": 15,\n \"first_row\": 5,\n \"from\": \"2021-08-25 00:00:00\",\n \"to\": \"2021-08-26 00:00:00\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/bill_transactions","description":"Получение списка транзакций в текущей компании
\nРоль: Читатель и выше.
\nПример запроса:
\n{\n \"max_rows\": 100,\n \"first_row\":100,\n}\n\nПример ответа:
\n{\n \"transactions\": [\n {\n \"id\": \"6dd2c369-9012-440a-a708-a65b7e6f12fb\",\n \"timestamp\": \"2021-07-29 17:35:57\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"user_id\": \"null\",\n \"amount\": 0,\n \"amount_before\": 0,\n \"amount_after\": 0,\n \"order_id\": null,\n \"custom_order_id\": null\n }\n ]\n}\n\nЗапрос для получения списка истории изменений тарифов текущей компании
\nРоль: Читатель и выше.
\nПример запроса:
\n{\n \"max_rows\": 100,\n \"first_row\":100,\n \"from\": 2021-07-29 17:35:57,\n \"to\":2021-07-29 17:35:57\n}\n\nПример ответа:
\n[\n {\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"user_name\": \"vlad\",\n \"datepoint\": \"2021-07-29 18:12:50\",\n \"new_tariff\": {\n \"units\": 4,\n \"price\": 200,\n \"total\": 800\n },\n \"old_tariff\": {\n \"units\": 3,\n \"price\": 250,\n \"total\": 750\n }\n },\n {\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"user_name\": \"vlad\",\n \"datepoint\": \"2021-07-29 18:12:39\",\n \"new_tariff\": {\n \"units\": 3,\n \"price\": 250,\n \"total\": 750\n },\n \"old_tariff\": {\n \"units\": 2,\n \"price\": 200,\n \"total\": 400\n }\n },\n {\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"user_name\": \"vlad\",\n \"datepoint\": \"2021-07-29 17:35:52\",\n \"new_tariff\": {\n \"units\": 2,\n \"price\": 200,\n \"total\": 400\n }\n }\n]\n\nСоздает тариф для текущей компании
\nРоль: Редактор и выше.
\nПример запроса:
\n{\n \"tariff\":{\n \"units\": 1,\n \"length\": 30,\n \"price\": 300\n }\n}\n\nПример ответа:
\n{\n \"amount\": 236,\n \"rate\": 600,\n \"company_status\": \"BLOCKED\",\n \"valid_from\": \"2021-08-20 14:08:56\",\n \"tariff\": {\n \"units\": 2,\n \"price\": 300,\n \"total\": 600,\n \"length\": 30\n }\n}\n\nДобавляет дилером транзакцию в компанию со статусом оплаты CASH.
\nИспользуется для того, чтобы учитывать оплаты произведенные наличными.
\nРоль: Редактор тарифа и выше.
\nПример запроса:
\n{\n\"amount\": 2500,\n\"company_id\": \"0f90e21b-a5a9-4929-8d83-67951440df61\",\n\"custom_order_id\": \"12344\"\n}\n\nВозвращает информацию о тарифе для списка компаний
\nЗапрос без списка компаний возвращает транзакции по всем компаниям.
\nРоль: Редактор тарифа и выше.
\nПример запроса:
\n{\n \"companies\": [\n {\n \"id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\"\n },\n {\n \"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\"\n }\n ]\n}\n\nПример ответа:
\n[\n {\n \"amount\": 370,\n \"rate\": 9000,\n \"company_status\": \"ACTIVE\",\n \"valid_to\": \"2021-10-30 00:00:00\",\n \"valid_from\": \"2021-10-28 09:07:28\",\n \"tariff\": {\n \"units\": 36,\n \"price\": 250,\n \"total\": 9000,\n \"length\": 30\n },\n \"currency\": {\n \"code\": \"RUB\"\n },\n \"company_id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\"\n },\n {\n \"amount\": 0,\n \"tariff\": {\n \"units\": 0,\n \"price\": 250,\n \"total\": 0,\n \"length\": 30\n },\n \"currency\": {\n \"code\": \"RUB\"\n },\n \"company_id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\"\n }\n]\n\nИзменение тарифа для компании
\nРоль: Редактор тарифа и выше.
\nПример запроса:
\n{\n \"amount\": 0,\n \"rate\": 500,\n \"company_status\": \"ACTIVE\",\n \"valid_from\": \"2021-10-28 10:19:17\",\n \"tariff\": {\n \"units\": 2,\n \"price\": 250,\n \"total\": 500,\n \"length\": 30\n },\n \"currency\": {\n \"code\": \"RUB\"\n },\n \"company_id\": \"483aafbf-7682-471c-8612-555dcb0ed584\"\n}\n\nПример ответа:
\n{\n \"amount\": 0,\n \"rate\": 500,\n \"company_status\": \"ACTIVE\",\n \"valid_to\": \"2021-11-27 10:19:17\",\n \"valid_from\": \"2021-10-28 10:19:17\",\n \"tariff\": {\n \"units\": 2,\n \"price\": 250,\n \"total\": 500,\n \"length\": 30\n },\n \"currency\": {\n \"code\": \"RUB\"\n },\n \"company_id\": \"483aafbf-7682-471c-8612-555dcb0ed584\"\n}\n\nОстановить автоплатежи для компании пользователя
\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","bill_tariff_admin"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c375406e-1f1c-4e5b-b807-72b41231e68a"},{"name":"/bill_transactions_admin","id":"390cad4c-1585-4608-a397-2e5c3a304ef7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"companies\": [\n {\n \"id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\"\n },\n {\n \"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\"\n }\n ],\n \"max_rows\": 15,\n \"first_row\": 5,\n \"from\": \"2021-08-25 00:00:00\",\n \"to\": \"2021-08-26 00:00:00\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/bill_transactions_admin","description":"Получение списка всех транзакций для списка компаний с пагинацией
\nРоль: Администратор и выше.
\nПример запроса:
\n{\n \"companies\": [\n {\n \"id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\"\n },\n {\n \"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\"\n }\n ],\n \"max_rows\": 15,\n \"first_row\": 5,\n \"from\": \"2021-08-25 00:00:00\",\n \"to\": \"2021-08-26 00:00:00\",\n \"conditions\": [\n {\"key\": \"payment_type\", \"values\": [\"CARD_DEPOSIT\", \"CASH_DEPOSIT\"]}\n ]\n}\n\nПример ответа:
\n{\n \"max\": 485,\n \"transactions\": [\n {\n \"id\": \"7b145ed1-04ec-401a-a643-07dc2d45c693\",\n \"timestamp\": \"2022-03-25 08:19:15\",\n \"company_id\": \"41ee3ec9-185b-4af7-bfc0-ff370835b9b9\",\n \"user_id\": null,\n \"amount\": 0,\n \"amount_before\": 0,\n \"amount_after\": 0,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"TRIAL_ACTIVATION\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"kgKzLQdVTgJcVoEbOmKufd\",\n \"timestamp\": \"2022-03-10 07:29:00\",\n \"company_id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\",\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"amount\": 55,\n \"amount_before\": 870,\n \"amount_after\": 925,\n \"order_id\": \"0032a6ec-a8f6-416c-9647-a937b0f893a8\",\n \"custom_order_id\": \"103-2c204\",\n \"payment_type\": \"CARD\",\n \"operation_type\": \"CARD_DEPOSIT\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"a58e22ed-c671-4c4c-812f-a6c0f091fc8d\",\n \"timestamp\": \"2022-03-01 13:26:51\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -222,\n \"amount_before\": 318,\n \"amount_after\": 96,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"4028e3e3-fa5b-4e2d-8f40-ee6a9d624b77\",\n \"timestamp\": \"2022-03-01 13:26:07\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -222,\n \"amount_before\": 540,\n \"amount_after\": 318,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"e3c08461-8ba3-4f46-b436-1f88fe23bd23\",\n \"timestamp\": \"2022-03-01 13:23:49\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -222,\n \"amount_before\": 762,\n \"amount_after\": 540,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"4d5e983b-db17-4b29-8ee7-198c66b5159f\",\n \"timestamp\": \"2022-03-01 13:21:09\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -500,\n \"amount_before\": 1262,\n \"amount_after\": 762,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"4b0ad5d3-6761-400b-a89b-8229426b8684\",\n \"timestamp\": \"2022-03-01 12:57:30\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -246,\n \"amount_before\": 1508,\n \"amount_after\": 1262,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"d31e05ba-35c5-473b-be60-6ac503bc7cfa\",\n \"timestamp\": \"2022-03-01 12:47:31\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -246,\n \"amount_before\": 1754,\n \"amount_after\": 1508,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"MDvUB6sV90PvV03QSBDsso\",\n \"timestamp\": \"2022-03-01 12:47:16\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"amount\": 1500,\n \"amount_before\": 254,\n \"amount_after\": 1754,\n \"order_id\": \"2829e663-682a-4806-bd80-9b839e43af3e\",\n \"custom_order_id\": \"13-70652\",\n \"payment_type\": \"CARD\",\n \"operation_type\": \"CARD_DEPOSIT\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"6c8de8b5-50af-47d8-b32d-5064254e82cf\",\n \"timestamp\": \"2022-03-01 12:46:46\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -246,\n \"amount_before\": 500,\n \"amount_after\": 254,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"FsZGSq9QABMVTEhs0IjWBU\",\n \"timestamp\": \"2022-03-01 12:46:46\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"amount\": 500,\n \"amount_before\": 0,\n \"amount_after\": 500,\n \"order_id\": \"4176e398-06ea-472d-a959-166e38a1f1db\",\n \"custom_order_id\": \"13-e953c\",\n \"payment_type\": \"CARD\",\n \"operation_type\": \"CARD_DEPOSIT\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"509e2cc1-72b5-41c9-8120-01fe8b3168d9\",\n \"timestamp\": \"2022-02-22 10:07:39\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": null,\n \"amount\": -500,\n \"amount_before\": 500,\n \"amount_after\": 0,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"sps3w0Kn5osyE0jl9UTwa3\",\n \"timestamp\": \"2022-02-22 10:07:39\",\n \"company_id\": \"8981e6d1-79d4-4030-9d60-e2701b37e796\",\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"amount\": 500,\n \"amount_before\": 0,\n \"amount_after\": 500,\n \"order_id\": \"f7a007d9-7a4e-467d-8ce8-61ce72c8c2b2\",\n \"custom_order_id\": \"222-13a58\",\n \"payment_type\": \"CARD\",\n \"operation_type\": \"CARD_DEPOSIT\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"b65c8bf5-3f2b-4611-acdc-6da4f67a8e08\",\n \"timestamp\": \"2022-02-22 09:49:18\",\n \"company_id\": \"3c6e77d4-4dcb-456f-b67c-62ed8cc62aa8\",\n \"user_id\": null,\n \"amount\": -500,\n \"amount_before\": 500,\n \"amount_after\": 0,\n \"order_id\": null,\n \"custom_order_id\": null,\n \"operation_type\": \"WITHDRAWAL\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n },\n {\n \"id\": \"HUUfhpRxEbtMMb6AAPEf9G\",\n \"timestamp\": \"2022-02-22 09:49:18\",\n \"company_id\": \"3c6e77d4-4dcb-456f-b67c-62ed8cc62aa8\",\n \"user_id\": \"98cf93bb-9312-46e2-97b6-f699ae7b3f06\",\n \"amount\": 500,\n \"amount_before\": 0,\n \"amount_after\": 500,\n \"order_id\": \"876cee04-b94a-450a-b896-84c0990a3cd6\",\n \"custom_order_id\": \"222-336fd\",\n \"payment_type\": \"CARD\",\n \"operation_type\": \"CARD_DEPOSIT\",\n \"currency\": {\n \"code\": \"RUB\"\n }\n }\n ]\n}\n\nЭкспорт транзакций для списка компаний с пагинацией
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST /bill_transactions_admin_excel?body={
\"companies\": [
{
\"id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\"
},
{
\"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\"
}
],
\"from\": \"2021-08-25 09:00:00\",
\"to\": \"2021-08-26 19:00:00\"
}
В теле запроса необходимо отправить следующие поля:
\ncompanies - списко выбранных компаний, необязательное
\nfrom - начала периода
\nto - окончания периода
\nВ ответе возвращается эксель файл
\n","urlObject":{"path":["api_v1","bill_transactions_admin_excel"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"b2669150-d596-413d-87b5-5c6db990343c","name":"/bill_transactions_admin_excel","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"first_row\": 0,\n \"max_rows\": 100,\n \"timezone_key\": \"UTC+3\",\n \"from\": \"2024-04-01 00:00:00\",\n \"to\": \"2024-05-01 00:00:00\",\n \"dealer\": {\n \"id\": \"c5e63357-6b63-4ea4-8b91-beb53f749f69\"\n },\n \"conditions\": [\n {\"key\": \"payment_type\", \"values\": [\"CARD_DEPOSIT\", \"CASH_DEPOSIT\"]}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dev5.skif.pro/api_v1/bill_transactions_admin_excel"},"status":"OK","code":200,"_postman_previewlanguage":"raw","header":[{"key":"Server","value":"nginx/1.22.1","enabled":true},{"key":"Date","value":"Thu, 30 May 2024 14:18:52 GMT","enabled":true},{"key":"Content-Length","value":"12249","enabled":true},{"key":"Connection","value":"keep-alive","enabled":true},{"key":"Request-Time","value":"321","enabled":true},{"key":"Content-Disposition","value":"attachment; filename=bill-2024-04-01_000000-2024-05-01_000000.xlsx","enabled":true}],"cookie":[],"responseTime":null,"body":"PK\u0003\u0004-\u0000\b\u0000\b\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0018\u0000\u0000\u0000xl/worksheets/sheet1.xml��[s\u001bW���\n��4�;��4a��֙n�O�=�gZ\u0004%�I�AB�����倧2\u0013���݉�\u001d�ٕ]�\u001f��\r`���ߏ\u000fg�^^��O��{?\\����>�o�>�?��o����?>���~����j�9�.������f������/�Ǜ�\u001f�ϫ��r�~y��l�������eus�/z|��_]�/\u001fo��\u000f\u000e?��O<�ww��V��?}}\\=m\u000e&/���Ͷ��/�ϯ�\u001f���\u0010_���\u001f6������������j�=�|^�����y�o~[��\u001f�������\u000f?o\u001b������\u000f�.��w���\u0015�6�������O���W��~��ռ>�m�?��?w�\b��ϯΏF����Dz�~�mk�����\u000f��X�����e��0ڂخ����u���\u001e�x��g�7�������͗���\u001f���d����>}}ݬ\u001f?\b����\u0011�X�n\u0016���σ��j��\u0006oV���z\r��0�5�^�Q�\u001a�y}��8Y�߬�W��5I^����5M^����^�Y�yM�תw��v/��}�\u0006���n��6�n��;��\b��ݎo��{oǷ��ű��p�\u0001v/��}�.�;�\u0003�\u0017��F�K���Qh���fs��������\u0000��\u001e�>�^l��gۂ����\u000fW�.��\u0015m�o��������f��酇o\u000bo���aM�������l���/Q�\u0012\u0003\\�\u0017]b�K�u�\u0011.��%ƸD�KLp����\u0014�\b��\f���.��\u0010��4'\u0016ɛ~�H{b\u0011ڬ�'\u0016���<�\bm���\"�e�E�w�����\u0018�~:,M��\b�/ �֟�k�7�\u0002j�Km�>\u0011��\u0014����O��pD+m��фVۂ3�\u0005�ɂ�L�ibA\u0004��7�\u00133\u0000��\u0007M�\u000e\u001c�اw�ܺ�ޱ�JއAd�^C\u0001*�\"44�v\u001bP'��`Lk�\u0006���K���\u0005\u0011 N� NM��F�\u000e�8\u001d Z�O���u\u0015��r@b\r�\f�k(@%C�\r]\f��Р|�G\\�f�0\u000eU.���\u001b'\u0016D�8{�83\u0003�._\u001d4q:`����u\u001d]��C,���?�\u0015���U�Jfi��IK\r5�K��4m�k\u0010i^z��7Q,�����\u0015=��]��)\bh\u0012��@\u0014�\u0001\u001d$�`,�&֒s\r�\u0000u�\nX�H�+\u0006�ܢ1�8\u0010\u001fd���\u001d(�T$�v������m\n�R%Q�\u0012Q�>�c-\u0018�\u001e���!\u001flAU�^S\u0001k\u0005�mJ�:\u001d��+Остановка автоплатежа для компании
\nРоль: Читатель и выше.
\nПараметры ответа:
\nВ случае успешного отключения возвращается код 200 c пустым body.
\nЕсли не добавлена карта или не включен автоплатеж, то возвращается ошибка.
\nПример ошибки:
\n{\n \"code\": 4220,\n \"field\": \"\",\n \"message\": \"Карта не добавлена\"\n}\n\nВключение автоплатежа для компании
\nРоль: Читатель и выше.
\nПараметры ответа:
\nВ случае успешного включения возвращается код 200 c пустым body.
\nЕсли не добавлена карта или уже включен автоплатеж, то возвращантся ошибка.
\nПример ошибки:
\n{\n \"code\": 4220,\n \"field\": \"\",\n \"message\": \"Карта не добавлена\"\n}\n\nУдаление сохраненной карты
\nРоль: Читатель и выше.
\nПараметры ответа:
\nВ случае успешного удаления возвращается код 200 c пустым body.
\nЕсли не добавлена карта, возвращается ошибка.
\nПример ошибки:
\n{\n\"code\": 4220,\n\"field\": \"\",\n\"message\": \"Карта не добавлена\"\n}\n\nМетоды для интеграции с сервисом биллинга
\n","_postman_id":"70031c9b-98ce-4f24-86da-3e75a5aa12cf"},{"name":"Терминалы","item":[{"name":"/terminals","id":"311bc19b-8f1a-4e4a-add7-d7f5c9d1790c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"12345678910\"\n}"},"url":"{{base_url}}/api_v1/terminals","description":"Создание нового терминала в компании
\nРоль: Супервизор и выше.
\nПараметры:
\n\"company_id\": ID компании, обязательно\n\"imei\": Imei, текст, обязательно,\n\"password\": Пароль, текст, необязательно,\n\"is_blocked\": true, если блокирован, необязательно\n\"use_lbs_for_coords\": true, если определение координат по GPS должно дополняться координатами по LBS\n\nПример запроса:
\n{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"12345678\",\n \"password\": \"xyz\",\n \"use_lbs_for_coords\": true\n}\n\nПример ответа:
\nВозвращается созданная запись
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"12345678\",\n \"password\": \"xyz\",\n \"use_lbs_for_coords\": true\n}\n\nСоздание нескольких терминалов в компании
\nРоль: Супервизор и выше.
\nПараметры:
\n\"companies\": Список компании, обязательно\n\"imeis\": список Imei, текст, обязательно,\n\"password\": Пароль, тектс, необязательно\n\nПример запроса:
\n{\n \"companies\": [\n {\"id\": \"d852f0ef-ed7e-490b-866d-a6f1a1eb354f\"},\n {\"id\": \"6b994029-6aa1-4e87-9207-36056ca890dd\"}\n ],\n \"imeis\": [\"11345679\", \"113456710\"],\n \"password\": \"xyzt\"\n}\n\nПример ответа:
\nВозвращается созданные записи
\n[\n {\n \"id\": \"a4f71782-9ccf-4da2-a132-303c27c48707\",\n \"company_id\": \"d852f0ef-ed7e-490b-866d-a6f1a1eb354f\",\n \"imei\": \"11345679\",\n \"password\": \"xyzt\"\n },\n {\n \"id\": \"99d307f0-5c20-45bf-a6b7-d261d75327cc\",\n \"company_id\": \"d852f0ef-ed7e-490b-866d-a6f1a1eb354f\",\n \"imei\": \"113456710\",\n \"password\": \"xyzt\"\n },\n {\n \"id\": \"84797aa9-0aad-459a-80ac-9cd2601b587b\",\n \"company_id\": \"6b994029-6aa1-4e87-9207-36056ca890dd\",\n \"imei\": \"11345679\",\n \"password\": \"xyzt\"\n },\n {\n \"id\": \"f4a42e66-27eb-4e98-b51d-4f36de23458a\",\n \"company_id\": \"6b994029-6aa1-4e87-9207-36056ca890dd\",\n \"imei\": \"113456710\",\n \"password\": \"xyzt\"\n }\n]\n\nПоиск imei по ID
\nВозвращает массив терминалов компании
\nЕсли в параметре ids содержится только один id, то вернется не массив из 1 элемента, а конкретный терминал.
\nРоль: Читатель и выше.
\nПример запроса:
\n/terminals?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\nПример ответа:
\n{\n \"id\": \"da47b5da-d030-44f0-acc4-a43107dbb090\",\n \"company_id\": \"d88cb614-7d0e-48d5-ba95-0001825d68a8\",\n \"imei\": \"123456\",\n \"password\": \"xyz\",\n \"use_lbs_for_coords\": false\n}\n\nОбновить данные терминала
\nОбновляет переданные параметры
\nРоль: Супервизор и выше.
\nПараметры:
\nсм метод POST /terminals
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /terminals?ids=:id
\n","urlObject":{"path":["api_v1","terminals",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID терминала
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"e3366a30-7eec-44a8-9019-51fd14eb00ef"},{"name":"/terminals/batch","id":"b4962dc8-867b-4634-9d53-aba050c65482","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"terminals\": [\n {\n \"id\": \"d799058e-1be8-4404-b476-6b5e49d4844a\"\n },\n {\n \"id\": \"3f6f01f0-edcd-4942-94e5-45dd8e293150\"\n },\n {\n \"id\": \"56760481-d045-4091-9b5d-ad092c14a69e\"\n }\n ],\n \"is_blocked\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/terminals/batch","description":"Обновить данные терминала
\nМассовое обновление некоторых полей выбранных терминалв
\nРоль: Супервизор и выше.
\nБоди запроса:
\nterminals - Список терминалов
\nis_blocked - true для блокировки, false для разблокировки
\nОтвет:
\nВозвращаются обновленные терминалы
\nПример запроса:
\n{\n \"terminals\": [\n {\"id\": \"d799058e-1be8-4404-b476-6b5e49d4844a\"},\n {\"id\": \"3f6f01f0-edcd-4942-94e5-45dd8e293150\"},\n {\"id\": \"56760481-d045-4091-9b5d-ad092c14a69e\"}\n ],\n \"is_blocked\": true\n}\n\nПример ответа:
\n[\n {\n \"id\": \"d799058e-1be8-4404-b476-6b5e49d4844a\",\n \"company_id\": \"bfbb4c66-4242-4997-8905-425245d8136f\",\n \"dealer_id\": \"17d41d6f-a8ae-4644-9793-92988604746a\",\n \"imei\": \"3528480xxxxxxxx\",\n \"is_blocked\": false,\n \"use_lbs_for_coords\": false,\n \"use_previous_param_value\": false\n },\n {\n \"id\": \"3f6f01f0-edcd-4942-94e5-45dd8e293150\",\n \"company_id\": \"bfbb4c66-4242-4997-8905-425245d8136f\",\n \"dealer_id\": \"17d41d6f-a8ae-4644-9793-92988604746a\",\n \"imei\": \"3528480xxxxxxxx\",\n \"is_blocked\": false,\n \"use_lbs_for_coords\": false,\n \"use_previous_param_value\": false\n },\n {\n \"id\": \"56760481-d045-4091-9b5d-ad092c14a69e\",\n \"company_id\": \"d5fbe5f4-5d68-41bc-bb43-2dea42569fdb\",\n \"dealer_id\": \"17d41d6f-a8ae-4644-9793-92988604746a\",\n \"imei\": \"3528480xxxxxxxx\",\n \"is_blocked\": false,\n \"use_lbs_for_coords\": false,\n \"use_previous_param_value\": false\n }\n]\n\nУдаление терминала компании по его ID
\nПараметры:
\nid записи
\nРоль: Супервизор и выше.
\nОтвет: 200
\nЕсли терминал с таким id не найден, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID терминала
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"48ffb111-045d-42c2-b0fd-2b4b3f55a908"},{"name":"/terminals?ids=:ids","id":"f51ba4f0-128f-4e1b-95b6-95ec14c27310","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/terminals?ids=","description":"Планирование удаления терминалов компании по их ID
\nСм. DELETE /units?ids=:ids
\nРоль: Супервизор и выше.
\n","urlObject":{"path":["api_v1","terminals"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"f51ba4f0-128f-4e1b-95b6-95ec14c27310"},{"name":"/terminals/list","id":"2b2697a8-da2b-46c6-a900-cad81409a6e8","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 2,\n \"sortField\": \"imei\",\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"123\"\n }\n ],\n \"companies\": [\n {\"id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/terminals/list","description":"Поиск терминалов по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[imei]
sortDesc - сортировка по убыванию, значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - imei
companies - список компаний в которых искать терминал
\nРоль: Читатель и выше.
\nПример запроса:
\nПолучить первые 2 imei компании 36c52c2b-64a0-45dd-a75f-3c723fffee77 или 95f38fda-b8b5-4754-8fa2-07fadb72637d имеющие подстроку \"123\"
\nЕсли у пользователя роль не супервизор, то возвращается только imei компании пользователя.
\n{\n \"from\": 0,\n \"count\": 2,\n \"sortField\": \"imei\",\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"123\" \n } \n ]\n}\n\nОтвет:
\n{\n \"max\": 9,\n \"list\": [\n {\n \"id\": \"fcdb331c-4e27-4fb3-91b6-443330dbef2c\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040831233\",\n \"password\": \"123456\"\n },\n {\n \"id\": \"0ad9df34-ce6e-4665-a1f8-f6e2d93d5d1e\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531042812348\",\n \"is_blocked\": true\n }\n ]\n}\n\nПолучение лога терминала
\nПараметры:
\nimei - IMEI терминала
from - начальный индекс записи, начинается с нуля
max - максимальное количество записей
Роль: Администратор и выше.
\nПример запроса:
\nhttps://dev.skif.pro/api_v1/terminals_logs?from=0&max=10&imei=862531046859196
\nПример ответа:
\n{\n \"imei\": \"862531046859196\",\n \"date\": \"2022_03_28\",\n \"report\": {\n \"name\": \"Сырые данные\",\n \"key\": \"pureparams\",\n \"max_rows\": 1531,\n \"columns\": [\n {\n \"key\": \"№\",\n \"name\": \"№\",\n \"is_visible\": true\n },\n {\n \"key\": \"datepoint\",\n \"name\": \"datepoint\",\n \"is_visible\": true\n },\n {\n \"key\": \"satellites\",\n \"name\": \"satellites\",\n \"is_visible\": true\n },\n {\n \"key\": \"altitude\",\n \"name\": \"altitude\",\n \"is_visible\": true\n },\n {\n \"key\": \"speedkph\",\n \"name\": \"speedkph\",\n \"is_visible\": true\n },\n {\n \"key\": \"angle\",\n \"name\": \"angle\",\n \"is_visible\": true\n },\n {\n \"key\": \"TEMP_1\",\n \"name\": \"TEMP_1\",\n \"is_visible\": true\n },\n {\n \"key\": \"INFO_MES\",\n \"name\": \"INFO_MES\",\n \"is_visible\": true\n },\n {\n \"key\": \"PWR_EXT_PARAM\",\n \"name\": \"PWR_EXT_PARAM\",\n \"is_visible\": true\n },\n {\n \"key\": \"longitude\",\n \"name\": \"longitude\",\n \"is_visible\": true\n },\n {\n \"key\": \"LONGITUDE_TAG\",\n \"name\": \"LONGITUDE_TAG\",\n \"is_visible\": true\n },\n {\n \"key\": \"DIN1\",\n \"name\": \"DIN1\",\n \"is_visible\": true\n },\n {\n \"key\": \"ANGLE_TAG\",\n \"name\": \"ANGLE_TAG\",\n \"is_visible\": true\n },\n {\n \"key\": \"ALTITUDE_TAG\",\n \"name\": \"ALTITUDE_TAG\",\n \"is_visible\": true\n },\n {\n \"key\": \"DINX_MODE\",\n \"name\": \"DINX_MODE\",\n \"is_visible\": true\n },\n {\n \"key\": \"UNIXTIME\",\n \"name\": \"UNIXTIME\",\n \"is_visible\": true\n },\n {\n \"key\": \"SPEED_TAG\",\n \"name\": \"SPEED_TAG\",\n \"is_visible\": true\n },\n {\n \"key\": \"SATELLITES_TAG\",\n \"name\": \"SATELLITES_TAG\",\n \"is_visible\": true\n },\n {\n \"key\": \"PWR_INT_PARAM\",\n \"name\": \"PWR_INT_PARAM\",\n \"is_visible\": true\n },\n {\n \"key\": \"latitude\",\n \"name\": \"latitude\",\n \"is_visible\": true\n },\n {\n \"key\": \"LATITUDE_TAG\",\n \"name\": \"LATITUDE_TAG\",\n \"is_visible\": true\n }\n ],\n \"rows\": [\n {\n \"№\": 1,\n \"satellites\": \"15\",\n \"altitude\": \"80\",\n \"speedkph\": \"0\",\n \"angle\": \"14\",\n \"datepoint\": \"2022-03-28 12:30:37\",\n \"TEMP_1\": \"2443\",\n \"INFO_MES\": \"306\",\n \"PWR_EXT_PARAM\": \"4178\",\n \"longitude\": \"37.634151458740234\",\n \"LONGITUDE_TAG\": \"37.634151458740234\",\n \"DIN1\": \"2\",\n \"ANGLE_TAG\": \"14\",\n \"ALTITUDE_TAG\": \"80\",\n \"DINX_MODE\": \"2\",\n \"UNIXTIME\": \"1648470637000\",\n \"SPEED_TAG\": \"0\",\n \"SATELLITES_TAG\": \"15\",\n \"PWR_INT_PARAM\": \"14727\",\n \"latitude\": \"55.70588302612305\",\n \"LATITUDE_TAG\": \"55.70588302612305\"\n },\n {\n \"№\": 2,\n \"satellites\": \"15\",\n \"altitude\": \"80\",\n \"speedkph\": \"0\",\n \"angle\": \"14\",\n \"datepoint\": \"2022-03-28 12:30:07\",\n \"TEMP_1\": \"2443\",\n \"INFO_MES\": \"306\",\n \"PWR_EXT_PARAM\": \"0\",\n \"longitude\": \"37.634151458740234\",\n \"LONGITUDE_TAG\": \"37.634151458740234\",\n \"DIN1\": \"2\",\n \"ANGLE_TAG\": \"14\",\n \"ALTITUDE_TAG\": \"80\",\n \"DINX_MODE\": \"2\",\n \"UNIXTIME\": \"1648470607000\",\n \"SPEED_TAG\": \"0\",\n \"SATELLITES_TAG\": \"15\",\n \"PWR_INT_PARAM\": \"14713\",\n \"latitude\": \"55.70588302612305\",\n \"LATITUDE_TAG\": \"55.70588302612305\"\n },\n {\n \"№\": 3,\n \"satellites\": \"14\",\n \"altitude\": \"80\",\n \"speedkph\": \"0\",\n \"angle\": \"14\",\n \"datepoint\": \"2022-03-28 12:29:37\",\n \"TEMP_1\": \"2443\",\n \"INFO_MES\": \"306\",\n \"PWR_EXT_PARAM\": \"0\",\n \"longitude\": \"37.634151458740234\",\n \"LONGITUDE_TAG\": \"37.634151458740234\",\n \"DIN1\": \"2\",\n \"ANGLE_TAG\": \"14\",\n \"ALTITUDE_TAG\": \"80\",\n \"DINX_MODE\": \"2\",\n \"UNIXTIME\": \"1648470577000\",\n \"SPEED_TAG\": \"0\",\n \"SATELLITES_TAG\": \"14\",\n \"PWR_INT_PARAM\": \"14713\",\n \"latitude\": \"55.70588302612305\",\n \"LATITUDE_TAG\": \"55.70588302612305\"\n },\n {\n \"№\": 4,\n \"satellites\": \"13\",\n \"altitude\": \"80\",\n \"speedkph\": \"0\",\n \"angle\": \"14\",\n \"datepoint\": \"2022-03-28 12:29:07\",\n \"TEMP_1\": \"2437\",\n \"INFO_MES\": \"306\",\n \"PWR_EXT_PARAM\": \"522\",\n \"longitude\": \"37.634151458740234\",\n \"LONGITUDE_TAG\": \"37.634151458740234\",\n \"DIN1\": \"2\",\n \"ANGLE_TAG\": \"14\",\n \"ALTITUDE_TAG\": \"80\",\n \"DINX_MODE\": \"2\",\n \"UNIXTIME\": \"1648470547000\",\n \"SPEED_TAG\": \"0\",\n \"SATELLITES_TAG\": \"13\",\n \"PWR_INT_PARAM\": \"14727\",\n \"latitude\": \"55.70588302612305\",\n \"LATITUDE_TAG\": \"55.70588302612305\"\n },\n {\n \"№\": 5,\n \"satellites\": \"15\",\n \"altitude\": \"80\",\n \"speedkph\": \"0\",\n \"angle\": \"14\",\n \"datepoint\": \"2022-03-28 12:28:37\",\n \"TEMP_1\": \"2437\",\n \"INFO_MES\": \"400\",\n \"PWR_EXT_PARAM\": \"0\",\n \"longitude\": \"37.634151458740234\",\n \"LONGITUDE_TAG\": \"37.634151458740234\",\n \"DIN1\": \"2\",\n \"ANGLE_TAG\": \"14\",\n \"ALTITUDE_TAG\": \"80\",\n \"DINX_MODE\": \"2\",\n \"UNIXTIME\": \"1648470517000\",\n \"SPEED_TAG\": \"0\",\n \"SATELLITES_TAG\": \"15\",\n \"PWR_INT_PARAM\": \"14713\",\n \"latitude\": \"55.70588302612305\",\n \"LATITUDE_TAG\": \"55.70588302612305\"\n },\n {\n \"№\": 6,\n \"satellites\": \"15\",\n \"altitude\": \"100\",\n \"speedkph\": \"0\",\n \"angle\": \"150\",\n \"datepoint\": \"2022-03-28 12:28:17\",\n \"SATELLITES_TAG\": \"15\",\n \"TEMP_1\": \"2437\",\n \"ALTITUDE_TAG\": \"100\",\n \"latitude\": \"55.70598220825195\",\n \"LATITUDE_TAG\": \"55.70598220825195\",\n \"SPEED_TAG\": \"0\",\n \"ANGLE_TAG\": \"150\",\n \"PWR_INT_PARAM\": \"14699\",\n \"DIN1\": \"2\",\n \"PWR_EXT_PARAM\": \"4176\",\n \"DINX_MODE\": \"2\",\n \"INFO_MES\": \"407\",\n \"longitude\": \"37.6342887878418\",\n \"LONGITUDE_TAG\": \"37.6342887878418\",\n \"UNIXTIME\": \"1648470497000\"\n },\n {\n \"№\": 7,\n \"satellites\": \"16\",\n \"altitude\": \"100\",\n \"speedkph\": \"0\",\n \"angle\": \"150\",\n \"datepoint\": \"2022-03-28 12:28:04\",\n \"SATELLITES_TAG\": \"16\",\n \"TEMP_1\": \"2437\",\n \"ALTITUDE_TAG\": \"100\",\n \"latitude\": \"55.70598220825195\",\n \"LATITUDE_TAG\": \"55.70598220825195\",\n \"SPEED_TAG\": \"0\",\n \"ANGLE_TAG\": \"150\",\n \"PWR_INT_PARAM\": \"14686\",\n \"DIN1\": \"2\",\n \"PWR_EXT_PARAM\": \"521\",\n \"DINX_MODE\": \"2\",\n \"INFO_MES\": \"306\",\n \"longitude\": \"37.6342887878418\",\n \"LONGITUDE_TAG\": \"37.6342887878418\",\n \"UNIXTIME\": \"1648470484000\"\n },\n {\n \"№\": 8,\n \"satellites\": \"15\",\n \"altitude\": \"100\",\n \"speedkph\": \"0\",\n \"angle\": \"150\",\n \"datepoint\": \"2022-03-28 12:27:34\",\n \"SATELLITES_TAG\": \"15\",\n \"TEMP_1\": \"2437\",\n \"ALTITUDE_TAG\": \"100\",\n \"latitude\": \"55.70598220825195\",\n \"LATITUDE_TAG\": \"55.70598220825195\",\n \"SPEED_TAG\": \"0\",\n \"ANGLE_TAG\": \"150\",\n \"PWR_INT_PARAM\": \"14713\",\n \"DIN1\": \"2\",\n \"PWR_EXT_PARAM\": \"0\",\n \"DINX_MODE\": \"2\",\n \"INFO_MES\": \"306\",\n \"longitude\": \"37.6342887878418\",\n \"LONGITUDE_TAG\": \"37.6342887878418\",\n \"UNIXTIME\": \"1648470454000\"\n },\n {\n \"№\": 9,\n \"satellites\": \"15\",\n \"altitude\": \"100\",\n \"speedkph\": \"0\",\n \"angle\": \"150\",\n \"datepoint\": \"2022-03-28 12:27:04\",\n \"SATELLITES_TAG\": \"15\",\n \"TEMP_1\": \"2437\",\n \"ALTITUDE_TAG\": \"100\",\n \"latitude\": \"55.70598220825195\",\n \"LATITUDE_TAG\": \"55.70598220825195\",\n \"SPEED_TAG\": \"0\",\n \"ANGLE_TAG\": \"150\",\n \"PWR_INT_PARAM\": \"14713\",\n \"DIN1\": \"2\",\n \"PWR_EXT_PARAM\": \"0\",\n \"DINX_MODE\": \"2\",\n \"INFO_MES\": \"306\",\n \"longitude\": \"37.6342887878418\",\n \"LONGITUDE_TAG\": \"37.6342887878418\",\n \"UNIXTIME\": \"1648470424000\"\n },\n {\n \"№\": 10,\n \"satellites\": \"15\",\n \"altitude\": \"100\",\n \"speedkph\": \"0\",\n \"angle\": \"150\",\n \"datepoint\": \"2022-03-28 12:26:34\",\n \"SATELLITES_TAG\": \"15\",\n \"TEMP_1\": \"2437\",\n \"ALTITUDE_TAG\": \"100\",\n \"latitude\": \"55.70598220825195\",\n \"LATITUDE_TAG\": \"55.70598220825195\",\n \"SPEED_TAG\": \"0\",\n \"ANGLE_TAG\": \"150\",\n \"PWR_INT_PARAM\": \"14713\",\n \"DIN1\": \"2\",\n \"PWR_EXT_PARAM\": \"0\",\n \"DINX_MODE\": \"2\",\n \"INFO_MES\": \"306\",\n \"longitude\": \"37.6342887878418\",\n \"LONGITUDE_TAG\": \"37.6342887878418\",\n \"UNIXTIME\": \"1648470394000\"\n }\n ]\n }\n}\n\nСтруктура ответа:
\ndate - Дата
max_rows - Максимальное количество строк
columns - колонки
с - строки, отсортированные по датам в обратном порядке
начальный индекс записи, начинается с нуля
\n","type":"text/plain"},"key":"from","value":""},{"description":{"content":"максимальное количество записей
\n","type":"text/plain"},"key":"max","value":""},{"description":{"content":"IMEI терминала
\n","type":"text/plain"},"key":"imei","value":""}],"variable":[]}},"response":[],"_postman_id":"9007a100-742d-4f68-87d3-ec45063d5067"}],"id":"ff43d819-d071-48fc-95a9-af11bfc6f627","description":"API по работе с Терминалами
\n","event":[{"listen":"prerequest","script":{"id":"68ec6ba2-d149-4695-b5c0-e209a66b88a0","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"72f82a6f-f7a4-4c50-ac86-154170b1e1d8","type":"text/javascript","exec":[""]}}],"_postman_id":"ff43d819-d071-48fc-95a9-af11bfc6f627"},{"name":"Ретрансляции","item":[{"name":"/retranslators","id":"dd924332-fd0a-4f39-b9a8-a47b20ef220b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \" Комментс\",\n \"retrans_server\": \"10.11.12.13\", \n \"retrans_port\": 8080,\n \"retrans_pw\": \"1234\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"terminals\": [\n {\"imei\": \"51233441252927\", \"to_imei\": \"4324324234\"},\n {\"imei\": \"350612070173768\", \"to_imei\": \"3244324\"}\n ]\n}"},"url":"{{base_url}}/api_v1/retranslators","description":"Создание новой ретрансляции
\nПараметры:
\n\"name\": Название ретрансляции, текcт, обязательно,\n\"comment\": Комментарий, текcт, необязательно\n\"retrans_server\": Адрес сервера ретрансляции, текcт, обязательно,\n\"retrans_port\": Порт сервера ретрансляции, целое число, обязательно,\n\"retrans_pw\": Пароль ретрансляции, текст, не обязательно,\n\"retrans_protocol\": Протокол, возможные ключи получают из dictionaries, где type=retranslator_protocols\n\"is_active\": Статус, если true то ретрансляция включена, иначе отключена\n\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \" Комментс\",\n \"retrans_server\": \"10.11.12.13\", \n \"retrans_port\": 8080,\n \"retrans_pw\": \"1234\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"terminals\": [\n {\"imei\": \"51233441252927\", \"to_imei\": \"4324324234\"},\n {\"imei\": \"350612070173768\", \"to_imei\": \"3244324\"}\n ]\n}\n\nПример ответа:
\nВозвращается созданная запись
\n{\n \"id\": \"2c2fd09c-5584-42cb-a3d0-4006bcfddf71\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \" Комментс\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"10.11.12.13\",\n \"retrans_port\": 8080,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": \"2024-08-28 00:00:00\",\n \"terminals\": [\n {\n \"imei\": \"51233441252927\",\n \"to_imei\": \"4324324234\"\n },\n {\n \"imei\": \"350612070173768\",\n \"to_imei\": \"3244324\"\n }\n ]\n}\n\nYandex retranslator
\nДля yandex retranslator используются дополнительние поля:
\nmember_name - Идентификатор участника программы, текстовое поле:
route_name - Идентификатор маршрута, текстовое поле:
gps_category_type_key - Категория GPS-сигнала
public_vehicle_type_key - Тип общественного транспортного средства
{\n \"retrans_server\": \"10.10.10.10\",\n \"company_name\": \"0000 тест001\",\n \"retrans_protocol\": \"ya_transport\",\n \"retrans_port\": \"1234\",\n \"terminals\": [\n {\n \"imei\": \"356917059172986\",\n \"to_imei\": \"1233322\"\n }\n ],\n \"member_name\": \"НКгоалв\",\n \"route_name\": \"123\",\n \"gps_category_type_key\": \"gps_category_type_s\",\n \"public_vehicle_type_key\": \"public_vehicle_type_bus\"\n}\n\nПоиск imei по ID
\nВозвращает массив ретрансляций по ID.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная ретрансляция.
\nРоль: Читатель и выше.
\nПример запроса:
\n/retranslators?ids=eeadc5d1-9a68-4083-bef6-51173d532cb0\n\nПример ответа:
\n{\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \" Комментс\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"10.11.12.13\",\n \"retrans_port\": 8080,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": \"2024-08-28 00:00:00\",\n \"terminals\": [\n {\n \"imei\": \"862531041183956\",\n \"to_imei\": \"4324324234\"\n },\n {\n \"imei\": \"862531041156705\",\n \"to_imei\": \"3244324\"\n }\n ]\n}\n\nОбновить данные ретрансляции
\nОбновляет переданные параметры
\nРоль: Супервизор и выше.
\nПараметры:
\nСм метод POST /retranslators
\nОтвет:
\nАналогичен одному объекту из возврата метода GET /retranslators?ids=:id
\n","urlObject":{"path":["api_v1","retranslators",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"62dd4f50-822a-40a6-82e3-8fd12bf2284f"},{"name":"/retranslators/:id","id":"36f9448f-edc2-4418-a169-66ca86906799","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/retranslators/:id","description":"Удаление ретрансляции по его ID
\nПараметры:
\nid записи
\nРоль: Супервизор и выше.
\nОтвет: 200
\nЕсли ретрансляция с таким id не найдена, то возвращается ошибка 422.
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"36f9448f-edc2-4418-a169-66ca86906799"},{"name":"/retranslators?ids=:ids","id":"473d33a7-7efc-4b1a-9fdb-2c34f2529306","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/retranslators?ids=","description":"Удаление ретрансляции по id
\nСм. DELETE /units?ids=:ids
\nРоль: Супервизор и выше.
\n","urlObject":{"path":["api_v1","retranslators"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"473d33a7-7efc-4b1a-9fdb-2c34f2529306"},{"name":"/retranslators/list","id":"11e5d58d-ce47-4b11-9718-9ba190e0eef4","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 2,\n \"sortField\": \"imei\",\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"1\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/retranslators/list","description":"Поиск ретрансляции по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[imei]
sortDesc - сортировка по убыванию, значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - imei, retrans_server
Роль: Читатель и выше.
\nПример запроса:
\nПолучить первые 2 imei имеющие подстроку \"123\"
\n{\n \"from\": 0,\n \"count\": 2,\n \"sortField\": \"imei\",\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"123\" \n } \n ]\n}\n\nОтвет:
\n{\n \"max\": 9,\n \"list\": [\n {\n \"id\": \"fcdb331c-4e27-4fb3-91b6-443330dbef2c\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040831233\",\n \"retrans_server\": \"10.10.10.10\",\n \"retrans_port\": 8080,\n \"retrans_pw\": \"xyzt\"\n },\n {\n \"id\": \"0ad9df34-ce6e-4665-a1f8-f6e2d93d5d1e\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531042812348\",\n \"retrans_server\": \"10.10.10.10\",\n \"retrans_port\": 8080,\n \"retrans_pw\": \"xyzt\"\n }\n ]\n}\n\nПолучение лога ретрансляции
\nПараметры запроса:
\nid - ID ретранслятора
\nПоля тела json-запроса:
\nfrom - дата и время начала интервала(в формате yyyy-MM-dd HH:mm:ss).
\nto - дата и время окончания интервала(в формате yyyy-MM-dd HH:mm:ss).
\nmax - Параметр для пагинации. Максимальное число строк.
\noffset - Параметр для пагинации. Определяет количество пропущенных строк, начиная с нулевой строки. Если параметр отсутствует в запросе, то по дефолту он равен 0.
\nimeis - список выбранных IMEI, они должны быть выбраны из текущей ретрансляции. Если не указано или пусто, то лог получается по первому IMEI.
\nОтвет состоит из трех полей:
\ncolumns - колонки
\nrows - строки, состоит из datetime, imei, is_error, text полей.
\nmax_rows максимальное количество строк, используется для пагинации
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST https://admin-dev.skif.pro/api_v1/retranslators/d8105af4-ce13-4451-b1bc-32c9988e90d1/logs
\n{\n \"offset\": 0,\n \"max\": 100,\n \"from\": \"2024-09-17 00:00:00\",\n \"to\": \"2024-09-17 23:59:59\",\n \"imeis\": [\"336023881\", \"336023861\"]\n}\n\nОтвет:
\n{\n \"columns\": [\n {\n \"key\": \"datetime\",\n \"name\": \"Дата\"\n },\n {\n \"key\": \"imei\",\n \"name\": \"IMEI\"\n },\n {\n \"key\": \"is_error\",\n \"name\": \"Статус\"\n },\n {\n \"key\": \"text\",\n \"name\": \"Сообщение\"\n }\n ],\n \"rows\": [\n {\n \"datetime\": \"2024-09-17 14:07:11\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:10\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:03\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:02\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:01\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка: \\n#D#170924;090731;0000.000000;S;00000.000000;W;0;0;0;0;NA;NA;NA;1,1,1,1;NA;battery_lvl:1:41,flg:1:2,fuel1:1:2043,fuel1_state:1:2,fuel1_temp:1:21,fuel2:1:0,fuel2_state:1:0,fuel2_temp:1:0,fuel3:1:0,fuel3_state:1:0,fuel3_temp:1:0,fuel4:1:0,fuel4_state:1:0,fuel4_temp:1:0,global_number:1:5866372,ignition:1:0,mileage:1:0,pwr_ext:2:23.4,rpm:1:0,sum_acc:1:0;6792\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:01\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная авторизация\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:00\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:00\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:07:00\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:50\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:50\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:46\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:31\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:16\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:06:01\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:05:46\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:05:31\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:05:16\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:05:01\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка: \\n#D#170924;090531;0000.000000;S;00000.000000;W;0;0;0;0;NA;NA;NA;1,1,1,1;NA;battery_lvl:1:41,flg:1:2,fuel1:1:2043,fuel1_state:1:2,fuel1_temp:1:21,fuel2:1:0,fuel2_state:1:0,fuel2_temp:1:0,fuel3:1:0,fuel3_state:1:0,fuel3_temp:1:0,fuel4:1:0,fuel4_state:1:0,fuel4_temp:1:0,global_number:1:5866364,ignition:1:0,mileage:1:0,pwr_ext:2:23.4,rpm:1:0,sum_acc:1:0;8247\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:04:46\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:04:31\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:04:16\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:04:01\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:46\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:38\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:37\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:37\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:37\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:36\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:36\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:36\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:35\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:35\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:35\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:34\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:34\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:33\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:33\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:33\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:33\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:32\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:32\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:32\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:32\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:31\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:31\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:31\",\n \"imei\": \"336023881\",\n \"is_error\": false,\n \"text\": \"Успешная отправка\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:29\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:29\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:29\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:29\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:28\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:27\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:27\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:27\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:27\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:26\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:26\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:25\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:25\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:25\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:25\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:24\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:23\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:23\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:23\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:23\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:22\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:22\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:22\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:22\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:21\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:21\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:21\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:19\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:19\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:19\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:18\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:17\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:17\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:17\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:17\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:17\",\n \"imei\": \"336023861\",\n \"is_error\": false,\n \"text\": \"Connecting to 212.154.238.102:20332\",\n \"server\": \"212.154.238.102\"\n },\n {\n \"datetime\": \"2024-09-17 14:03:16\",\n \"imei\": \"336023861\",\n \"is_error\": true,\n \"text\": \"Проблема авторизации: #AL#0\\r\\n\",\n \"server\": \"212.154.238.102\"\n }\n ],\n \"max_rows\": 4012\n}\n\nID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"a45189e1-5e72-4f88-a4a2-51a237d9e6ac"}],"id":"28ffbdf8-9de7-414f-ae9a-7ba44f43f93b","description":"API по работе с Ретрансляциями
\n","event":[{"listen":"prerequest","script":{"id":"f4bb6906-7875-44aa-8a23-65b7600184f8","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dfa3b49d-ff7d-45b2-849a-e31cef37bbb7","type":"text/javascript","exec":[""]}}],"_postman_id":"28ffbdf8-9de7-414f-ae9a-7ba44f43f93b"},{"name":"Ретрансляция исторических данных","item":[{"name":"/retranslator_histories","id":"535ebcac-e90a-4bc8-abe9-cf8a47c77f09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"imei\": \"324235243242354\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-14 11:41:55\",\n \"retrans_to\": \"2023-10-18 12:44:30\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/retranslator_histories","description":"Добавление ретрансляции исторических данных
\nПоля в JSON:
\nimei - IMEI объекта
\nterminal_type - ключ типа протокола объекта.
\nname - имя объекта.
\ncomment - комментарий.
\nretrans_from - период ретрансляции от в формате yyyy-MM-dd HH:mm:ss
\nretrans_to - период ретрансляции до.
\nРоль: Супервизор и выше.
\nПример запроса:
\nPOST https://dev5.skif.pro/api_v1/retranslator_histories
\n{\n \"imei\": \"324235243242354\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-12 11:41:55\",\n \"retrans_to\": \"2023-10-13 12:44:30\"\n}\n\nПример ответа:
\nЕсли запрос успешен, тогда возвращается соозданная запись, иначе ошибка.
\n{\n \"id\": \"435aa261-d06a-422b-b64c-1ee94b447c9e\",\n \"imei\": \"324235243242354\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"terminal_type\": \"navtelecom\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-12 11:41:55\",\n \"retrans_to\": \"2023-10-13 12:44:30\",\n \"status\": \"WAITING\"\n}\n\nПолучение списка ретрансляция исторических данных в админке
\nПоля в JSON:
\nimei - IMEI объекта
\nterminal_type - ключ типа протокола объекта.
\nname - имя объекта.
\ncomment - комментарий.
\nretrans_from - период ретрансляции от в формате yyyy-MM-dd HH:mm:ss
\nretrans_to - период ретрансляции до.
\nstatus - один из этих значений:
\n- WAITING - ожидается.
\n- RUNNING - в процессе.
\n- ERROR - ошибка.
\n- FINISHED - завершена.
\nРоль: Администратор и выше.
\nПример запроса:
\nPOST https://dev5.skif.pro/api_v1/admin_query
\n{\n \"model\": \"retranslator_histories\",\n \"from\": 0,\n \"count\": 100,\n \"value\": \"324235243242354\"\n}\n\nПример ответа:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"0a9f0be4-168a-49d5-91f4-dce4c96fb9cc\",\n \"imei\": \"324235243242354\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"terminal_type\": \"navtelecom\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-12 11:41:55\",\n \"retrans_to\": \"2023-10-13 12:44:30\",\n \"status\": \"WAITING\"\n },\n {\n \"id\": \"435aa261-d06a-422b-b64c-1ee94b447c9e\",\n \"imei\": \"324235243242354\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"terminal_type\": \"navtelecom\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-12 11:41:55\",\n \"retrans_to\": \"2023-10-13 12:44:30\",\n \"status\": \"RUNNING\"\n },\n {\n \"id\": \"2a425f39-e2e0-4abe-a1aa-a0a7fa3b79ef\",\n \"imei\": \"324235243242354\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"terminal_type\": \"navtelecom\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-14 11:41:55\",\n \"retrans_to\": \"2023-10-18 12:44:30\",\n \"status\": \"ERROR\",\n \"server_answer\": \"Сервер временно не доступен\"\n },\n {\n \"id\": \"2a425f39-e2e0-4abe-a1aa-a0a7fa3b79ef\",\n \"imei\": \"324235243242354\",\n \"name\": \"Ретранслятор 1234\",\n \"unit_name\": \"Man 922\",\n \"terminal_type\": \"navtelecom\",\n \"comment\": \"Комментария 456\",\n \"retrans_from\": \"2023-10-14 11:41:55\",\n \"retrans_to\": \"2023-10-18 12:44:30\",\n \"status\": \"FINISHED\",\n \"server_answer\": \"Период ретрансляции 2023-10-14 - 2023-10-18 / Ретранслированно 22000 из 332000\"\n }\n ]\n}\n\nРетрансляция исторических данных
\n","_postman_id":"e869448b-5304-4dea-892e-4f99ade8933b"},{"name":"Команды терминалов","item":[{"name":"/commands","id":"923e237c-4278-4f83-89f6-14b879d61e99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"100000000000008\",\n \"command\": \"*?V\"\n}"},"url":"{{base_url}}/api_v1/commands","description":"Добавление новой команды
\nПараметры:
\n\"company_id\": ID компании, обязательно для дилера. Для компании необязательно - получается активная компания.
\"imei\": Imei, текст, обязательно.
\"command\": Команда, обязательно для дилера, для компании нет.
\"template\": шаблон команды, обязательно для компании.
Роль: Оператор и выше.
\nПример запроса:
\n{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\"\n}\n\nВозвращается созданная запись
\nstatus - статус отправки команды. Возможные значения: WAITING - в ожидании, OK - отправлена, FAIL - не удалось отправить.
Пример ответа:
{\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n}\n\n{\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"100000000000008\",\n \"template\": {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\", // ID шаблонов команд\n \"params_values\": [ // значения параметров\n {\"key\": \"Номер выхода\", \"value\": \"2\"}\n ]\n }\n}\n\nОтвет:
\n{\n \"id\": \"cc584df9-791b-4074-af7e-6bc319be6173\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"100000000000008\",\n \"command\": \"*!2N\",\n \"status\": \"WAITING\",\n \"user_id\": \"6e8f4833-c430-4509-ac5e-e1802691655c\",\n \"template\": {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"name\": \"Выключения выходной линии\",\n \"params_values\": [\n {\n \"key\": \"Номер выхода\",\n \"value\": \"2\"\n }\n ]\n }\n}\n\nДобавить новую команду для нескольких терминалов
\nПараметры:
\n\"imeis\": Список Imei, текст массив.
\"command\": Команда, обязательно для дилера, для компании нет.
\"template\": Шаблон команды, обязательно для компании.
Роль: Оператор и выше.
\nПример запроса:
\n1) Создание команды дилером
\n{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imeis\": [\"100000000000008\", \"100000000000009\"],\n \"commnad\": \"*?V\"\n}\n\nВозвращается созданные записи
\nstatus - статус отправки команды. Возможные значения: WAITING - в ожидании, OK - отправлена, FAIL - не удалось отправить
Пример ответа:
[\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n },\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n }\n]\n\n2) Создание команды в компании
\n{\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imeis\": [\"100000000000008\", \"100000000000009\"],\n \"template\": {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"params_values\": [\n {\"key\": \"Номер выхода\", \"value\": \"2\"}\n ]\n }\n}\n\nОтвет:
\n[\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n },\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"100000000000008\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n }\n]\n\nПоиск команд по ID
\nВозвращает массив команд по ID.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная команда.
\nРоль: Оператор и выше.
\nПример запроса:
\n/commands?ids=8d174fc8-57c8-4a35-9347-0dba76c04957\n\nПример ответа:
\n{\n \"id\": \"8d174fc8-57c8-4a35-9347-0dba76c04957\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"359633107825189\",\n \"command\": \"command three\",\n \"status\": \"WAITING\"\n}\n\nОбновить данные команды
\nОбновляет переданные параметры
\nПараметры:
\nсм метод POST /commands
\nРоль: Оператор и выше.
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /commands?ids=:id
\n","urlObject":{"path":["api_v1","commands",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"176552ac-dca1-47d6-8c6d-b20b0fd63e8a"},{"name":"/commands/:id","id":"6d140ab2-6d8b-4c3c-9689-6fa24fc1506a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/commands/:id","description":"Удаление команды по ее id
\nУдаляет команду
\nПараметры:
\nid записи
\nРоль: Оператор и выше.
\nОтвет: 200
\nЕсли команда с таким id не найдена, то возвращается ошибка 422
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"6d140ab2-6d8b-4c3c-9689-6fa24fc1506a"},{"name":"/commands/list","id":"d4e05886-6a1e-422b-89df-fe6afab45e4d","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"100000000000008\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/commands/list","description":"Поиск команды по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - imei
Роль: Оператор и выше.
\nПример запроса:
\nПолучить первые 2 команды для imei
\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"862531041141236\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"9fa4bb38-c4da-4339-8c27-eac652363c63\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\", \n \"imei\": \"862531041141236\", \n \"command\": \"command xyz\", //Команда\n \"status\": \"SENT\", //Статус\n \"answer\": \"*@С\" // Ответ\n },\n {\n \"id\": \"72019dff-e056-4137-86f8-19e790d3067b\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531041141236\",\n \"command\": \"command abc\",\n \"status\": \"FAIL\"\n },\n {\n \"id\": \"1630c5b2-4e1d-447a-9102-97f6eb5ddf47\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531041141236\",\n \"command\": \"command abc\",\n \"status\": \"WAITING\"\n }\n ]\n}\n\nПоиск команды по фильтру в админке
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nsortField - поле сортировки, значения
[imei]
sortDesc - сортировка по убыванию, значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
значения для field - imei
Роль: Администратор и выше.
\nПример запроса:
\nПолучить первые 2 команды для imei
\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"862531041141236\"\n }\n ],\n \"model\": \"commands\"\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"9fa4bb38-c4da-4339-8c27-eac652363c63\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\", \n \"imei\": \"862531041141236\", \n \"command\": \"command xyz\", //Команда\n \"status\": \"SENT\", //Статус\n \"answer\": \"*@С\" // Ответ\n },\n {\n \"id\": \"72019dff-e056-4137-86f8-19e790d3067b\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531041141236\",\n \"command\": \"command abc\",\n \"status\": \"FAIL\"\n },\n {\n \"id\": \"1630c5b2-4e1d-447a-9102-97f6eb5ddf47\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531041141236\",\n \"command\": \"command abc\",\n \"status\": \"WAITING\"\n }\n ]\n}\n\nAPI по работе с команд терминалов
\n","event":[{"listen":"prerequest","script":{"id":"cd52c8b1-79d3-447a-aa47-a1dfe74f7a8f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"9399e3b1-7fa7-4310-baa0-b129787c5f4d","type":"text/javascript","exec":[""]}}],"_postman_id":"dd6c1b17-c8a4-47ad-9812-ba52ba84ede9"},{"name":"Шаблоны команд терминалов","item":[{"name":"/commands_templates","id":"aae56a15-70dc-4098-9da3-2b947decbb7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Команда произвольной звуковой индикации зуммером\",\n \"terminal_type\": \"navtelecom\",\n \"command_template\": \"*!BEEP {Кол-во импульсов в каждом такте},{Кол-во тактов в звуковой индикации},{Длительность каждого такта в 1/128 долях секунды.},{Частота звуковой индикации (Гц)}\"\n}"},"url":"{{base_url}}/api_v1/commands_templates","description":"Добавление нового шаблона команды
\nПараметры:
\"name\": Название шаблона команды.
\"terminal_type\": Тип терминала.
\"command_template\": Шаблон команды.
Роль: Супервизор и выше.
\nПример запроса:
\n{\n \"name\": \"Команда произвольной звуковой индикации зуммером\",\n \"terminal_type\": \"navtelecom\",\n \"command_template\": \"*!BEEP {Кол-во импульсов в каждом такте},{Кол-во тактов в звуковой индикации},{Длительность каждого такта в 1/128 долях секунды.},{Частота звуковой индикации (Гц)}\"\n}\n\nПример ответа:
\nВозвращается созданная запись
\n{\n \"id\": \"edfd0b85-b056-4726-9762-fa63dc61efd2\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Команда произвольной звуковой индикации зуммером\",\n \"command_template\": \"*!BEEP {Кол-во импульсов в каждом такте},{Кол-во тактов в звуковой индикации},{Длительность каждого такта в 1/128 долях секунды.},{Частота звуковой индикации (Гц)}\",\n \"params\": [\n \"Кол-во импульсов в каждом такте\",\n \"Кол-во тактов в звуковой индикации\",\n \"Длительность каждого такта в 1/128 долях секунды.\",\n \"Частота звуковой индикации (Гц)\"\n ]\n}\n\nПолучение шаблонов команд по ID
\nВозвращает шаблоны команд.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный шаблон команды.
\nРоль: Оператор и выше.
\nПример запроса:
\n/commands_templates?ids=edfd0b85-b056-4726-9762-fa63dc61efd2\n\nПример ответа:
\n{\n \"id\": \"edfd0b85-b056-4726-9762-fa63dc61efd2\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Команда произвольной звуковой индикации зуммером\",\n \"command_template\": \"*!BEEP {Кол-во импульсов в каждом такте},{Кол-во тактов в звуковой индикации},{Длительность каждого такта в 1/128 долях секунды.},{Частота звуковой индикации (Гц)}\",\n \"params\": [\n \"Кол-во импульсов в каждом такте\",\n \"Кол-во тактов в звуковой индикации\",\n \"Длительность каждого такта в 1/128 долях секунды.\",\n \"Частота звуковой индикации (Гц)\"\n ]\n}\n\nОбновить данные шаблона команды
\nПараметры:
\nid - ID шаблона команды
см метод POST /commands_templates
Роль: Супервизор и выше.
\nОтвет:
\nАналогичен GET /commands_templates?ids=:id
\n","urlObject":{"path":["api_v1","commands_templates",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID шаблона команды
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"2a21f466-db12-4424-99a7-c2ae06212f4c"},{"name":"/commands_templates/:id","id":"fa9acce5-51e7-4c86-94ed-7d74c4c62fae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/commands_templates/:id","description":"Удаление шаблона команды по его id
\nПараметры:
\nid записи
\nРоль: Супервизор и выше.
\nОтвет: 200
\nЕсли команда с таким id не найдена, то возвращается ошибка 422.
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID шаблона команды
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"fa9acce5-51e7-4c86-94ed-7d74c4c62fae"},{"name":"/commands_templates/list","id":"e7eec457-3099-4d8b-9b59-345c7d21363d","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"terminal_type\",\n \"value\": \"navtelecom\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/commands_templates/list","description":"Поиск шаблонов комманд по фильтру
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат.
\ncount - максимальное число элементов.
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
Возможные значения для field - terminal_type, name
Роль: Оператор и выше.
\nПримеры:
\n1) Получение всех шаблонов команд дилера
\n{}\n\nПример ответа:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"b6f555e8-4c69-4545-9639-44ef56bb1db5\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Включения выходной линии\",\n \"command_template\": \"*!{Номер выхода}Y\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Выключения выходной линии\",\n \"command_template\": \"*!{Номер выхода}N\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"b91c6a18-5965-46d4-acbe-e164d4dbf11a\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Запрос модели и версии устройства\",\n \"command_template\": \"*?V\",\n \"params\": []\n }\n ]\n}\n\n2) Получение первых 2 шаблонов команд для navtelecom.
\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"terminal_type\",\n \"value\": \"navtelecom\"\n }\n ]\n}\n\nОтвет:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"b6f555e8-4c69-4545-9639-44ef56bb1db5\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Включения выходной линии\",\n \"command_template\": \"*!{Номер выхода}Y\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Выключения выходной линии\",\n \"command_template\": \"*!{Номер выхода}N\",\n \"params\": [\n \"Номер выхода\"\n ]\n }\n ]\n}\n\nПоиск шаблонов команд по фильтру в админке
\nАналогично запросу POST /users/list
\nПараметры:
\nfrom - с какого найденного элемента выдавать результат
\ncount - максимальное число элементов
\nsortField - поле сортировки, значения
[imei]
sortDesc - сортировка по убыванию? значения \"true\", \"false\".
\nconditions - условие отбора в виде массива [ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} ].
Возможные значения для field - terminal_type, name
Роль: Администратор и выше.
\nПримеры:
\n1) Получение всех шаблонов команд дилера.
\n{\n \"model\": \"commands_templates\"\n}\n\nПример ответа:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"b6f555e8-4c69-4545-9639-44ef56bb1db5\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Включения выходной линии\",\n \"command_template\": \"*!{Номер выхода}Y\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Выключения выходной линии\",\n \"command_template\": \"*!{Номер выхода}N\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"b91c6a18-5965-46d4-acbe-e164d4dbf11a\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Запрос модели и версии устройства\",\n \"command_template\": \"*?V\",\n \"params\": []\n }\n ]\n}\n\n2) Получение первых 2 шаблонов команд для navtelecom.
\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"terminal_type\",\n \"value\": \"navtelecom\"\n }\n ],\n \"model\": \"commands_templates\"\n}\n\nОтвет:
\n{\n \"max\": 3,\n \"list\": [\n {\n \"id\": \"b6f555e8-4c69-4545-9639-44ef56bb1db5\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Включения выходной линии\",\n \"command_template\": \"*!{Номер выхода}Y\",\n \"params\": [\n \"Номер выхода\"\n ]\n },\n {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"terminal_type\": \"navtelecom\",\n \"name\": \"Выключения выходной линии\",\n \"command_template\": \"*!{Номер выхода}N\",\n \"params\": [\n \"Номер выхода\"\n ]\n }\n ]\n}\n\nAPI по работе с шаблонами команд терминалов
\n","event":[{"listen":"prerequest","script":{"id":"3abbea78-7af5-4c69-9814-00c6f22c0c0d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f5403b23-3c30-41b7-bfe9-a5246231c95b","type":"text/javascript","exec":[""]}}],"_postman_id":"4cc39c19-2454-48ea-8db7-da7d48827620"},{"name":"Интеграторы","item":[{"name":"/dealers","id":"e1b3b1c4-df27-41ba-bffe-308fb5d04c40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"type\": {\"key\": \"legal_entity\"}, \n \"name\": \"ООО \\\"Рога и Копыта\\\"\",\n \"email\": \"vegeho71508@epeva.com\",\n \"inn\": \"364322233444512\",\n \"phone\": \"+7898423456334\",\n \"password\": \"123456aa\",\n \"contact_person\": \"Иванов Иван Иванович\",\n \"address\": \"Лининский проспект, 116к1, Москва, 119415\",\n \"services\": \"Мониторинг транспорта\",\n \"tariff_description\": \"от 200 руб/мес за 1 объект\"\n}"},"url":"{{base_url}}/api_v1/dealers","description":"Создание нового дилера
\nПараметры:
\n\"type\": Тип организации: “Юридическое лицо” или “Индивидуальный предприниматель”. Справочник с типом 'dealer_types'\n\"name\": Название, строка, обязательно. С таким названием создается компания\n\"email\": Email, строка, обязательно\n\"inn\": ИНН, строка, обязательно\n\"phone\": Телефон контактного центра, строка, обязательно\n\"contact_person\": Контактное лицо, строка, обязательно\n\"is_default\": true, если интегратор по умолчанию, его нельзя удалить. Нельзя сделать дилера по умолчанию \n\"password\": Пароль \n\"sms_tariff\": Количество доступных SMS для уведоиления за месяц,\n\"address\": Адрес,\n\"services\": Услуги,\n\"tariff_description\": Описание тарифа\n\"telegram_bot_token\": Токен для телеграм бот\n\nПример запроса:
\n{\ntype': {'key': 'legal_entity'}\n\"name\": \"ООО Новый Скиф\",\n\"email\": \"newskif@skif.pro\",\n\"inn\": \"11122233\",\n\"phone\": \"+78981234567\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"address\": \"Ленинский проспект, 116к1, Москва, 119415\",\n\"services\": \"Мониторинг транспорта\",\n\"tariff_description\": \"от 200 руб/мес за 1 объект\",\n\"telegram_bot_token\": \"6734990111:RTF6Tik\"\n}\n\nПример ответа:
\nВозвращается созданная запись.
\n{\n\"id\": \"8ce34b65-49da-4bac-bbce-379da83e9638\",\n\"type\": {\"key\": \"legal_entity\", \"value\": \"Юридическое лицо\", \"type\": \"dealer_types\"}\n\"is_default\": false,\n\"name\": \"ООО \"Новый Скиф\"\",\n\"inn\": \"11122233444\",\n\"phone\": \"+78981234568\",\n\"email\": \"newskif@skif.pro\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"address\": \"Лининский проспект, 116к1, Москва, 119415\",\n\"services\": \"Мониторинг транспорта\",\n\"tariff_description\": \"от 200 руб/мес за 1 объект\",\n\"telegram_bot_token\": \"6734990111:RTF6Tik5\"\n}\n\nПриглашение к дилеру
\nПараметры:
\n'email' - приглашаемая электронная почта
\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n\"email\": \"abc@mail.com\"\n}\n\nВозвращается OK если такоq email не зарегистрован в системе и правильный email, иначе ошибка со статусом 422&
Ссылка в писmме на почту направляет на стрaницу /register?invite_id=&email=
Регистрация дилера
\nПараметры:
\n\"type\": Тип организации: “Юридическое лицо” или “Индивидуальный предприниматель”. Справочник с типом 'dealer_types'\n\"name\": Название компании, строка, обязательно. С таким названием создается компания.\n\"email\": Email, строка, обязательно\n\"inn\": ИНН, строка, обязательно\n\"phone\": Телефон контактного центра, строка, обязательно\n\"contact_person\": Контактное лицо, строка, обязательно\n\"is_default\": true, если интегратор по умолчанию, его нельзя удалить. Нелзя сделать интегратора по умолчанию \n\"password\": Пароль \n\"captcha\" - код с картинки получамой методом GET /captcha\n\nПример запроса:
\n{\n\"type\": {\"key\": \"legal_entity\"}\n\"name\": \"ООО Новый Скиф\",\n\"email\": \"skif@skif.pro\",\n\"inn\": \"11122233\",\n\"phone\": \"+78981234567\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"capcha\": \"atxgs\"\n}\n\nПример ответа:
Код 200 и пустой body в случае успеха.
Если уже есть аккаунт (см. /approve) с таким email возращается код 422 и body c ошибкой session.errors.emailAlreadyRegistered
В случае частого вызова метода, а именно чаще чем раз в 30 секунд возвращаем код 400 и body validation.errors.often_request
Поиск дилера по ID
\nВозвращает массив дилеров по ID.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный интергатор.
\nРоль: Супервизор и выше.
\nПример запроса:
\n/dealers?ids=8ce34b65-49da-4bac-bbce-379da83e9638\n\nПример ответа:
\n{\n \"id\": \"8ce34b65-49da-4bac-bbce-379da83e9638\",\n \"type\": {\n \"key\": \"legal_entity\",\n \"type\": \"dealer_types\",\n \"value\": \"Юридическое лицо\"\n },\n \"inn\": \"1231231233220\",\n \"phone\": \"+7899323236\",\n \"email\": \"email@skif.com\",\n \"contact_person\": \"Ivanov Ivan\",\n \"name\": \"СКИФ ЭПП\",\n \"server\": \"212.158.160.177\",\n \"sms_tariff\": 1000,\n \"address\": \"Лининский проспект, 116к1, Москва, 119415\",\n \"services\": \"Мониторинг транспорта\", \n \"tariff_description\": \"от 200 руб/мес за 1 объект\",\n \"billing\": {\n \"merchant\": \"111222333\",\n \"system\": \"MODULBANK\",\n \"key\": \"key123xyz\",\n \"default_unit_price\": 260,\n \"default_trial_length_days\": 10,\n \"default_period_length_days\": 30,\n \"qr_unit_price\": 270,\n \"qr_trial_length_days\": 20,\n \"qr_period_length_days\": 40,\n \"public_offer_path\": \"/files/dealer_offer/1933792985_8ce34b65-49da-4bac-bbce-379da83e9638.pdf\"\n },\n \"is_default\": false,\n \"telegram_bot_token\": \"6734990111:RTF6Tik5\"\n}\n\nПолучение общедоступной информации дилера по ИНН
\nВозвращает объект дилера по ИНН.
\nЕсли такой дилер не найден, то приходит ошибка с кодом 422, а в теле ответа:
\n{\"code\":4220,\"field\":\"\",\"message\":\"Не найден такой дилер\"}\n\nПример запроса:
\nGET /api_v1/dealer/364322233444512\n\nПример ответа:
\n{\n \"name\": \"ООО \\\"Рога и Копыта\\\"\", //Имя\n \"type\": { //Тип организации,key=legal_entity для Юридическое лицо, key=individual_entrepreneur для \n Индивидуальный предприниматель \n \"key\": \"legal_entity\",\n \"type\": \"dealer_types\",\n \"value\": \"Юридическое лицо\"\n },\n \"inn\": \"364322233444512\", // ИНН\n \"address\": \"Ленинский проспект, 116к1, Москва, 119415\",//Адрес\n \"services\": \"Мониторинг транспорта\",//Услуги\n \"tariff_description\": \"от 200 руб/мес за 1 объект\",// Описание тарифа\n \"contact_person\": \"Иванов Иван Иванович\",//Контактное лицо\n \"email\": \"vegeho71508@epeva.com\",//Email\n \"phone\": \"7898423456334\",//Телефон\n \"system\": { //Система оплаты, key=MODULBANK для модульбанка, key=PAYBOX для paybox \n \"key\": \"MODULBANK\",\n \"type\": \"payment_types\",\n \"value\": \"Модульбанк\"\n },\n \"public_offer_link\": \"https://dev5.skif.pro/api_v1//files/dealer_offer/1397418377_526c18df-d7d2-4de5-b50a-263515a374e2.pdf\" // Ссылка для загрузки оферту \n}\n\nОбновить данные дилера
\nРоль: Редактор тарифа и выше.
\nПараметры:
\n{\n \"id\": \"8ce34b65-49da-4bac-bbce-379da83e9638\", //ID дилера\n \"type\": { // Тип организации\n \"key\": \"legal_entity\",\n \"type\": \"dealer_types\",\n \"value\": \"Юридическое лицо\"\n },\n \"inn\": \"1231231233220\", //ИНН\n \"phone\": \"+7899323236\", // Номер телефона\n \"email\": \"email@skif.com\", // Email\n \"contact_person\": \"Ivanov Ivan\", //Контактное лицо\n \"name\": \"СКИФ ЭПП\",//Название компании\n \"server\": \"212.158.160.177\",//Сервер для отправки данных терминала\n \"sms_tariff\": 1000, //SMS тариф\n \"address\": \"Лининский проспект, 116к1, Москва, 119415\",//Адрес\n \"services\": \"Мониторинг транспорта\", // Услуги\n \"tariff_description\": \"от 200 руб/мес за 1 объект\", //Описание тарифа\n \"billing\": { //Биллинг\n \"system\": \"MODULBANK\", //Платежная система, обязательное, получается из справочника type = payment_types\n \"merchant\": \"111222333\",// Идентификатор магазина, обязательное\n \"key\": \"key123xyz\",//Секретный ключ, обязательное\n \"default_unit_price\": 260, Стоимость одного объекта по умолчанию, обязательное\n \"default_trial_length_days\": 10, Пробный период (дней) по умолчанию, обязательное\n \"default_period_length_days\": 30, Период оплаты (дней) по умолчанию, обязательное\n \"qr_unit_price\": 270, Стоимость одного объекта по qr, необязательное\n \"qr_trial_length_days\": 20,Пробный период (дней) по qr, необязательное\n \"qr_period_length_days\": 40, Период оплаты (дней) по qr, необязательное\n \"public_offer_path\": \"/files/dealer_offer/1933792985_8ce34b65-49da-4bac-bbce-379da83e9638.pdf\" //Публичная оферта (Прикрепленный файл и подсказка - это соглашение об использовании мобильного приложения будет отображаться вашим пользователям), необязательное\n },\n \"is_default\": false,\n \"telegram_bot_token\": \"6734990111:RTF6Tik\"\n}\n\nсм метод POST /dealers
\nОтвет:
\nАналогичен одному объекту из возврата метода GET /dealers?ids=:id
\n","urlObject":{"path":["api_v1","dealers",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID интегратора
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"4b9584c4-8f57-4b15-83a4-320d52930ca4"},{"name":"/dealers/:id/block_unblock","id":"b290d571-0105-4b29-9bd9-a996ad1fca69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"block\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/dealers/:id/block_unblock","description":"Блокировка / разблокировка интегратора
\nБлокирует / разблокирует интегратора.
\nПараметры:
\nid - ID интегратора
\nВ теле запроса отправить \"block\": true для блокировки, \"block\": false для разблокировки
\n{\n \"block\": true\n}\n\nID интегратора
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"b290d571-0105-4b29-9bd9-a996ad1fca69"},{"name":"/dealers/:id","id":"87ee1cb5-172b-471b-964a-ea2c19c26a61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/dealers/:id","description":"Удаление дилера по его id
\nУдаляет дилера
\nПараметры:
\nid записи
\nОтвет: 200
\nЕсли дилер с таким id не найден возвращается ошибка 422.
\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\nID интегратора
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"87ee1cb5-172b-471b-964a-ea2c19c26a61"},{"name":"/dealers_admin_query","id":"9a6a247f-62fe-4247-b71a-42a3a02d9267","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"connection":true}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"value\": \"Новая Скиф\",\n \"from\": 0,\n \"count\": 100\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/dealers_admin_query","description":"Поиск интеграторов в админке
\nПоиск выполняется по полей name, email, phone
\nРоль: Администратор и выше.
\nПример запроса:
\nНайти по названию \"Новый Скиф\"
\n{\n \"value\": \"Новый Скиф\",\n \"from\": 0,\n \"count\": 100\n}\n\nОтвет:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"2cbd9d97-329d-4631-9161-b11556561b77\",\n \"is_default\": false,\n \"name\": \"ООО Новый Скиф\",\n \"inn\": \"11122233\",\n \"phone\": \"+78981234567\",\n \"email\": \"skif@skif.pro\",\n \"contact_person\": \"Иванов Иван Иванович\",\n \"regions\": [],\n \"_default\": false\n },\n {\n \"id\": \"8ce34b65-49da-4bac-bbce-379da83e9638\",\n \"is_default\": false,\n \"name\": \"ООО \\\"Новый Скиф2\\\"\",\n \"inn\": \"11122233444\",\n \"phone\": \"+78981234568\",\n \"email\": \"newskif@skif.pro\",\n \"contact_person\": \"Иванов Иван Иванович\",\n \"regions\": [\n \"Узбекистан\",\n \"Туркменистан\"\n ],\n \"_default\": false\n }\n ]\n}\n\ndealer_key:
\nlegal_entity
\nindividual_entrepreneur
\n","urlObject":{"path":["api_v1","dealers","send_email","static"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d00c23a-88b8-4411-b950-a6cc55d74c4d"}],"id":"4353f434-b660-42b3-9319-8115aeed709c","description":"API по работе с Интеграторами
\n","event":[{"listen":"prerequest","script":{"id":"d0c52b86-0711-41f2-9fd9-95e389d79953","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"eccce03b-25b8-4f22-917e-f65e1ce1f797","type":"text/javascript","exec":[""]}}],"_postman_id":"4353f434-b660-42b3-9319-8115aeed709c"},{"name":"Коробочное решение","item":[{"name":"/boxes/create_code","id":"19c94d7c-98d1-4f96-a00e-050df0917b05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"units\": [\n {\"id\": \"c031563b-31df-43ab-b60d-7c79cd4ae500\"}\n ]\n}"},"url":"{{base_url}}/api_v1/boxes/create_code","description":"Создание нового кода для коробочного решения
\nПараметры:
\nunits: список объектов (пока обрабатывается только один объект)
\nРоль: Супервизор и выше.
\nПример запроса:
\n{\n \"units\": [\n {\"id\": \"c031563b-31df-43ab-b60d-7c79cd4ae500\"}\n ]\n}\n\nПример ответа:
\nВозвращается созданная запись
\n{\n \"id\": \"e5020ef9-1d9f-4e80-a189-d54b5a6535a8\",\n \"dealer_id\": \"b0de9e77-3ae1-4a1d-b246-6ba1bccf0052\",\n \"unit_id\": \"c031563b-31df-43ab-b60d-7c79cd4ae500\",\n \"code\": \"A6P29V\",\n \"link\": \"https://app.skif.page.link/?link=https://dev.skif.pro/boxes?code=A6P29V&apn=ru.skifapp.skif&amv=27&afl=https://dev.skif.pro/c\",\n \"used\": false\n}\n\nИмеет значение code - Шестизначный код и link - cсылка для QR кода.
Если уже был создан код для данного объекта тогда возвращается созданная запись.
Создание объекта по коду из коробочного решения
\nПараметры:
\nПример запроса:
\n{\n \"new_user\": true, \n \"code\": \"A6P29V\", // код\n \"userProviderId\": \"gurkacarti@vusra.com\", // email\n \"type\": \"EMAIL\", \n \"company_name\": \"Company123\", // название компании\n \"name\": \"Саша\", // Имя пользователя\n \"phone\": \"+7(894)455-32-43\", // телефон\n \"password\": \"12345abc\", //пароль\n \"timezone\": {\n \"key\": \"UTC+3\"// получить список от GET /properties type=timezones\n }, // таймзона компании\n \"unit_name\": \"Bersendz benz Bus 455\", // Имя объекта\n \"unit_type\": {\"key\": \"bus\"} // Тип объекта, получить список от GET /properties type=unit_type\n}\n\nСоздается новая компания, пользователь с указанном email, паролем и объектом. Возвращает новую сессию со статусом OK, если всё ok, иначе ошибка со статусом 422.
\n{\n \"new_user\": false,\n \"code\": \"ARKMV1\",\n \"company\": {\n \"id\": \"9b18ce93-c4eb-4479-a978-36c640c54f31\"\n },\n \"unit_name\": \"Bersendz benz Bus 455\",\n \"unit_type\": {\"key\": \"bus\"}\n}\n\nРоль: Читатель и выше.
\n","urlObject":{"path":["api_v1","boxes","create_unit"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"19bc4431-432e-4099-a0b6-3c3fdaf8aacc"},{"name":"/boxes/:id","id":"0ab08474-46ed-46e4-a022-baf001f51eb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"message\": \"abcXYZ\"\n}"},"url":"{{base_url}}/api_v1/boxes/:id","description":"Обновление данных кода по ID
\nРоль: Супервизор и выше.
\nПараметры:
message - информационный текст
{\n \"message\": \"some message\"\n}\n\nВозвращает обновленную запись
\n","urlObject":{"path":["api_v1","boxes",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"0ab08474-46ed-46e4-a022-baf001f51eb7"},{"name":"/boxes?code=","id":"8620f3aa-c589-4869-b930-f7bc0c1203a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":""},"url":"{{base_url}}/api_v1/boxes?code=AT1FPU","description":"Получение информации о коде
\n
\nПараметры:
code - шестизначный код в коробке
\n
\nРоль: Читатель и выше.
\n
\nОтвет:
used - true если уже использовался
\n{\n \"id\": \"483f0de0-b8d1-4822-b672-d7d35c659373\",\n \"dealer_id\": \"dd11e469-f929-4087-96b2-3911335015c1\",\n \"unit_id\": \"4bb05676-1d99-4552-a037-1288c3e60b83\",\n \"code\": \"AT1FPU\",\n \"link\": \"https://appskif.page.link/?link=https://dev.skif.pro/c?code=AT1FPU&apn=ru.skifapp.skif&amv=27&ibi=com.skifApp.SKIF2&isi=1540602214&imv=1.4.6&efr=1\",\n \"used\": true\n}\n\n
","urlObject":{"path":["api_v1","boxes"],"host":["{{base_url}}"],"query":[{"key":"code","value":"AT1FPU"}],"variable":[]}},"response":[],"_postman_id":"8620f3aa-c589-4869-b930-f7bc0c1203a8"}],"id":"12617d46-663b-4ab9-a757-e5dce05eebcf","description":"API по работе с коробочным решением
\n","event":[{"listen":"prerequest","script":{"id":"b6ae4c20-7d9b-4c15-a4d4-3aa2ebe38d09","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"85a3ba9c-6c19-4553-aac7-b6d5f5d3361c","type":"text/javascript","exec":[""]}}],"_postman_id":"12617d46-663b-4ab9-a757-e5dce05eebcf"},{"name":"Эмулятор трека","item":[{"name":"/emulators/start","id":"8a5cf57f-92e5-4701-be80-5d1675b7d7a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/emulators/start?terminal_type=egts&imei=862273040897712&fake_imei=33344455566777&from=2023-09-30 21:00:00&to=2023-10-00 16:41:55","description":"Начать эмуляцию
\n
\nПараметры:
\nterminal_type - ключ типа терминала, протокол реального и фейкого объекта должен быть таким же.
\nimei - реальный imei, с которого нужно начинать эмуляцию.
fake_imei - imei созданного объекта для теста.
date_from - Дата и время начала, в формате yyy-MM-dd HH:mm:ss в UTC
date_to - Дата и время окончания, в формате yyy-MM-dd HH:mm:ss в UTC
\n
\nПример запроса:
GET https://dev.skif.pro/api_v1/emulators/start?imei=862273041373150&fake_imei=33344455566777&from=2021-11-11 10:10:00&to=2021-11-11 10:15:00
\n","urlObject":{"path":["api_v1","emulators","start"],"host":["{{base_url}}"],"query":[{"key":"terminal_type","value":"egts"},{"key":"imei","value":"862273040897712"},{"key":"fake_imei","value":"33344455566777"},{"key":"from","value":"2023-09-30 21:00:00"},{"key":"to","value":"2023-10-00 16:41:55"}],"variable":[]}},"response":[],"_postman_id":"8a5cf57f-92e5-4701-be80-5d1675b7d7a7"},{"name":"/emulators/stop","id":"b84e16f7-bd86-4edd-9d1d-35ed380ac7b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/emulators/stop?fake_imei=33344455566777","description":"Остановить эмуляцию
\n
\nНапример:
GET https://dev.skif.pro/api_v1/emulators/stop?fake_imei=33344455566777
\n","urlObject":{"path":["api_v1","emulators","stop"],"host":["{{base_url}}"],"query":[{"key":"fake_imei","value":"33344455566777"}],"variable":[]}},"response":[],"_postman_id":"b84e16f7-bd86-4edd-9d1d-35ed380ac7b5"},{"name":"/emulators/show","id":"52072e4b-5dcb-4ac0-9810-a9615042729f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/emulators/show","description":"Получение списка фейковых imei для которых запущен эмулятор
\n","urlObject":{"path":["api_v1","emulators","show"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"52072e4b-5dcb-4ac0-9810-a9615042729f"}],"id":"f4edca35-9895-45b9-957f-37939fe8dbd0","_postman_id":"f4edca35-9895-45b9-957f-37939fe8dbd0","description":""},{"name":"Интеграция с ЕФИС","item":[{"name":"/efis/units","id":"b0a81646-5e3b-4bdd-9053-42d368e0bf09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/efis/units","description":"Получение всех объектов
\n
\nВозвращает массив - список объектов в компании. Какдые строки имеют следующие поля:
\n[\n {\n\"id\": <uint>, //ID объекта\n\"nm\": <text>, //название\n\"pos\": { // Последняя информация о местоположение\n “t”:<unit>, //UTC время в секундах\n”y”:<double>,//широта\n”x”:<double>, //долгота\n”s”:<int>, //скорость \n”c”:<int> ,// курс \n”sc”: <int>// количество спутников\n},\n\"tempsens\": [ // Информация о показаниях датчиков температуры\n {\n \"id”:<bigint>, //ID датчика\n \"n\":<text>, //название датчика\n \"p\":<text>, //первый параметр датчика\n \"v\":<double> //значение датчика\n },\n …\n]\n }\n] \n\n
\n
\nРоль: Читатель и выше.
\n
\nПример:
\n[\n {\n \"id\": 1777673690,\n \"nm\": \"Маршрутка\",\n \"pos\": {\n \"t\": 1645709415,\n \"y\": 53.141914,\n \"x\": 63.581444,\n \"s\": 0.0,\n \"c\": 120.0,\n \"sc\": 18.0\n },\n \"tempsens\": [\n {\n \"id\": 5406794727589329475,\n \"n\": \"Temp sensor\",\n \"p\": \"temp_d_1\",\n \"v\": 13.6\n }\n ]\n },\n …\n]\n\n
","urlObject":{"path":["api_v1","efis","units"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b0a81646-5e3b-4bdd-9053-42d368e0bf09"},{"name":"/efis/units/:id/messages/:time_from/:time_to?index_from=&index_to=","id":"22a75c8c-0e99-4f6a-a403-9bdbd6d464e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/efis/units/:id/messages/:time_from/:time_to?index_from=&index_to","description":"Получение сообщений для одного объекта
\n
\nПараметры:
\n {id}: <uint> ID объекта \n {time_from}: <uint> начало интервала (время UTC, Unix timestamp в секундах)\n {time_to}: <uint> окончание интервала (время UTC, Unix timestamp в секундах)\n {index_from}: <uint> индекс первого сообщения, которое будет получено, индексы начинается с нуля\n {index_to}: <uint> индекс последного сообщения, которое будет получено, index_to не принадлежит интервалу, т.е сообщении в позициях [index_from, index_to). index_to-index_from не может быть больше 1000\n\n
\nРоль: Читатель и выше.
\n
\nВозвращает массив - список сообщений.
Какдые строки имеют следующие поля:
\n[\n {\n “t”: <uint>, //время UTC в сукундах\n “index”:<uint>, //индекс сообщении, индексы начиначется с нуля\n “pos”: {} // // информация о позиции в этом сообщении, см. GET /api_v1/units\n \"p\": { // значения параметров, отображается только не нулевые значения \n “key”: value\n },\n \"tempsens\": [ // Значения температурных датчиков, см. GET /api_v1/units\n ….\n ]\n }\n …\n]\n\n
Пример:
Запрос:
/api_v1/efis/units/1777673690/messages/1645448226/1645534626?index_from=0&index_to=1000
\nОтвет:
\n[{\n \"t\": 1645448228,\n \"index\": 0,\n \"pos\": {\n \"y\": 53.214832,\n \"x\": 63.637047,\n \"z\": 0,\n \"s\": 0,\n \"c\": 221,\n \"sc\": 15\n },\n \"p\": {\n \"navi_sensor_st_rec\": 1.0,\n \"hours_t37\": 15.0,\n \"gsm_level\": 31.0,\n \"navi_sensor_st_valid\": 1.0,\n \"voltage_main\": 28361.0,\n \"virt_acc_wakeup\": 1.0,\n \"vol_a_in_1\": 34.0,\n \"latitude\": 53.214832,\n \"entry_num\": 1078507.0,\n \"angle\": 221.0,\n \"dut_485_1\": 592.0,\n \"event_id\": 4545.0,\n \"virt_acc_sh3\": 1.0,\n \"communication_st\": 1.0,\n \"longitude\": 63.637047,\n \"satellites\": 15.0,\n \"mileage_cur\": 33964.230469,\n \"altitude\": 1665.0,\n \"voltage_res\": 4127.0,\n \"dut_temp_485_1\": 5.0\n },\n \"tempsens\": [{\n \"id\": 5406794727589329475,\n \"n\": \"Temp sensor\",\n \"p\": \"temp_d_1\",\n \"v\": 13.4\n }]\n },\n {\n \"t\": 1645448229,\n \"index\": 1,\n \"pos\": {\n \"y\": 53.214825,\n \"x\": 63.637035,\n \"z\": 0,\n \"s\": 5,\n \"c\": 221,\n \"sc\": 15\n },\n \"p\": {\n \"speedkph\": 5.0,\n \"navi_sensor_st_rec\": 1.0,\n \"hours_t37\": 15.0,\n \"gsm_level\": 31.0,\n \"navi_sensor_st_valid\": 1.0,\n \"voltage_main\": 28362.0,\n \"virt_acc_wakeup\": 1.0,\n \"vol_a_in_1\": 34.0,\n \"latitude\": 53.214825,\n \"entry_num\": 1078508.0,\n \"angle\": 221.0,\n \"dut_485_1\": 592.0,\n \"event_id\": 5897.0,\n \"virt_acc_sh3\": 1.0,\n \"communication_st\": 1.0,\n \"longitude\": 63.637035,\n \"satellites\": 15.0,\n \"mileage_cur\": 33964.234375,\n \"altitude\": 1668.0,\n \"voltage_res\": 4127.0,\n \"dut_temp_485_1\": 5.0\n },\n \"tempsens\": [{\n \"id\": 5406794727589329475,\n \"n\": \"Temp sensor\",\n \"p\": \"temp_d_1\",\n \"v\": 14.5\n }]\n }\n…\n]\n\n
","urlObject":{"path":["api_v1","efis","units",":id","messages",":time_from",":time_to"],"host":["{{base_url}}"],"query":[{"description":{"content":"Индекс первого сообщения, которое будет получено
\n","type":"text/plain"},"key":"index_from","value":""},{"description":{"content":"Индекс последного сообщения, которое будет получено
\n","type":"text/plain"},"key":"index_to","value":""}],"variable":[{"description":{"content":"ID объекта
\n","type":"text/plain"},"type":"any","value":"","key":"id"},{"description":{"content":"Начало интервала (время UTC, Unix timestamp в секундах
\n","type":"text/plain"},"type":"any","value":"","key":"time_from"},{"description":{"content":"Окончание интервала (время UTC, Unix timestamp в секундах)
\n","type":"text/plain"},"type":"any","value":"","key":"time_to"}]}},"response":[],"_postman_id":"22a75c8c-0e99-4f6a-a403-9bdbd6d464e7"},{"name":"/efis/units/messages/:time_from/:time_to?index_from=&index_to=","id":"c8f134de-83b0-4e85-b8d7-9d5c49aa3f8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/efis/units/messages/:time_from/:time_to?index_from=&index_to=","description":"Получение сообщений для всех объектов
\n
\nПараметры:
\n {time_from}: <uint> начало интервала (время UTC, Unix timestamp в секундах)\n {time_to}: <uint> окончание интервала (время UTC, Unix timestamp в секундах)\n {index_from}: <uint> индекс первого сообщения, которое будет получено, индексы начинается с нуля\n {index_to}: <uint> индекс последного сообщения, которое будет получено, index_to не принадлежит интервалу, т.е сообщении в позициях [index_from, index_to). index_to-index_from не может быть больше 1000\n\n
\nРоль: Читатель и выше.
\n
\nВозвращает массив - список сообщений.
Какдые строки имеют следующие поля:
\n[\n {\n “t”: <uint>, //время UTC в секундах\n “index”:<uint>, //индекс сообщения, индексы начиначется с нуля\n “id”:<uint>, //ID объекта\n “pos”: {} // // информация о позиции в этом сообщении, см. GET /api_v1/units\n \"p\": { // значения параметров, отображается только не нулевые значения \n “key”: value\n },\n \"tempsens\": [ // Значения температурных датчиков, см. GET /api_v1/units\n ….\n ]\n }\n …\n]\n\n
Сообщения сортируются по объектам, для объекты по времени
\n
\nПример:
Запрос:
/api_v1/efis/units/messages/1645448226/1645534626?index_from=2&index_to=4
\nОтвет:
\n[\n {\n \"index\": 2,\n \"id\": 906772659,\n \"t\": 1645500784,\n \"tp\": \"ud\",\n \"pos\": {\n \"y\": 58.205078125,\n \"x\": 54.68750762939453,\n \"z\": 0,\n \"s\": 32,\n \"c\": 117,\n \"sc\": 9\n },\n \"tempsens\": [],\n \"p\": {\n \"altitude\": 126,\n \"speedkph\": 32,\n \"pwr_int\": 36,\n \"latitude\": 58.205078125,\n \"pwr_ext\": 142,\n \"angle\": 117,\n \"longitude\": 54.68750762939453,\n \"satellites\": 9,\n \"hdop\": 112,\n \"is_valid\": 1,\n \"input_2\": 8,\n \"input_4\": 19\n }\n },\n {\n \"index\": 3,\n \"id\": 906772659,\n \"t\": 1645500787,\n \"tp\": \"ud\",\n \"pos\": {\n \"y\": 58.204891204833984,\n \"x\": 54.688175201416016,\n \"z\": 0,\n \"s\": 26,\n \"c\": 119,\n \"sc\": 9\n },\n \"tempsens\": [],\n \"p\": {\n \"altitude\": 126,\n \"speedkph\": 26,\n \"pwr_int\": 36,\n \"latitude\": 58.204891204833984,\n \"pwr_ext\": 141,\n \"angle\": 119,\n \"longitude\": 54.688175201416016,\n \"satellites\": 9,\n \"hdop\": 112,\n \"is_valid\": 1,\n \"input_4\": 19\n }\n }\n]\n\n
","urlObject":{"path":["api_v1","efis","units","messages",":time_from",":time_to"],"host":["{{base_url}}"],"query":[{"description":{"content":"Индекс первого сообщения, которое будет получено
\n","type":"text/plain"},"key":"index_from","value":""},{"description":{"content":"Индекс последного сообщения, которое будет получено
\n","type":"text/plain"},"key":"index_to","value":""}],"variable":[{"description":{"content":"Начало интервала (время UTC, Unix timestamp в секундах)
\n","type":"text/plain"},"type":"any","value":"","key":"time_from"},{"description":{"content":"Окончание интервала (время UTC, Unix timestamp в секундах)
\n","type":"text/plain"},"type":"any","value":"","key":"time_to"}]}},"response":[],"_postman_id":"c8f134de-83b0-4e85-b8d7-9d5c49aa3f8b"}],"id":"2cd99586-4551-48af-9464-84794b972f97","_postman_id":"2cd99586-4551-48af-9464-84794b972f97","description":""},{"name":"Отзывы","item":[{"name":"/feedback","id":"81e445f1-f3ff-4e64-bc5b-09af26b90e7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rating\": 5,\n \"type\": {\"key\": \"proposal\"},\n \"message\": \"Все супер!!!\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/feedback","description":"Создание нового отзыва
\n
\nПоля запроса JSON:
rating - число от 1 до 5, обязательное
message - текст отзыва, обязательное
type - тип отзыва, выбрать из GET /properties где type=feedback_type, обязательное
\nПример запроса:
\n{\n \"rating\": 5,\n \"type\": {\"key\": \"proposal\"},\n \"message\": \"Все супер!!!\"\n}\n\n
\nПример ответа:
\n{\n \"id\": \"78516162-cf8a-4056-bdaa-73ca6311a1d5\",\n \"company\": {\n \"id\": \"1792239f-47eb-42b3-aef7-c49a3cc6988e\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"user\": {\n \"id\": \"6e8f4833-c430-4509-ac5e-e1802691655c\",\n \"name\": \"azat\",\n \"email\": \"yusupovazat@gmail.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n}\n\n
","urlObject":{"path":["api_v1","feedback"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"81e445f1-f3ff-4e64-bc5b-09af26b90e7e"},{"name":"/feedback/:id","id":"5120c169-4f26-4db0-9766-3ef1a15b38d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"rating\": 5,\n \"type\": {\"key\": \"proposal\"},\n \"message\": \"Все супер!!!\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/feedback/:id","description":"Удаление отзыва по ID
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса
\nhttps://dev.skif.pro/api_v1/feedback/03d5be4f-4adb-4bd7-99b2-ab0edaaa414a\n\n
","urlObject":{"path":["api_v1","feedback",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID отзыва
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"5120c169-4f26-4db0-9766-3ef1a15b38d7"},{"name":"/feedback?ids=ids","id":"6d0eec01-b6c3-461b-a9ca-3a8dd53382b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/feedback?ids=","description":"Поиск отзыва по ID
\n
\nВозвращает массив отзывов по ID.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный отзыв.
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nGET /feedback?ids=78516162-cf8a-4056-bdaa-73ca6311a1d5
\nПример ответа:
\n{\n \"id\": \"78516162-cf8a-4056-bdaa-73ca6311a1d5\",\n \"company\": {\n \"id\": \"1792239f-47eb-42b3-aef7-c49a3cc6988e\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"user\": {\n \"id\": \"6e8f4833-c430-4509-ac5e-e1802691655c\",\n \"name\": \"azat\",\n \"email\": \"yusupovazat@gmail.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n}\n\n
","urlObject":{"path":["api_v1","feedback"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"6d0eec01-b6c3-461b-a9ca-3a8dd53382b0"},{"name":"/feedback_admin_query","id":"67e681d1-1a2f-4b1e-a4ab-2ea6cadc3eb5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"value\": 5\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/feedback_admin_query","description":"Быстрый поиск отзывов в админ панеле
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"from\": 0,\n \"count\": 10,\n \"value\": 5\n}\n\n
\nПример ответа:
\n{\n \"max\": 1,\n \"list\": [\n {\n \"id\": \"78516162-cf8a-4056-bdaa-73ca6311a1d5\",\n \"company\": {\n \"id\": \"1792239f-47eb-42b3-aef7-c49a3cc6988e\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"user\": {\n \"id\": \"6e8f4833-c430-4509-ac5e-e1802691655c\",\n \"name\": \"azat\",\n \"email\": \"yusupovazat@gmail.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","feedback_admin_query"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"67e681d1-1a2f-4b1e-a4ab-2ea6cadc3eb5"},{"name":"/feedback/list","id":"80ba70e0-1cc6-4472-9801-bf8bb0ba2ec1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\"field\": \"type.key\", \"value\": \"proposal\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/feedback/list","description":"Поиск отзывов
\n
\nfrom - начальный индекс.
count - количество записей.
conditions - условия.
field - название поля, возможные значения: rating, type.key.
value - значение.
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\n{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\"field\": \"rating\", \"value\": \"5\"}\n ]\n}\n\n
\nПример ответа:
\n{\n \"max\": 1,\n \"list\": [\n {\n \"id\": \"78516162-cf8a-4056-bdaa-73ca6311a1d5\",\n \"company\": {\n \"id\": \"1792239f-47eb-42b3-aef7-c49a3cc6988e\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"user\": {\n \"id\": \"6e8f4833-c430-4509-ac5e-e1802691655c\",\n \"name\": \"azat\",\n \"email\": \"yusupovazat@gmail.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","feedback","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"80ba70e0-1cc6-4472-9801-bf8bb0ba2ec1"}],"id":"4a281ac4-6dd7-401e-a6d3-023ca7cef7bf","_postman_id":"4a281ac4-6dd7-401e-a6d3-023ca7cef7bf","description":""},{"name":"Ссылки доступа (Локатор)","item":[{"name":"/locators","id":"d944e551-91af-4f9c-bb14-c9d9a128a6c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Имя\",\n \"units\": [{\"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"}],\n \"date_from\": \"2022-10-28 00:00:00\",\n \"date_to\": \"2022-10-29 00:00:00\",\n \"description\": \"Сопроводительное письмо\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/locators","description":"Cоздание ссылки для объекта, по которой пользователь без доступа к SKIF.PRO может следить за объектом на карте
\n
\nСсылка на объект формируется следующим образом: {{base_url}}/locator?id=:locator_id
\n
\nПоля запроса JSON:
\nname - Название
units - объекты или units_groups - группы объектов
date_from - время начала
date_to - время окончания
description - Сопроводительное письмо
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"name\": \"Имя\",\n \"units\": [\n {\"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"}, \n {\"id\": \"3fb49648-49d9-4ab7-9ec9-1577dc6164d4\"}\n ],\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"description\": \"Some text\"\n}\n\n
\nПример ответа:
\nstatus - определяется автоматически: запланировано, запущено или завершено
active - true, если отключено
\n{\n \"id\": \"7b58f5a0-947d-446f-ad77-3cfd4a68a956\",\n \"name\": \"Имя\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"units\": [{\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\",\n \"name\": \"Маршрутка\"\n },{\n \"id\": \"3fb49648-49d9-4ab7-9ec9-1577dc6164d4\",\n \"name\": \"Бензовоз\"\n }\n ],\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"description\": \"Some text\",\n \"status\": {\n \"key\": \"locator_running\",\n \"type\": \"locator_type\",\n \"value\": \"Запущено\"\n },\n \"is_active\": true\n}\n\n
Для группы объектов:
\n{\n \"name\": \"Имя\",\n \"units_groups\": [{\n \"id\": \"a707cc43-c585-4022-8584-f1b0881e7d71\"\n },{\n \"id\": \"3dee5ff9-808f-4536-bec3-9e146bca9327\"\n }\n ],\n \"date_from\": \"2025-01-08 00:00:00\",\n \"date_to\": \"2025-10-29 00:00:00\",\n \"description\": \"Сопроводительное письмо\"\n}\n\n
","urlObject":{"path":["api_v1","locators"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d944e551-91af-4f9c-bb14-c9d9a128a6c1"},{"name":"/locators For Group","id":"fec45468-0557-4396-855d-d1b50fb9d3b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"units_group\": {\"id\": \"a707cc43-c585-4022-8584-f1b0881e7d71\"},\n \"date_from\": \"2025-01-08 00:00:00\",\n \"date_to\": \"2025-10-29 00:00:00\",\n \"description\": \"Сопроводительное письмо\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/locators","description":"Cоздание ссылки для объекта, по которой пользователь без доступа ко SKIF.PRO может следить за объектом на карте
\n
\nПоля запроса JSON:
unit - объект или units_group - группа объектов
date_from - время начала
date_to - время окончания
description - Сопроводительное письмо
\n
\nПример запроса:
\n{\n \"unit\": {\"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"},\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"description\": \"Some text\"\n}\n\n
\nПример ответа:
\nstatus - определяется автоматически: запланировано, запущено или завершено
active - true, если отключено
\n{\n \"id\": \"7b58f5a0-947d-446f-ad77-3cfd4a68a956\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"unit\": {\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\",\n \"name\": \"Маршрутка\"\n },\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"description\": \"Some text\",\n \"status\": {\n \"key\": \"locator_running\",\n \"type\": \"locator_type\",\n \"value\": \"Запущено\"\n },\n \"is_active\": true\n}\n\n
Для группы:
\n{\n \"units_group\": {\n \"id\": \"a707cc43-c585-4022-8584-f1b0881e7d71\"\n },\n \"date_from\": \"2025-01-08 00:00:00\",\n \"date_to\": \"2025-10-29 00:00:00\",\n \"description\": \"Сопроводительное письмо\"\n}\n\n
","urlObject":{"path":["api_v1","locators"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fec45468-0557-4396-855d-d1b50fb9d3b9"},{"name":"/locators?ids=ids","id":"12b95576-6cf1-4bdb-ba66-482d2389c02e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/locators?ids=","description":"Поиск локаторов по ID
\n
\nВозвращает массив локаторов по ID.
\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный локатор.
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\nGET /locators?ids=5bf87787-9592-41c7-a25e-500cc1234402
\n
\nПример ответа:
\n{\n \"id\": \"5bf87787-9592-41c7-a25e-500cc1234402\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"units\": [{\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\",\n \"name\": \"Маршрутка\",\n \"imei\": \"338770698941441\",\n \"icon\": {\n \"key\": \"van_universal2_red\",\n \"type\": \"unit_icon\",\n \"value\": \"Иконка\"\n }\n },{\n \"id\": \"3dee5ff9-808f-4536-bec3-9e146bca9327\",\n \"name\": \"Бензовоз\",\n \"imei\": \"514295160184391\",\n \"icon\": {\n \"key\": \"van_universal2_red\",\n \"type\": \"unit_icon\",\n \"value\": \"Иконка\"\n }\n }\n ],\n \"date_from\": \"2022-10-28 00:00:00\",\n \"date_to\": \"2022-10-29 00:00:00\",\n \"status\": {\n \"key\": \"locator_finished\",\n \"type\": \"locator_type\",\n \"value\": \"Завершено\"\n },\n \"is_active\": true,\n \"description\": \"Сопроводительное письмо\",\n \"_active\": true\n}\n\n
","urlObject":{"path":["api_v1","locators"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"12b95576-6cf1-4bdb-ba66-482d2389c02e"},{"name":"/locator?id=:id","id":"75d1ace3-80b1-4cc1-93c3-bf1669828294","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/locator?id=","description":"Получение информации о локаторе по ID
\n
\nПример запроса:
\nGET /locator?id=ee07b417-a85f-4fc5-a37a-416f98295ab7
\n
\nПример ответа:
\nВозвращаются следующие поля:
\n\n- unit - информация об объекта: id, name, icon.
\n- icon - ключ иконки объекта.
\n- is_active - активность.
\n- description - описание.
\n- date_from - дата и время начала.
\n
\n{\n \"id\": \"ee07b417-a85f-4fc5-a37a-416f98295ab7\",\n \"is_active\": true,\n \"description\": \"ывфв\",\n \"date_from\": \"2025-01-03 00:00:00\",\n \"date_to\": \"2025-01-31 00:00:00\",\n \"unit\": {\n \"id\": \"4c99d470-d356-43d9-a35b-f30e72c501c0\",\n \"name\": \"Дрон Леталка\",\n \"icon\": \"quadrocopter_blue\"\n }\n}\n\n
\nВозвращает запись локатора, если он найден, иначе ошибка с кодом 422:
\n{\n\"code\": 4220,\n\"message\": \"Неверная ссылка доступа\"\n}\n\n
\nДля группы объектов:
\nВместо unit приходит units_group. В нем units - информация об объектах.
\n{\n \"id\": \"11647617-3d50-42f5-94a7-e2f199e4cc4c\",\n \"is_active\": true,\n \"description\": \"Сопроводительное письмо\",\n \"date_from\": \"2025-01-08 00:00:00\",\n \"date_to\": \"2025-10-29 00:00:00\",\n \"units_group\": {\n \"id\": \"a707cc43-c585-4022-8584-f1b0881e7d71\",\n \"name\": \"Шлишуе\",\n \"units\": [\n {\n \"id\": \"2b7dee48-7804-4544-b0f0-e7f98ccffa24\",\n \"name\": \"Galileo2\",\n \"icon\": \"car_red\"\n },\n {\n \"id\": \"4c99d470-d356-43d9-a35b-f30e72c501c0\",\n \"name\": \"Дрон Леталка\",\n \"icon\": \"quadrocopter_blue\"\n },\n {\n \"id\": \"abe8c77e-4cbd-4d66-b1fe-723610cdfa32\",\n \"name\": \"Galileo Test\",\n \"icon\": \"autocrane_red\"\n },\n {\n \"id\": \"c6286fe0-a597-43d0-b60f-2058bafbb9e0\",\n \"name\": \"Курьер пиццерии\",\n \"icon\": \"car_red\"\n },\n {\n \"id\": \"c9f37a6a-56ff-450d-9e5b-16539f643e27\",\n \"name\": \"Galileo1\",\n \"icon\": \"car_red\"\n }\n ]\n }\n}\n\n
\n","urlObject":{"path":["api_v1","locator"],"host":["{{base_url}}"],"query":[{"key":"id","value":""}],"variable":[]}},"response":[],"_postman_id":"75d1ace3-80b1-4cc1-93c3-bf1669828294"},{"name":"/locators/:id","id":"7422fbb1-67cc-4d1f-8b98-cdfa73acb970","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"value\": 5\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/locators/:id","description":"Удаление локатора по ID
\n
\nРоль: Администратор и выше.
\n","urlObject":{"path":["api_v1","locators",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID локатора
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"7422fbb1-67cc-4d1f-8b98-cdfa73acb970"},{"name":"/locators/list","id":"8ed7db1e-9877-4b62-837e-6d914b693281","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\"field\": \"unit.id\", \"value\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/locators/list","description":"Поиск локаторов
\n
\nfrom - начальный индекс.
count - количество записей.
conditions - условия
field - название поля, возвожные значения: unit.id, date_from, date_to.
value - значение
\n
\nРоль: Читатель и выше.
\n
\nПример запроса:
\n{\n \"from\": 0,\n \"count\": 10,\n \"conditions\": [\n {\"field\": \"unit.id\", \"value\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"}\n ]\n}\n\n
\nПример ответа:
\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"56e539a1-5709-49b2-a3a3-5bc0710e0098\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"unit\": {\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"\n },\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"is_active\": true,\n \"_active\": true\n },\n {\n \"id\": \"7b58f5a0-947d-446f-ad77-3cfd4a68a956\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"unit\": {\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\"\n },\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-28 00:00:00\",\n \"is_active\": true,\n \"description\": \"Some text\",\n \"_active\": true\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","locators","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8ed7db1e-9877-4b62-837e-6d914b693281"},{"name":"/locators/:id","id":"ef52378d-ff17-4b82-aa66-e0934da33161","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"7b58f5a0-947d-446f-ad77-3cfd4a68a956\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"units\": [{\n \"id\": \"1f6fe207-31c9-4cd0-894b-7b1cb85944c9\",\n \"name\": \"Маршрутка\"\n }],\n \"date_from\": \"2022-09-27 00:00:00\",\n \"date_to\": \"2022-09-29 00:00:00\",\n \"status\": {\n \"key\": \"locator_running\",\n \"type\": \"locator_type\",\n \"value\": \"Запушено\"\n },\n \"is_active\": true,\n \"_active\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/locators/:id","description":"Обновление данных локатора
\n
\nПараметры:
\nсм метод POST /locators
\n
\nРоль: Администратор и выше.
\n
\nОтвет:
\nАналогичен одному объекту из ответа метода GET /locators?ids=:id
\n","urlObject":{"path":["api_v1","locators",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID локатора
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"ef52378d-ff17-4b82-aa66-e0934da33161"}],"id":"c64aeda0-92ee-421e-b1bf-ea6bebf7f2cb","event":[{"listen":"prerequest","script":{"id":"6a396a89-5f83-448b-ad05-4eac00957d10","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"cafa6fcb-4dba-4be6-8b06-acc4638a7d15","type":"text/javascript","exec":[""]}}],"_postman_id":"c64aeda0-92ee-421e-b1bf-ea6bebf7f2cb","description":""},{"name":"Импорт из Wialon","item":[{"name":"/loadwln/:company_id/units/analyze_terminals","id":"ab1fdf66-a6ed-4ab5-ad22-f88d40ab4369","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/Desktop/OLJA_ARGO_Units/Босколь.zip"}]},"url":"{{base_url}}/api_v1/loadwln/:company_id/units/analyze_terminals","description":"Проверка терминалов при загрузке объектов из Wialon
\n
\nПараметры запроса:
company_id - ID компании
\nВ FormData в поле file необходимо отправить zip или xml файл.
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/units/analyze_terminals
\n
\nПример ответа:
\nid - уникальный ID сеанса. В последующих запросах необходимо указать этот ID.
terminals - список предлагаемых преобразований для терминалов.
- key - названия терминала в wialon.
- value - терминал в скиф, его можно изменить. Если совпадений не найдено, тогда возвращается null.
\n{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals\": [\n {\n \"key\": \"Navtelecom Signal S-2551\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n },\n {\n \"key\": \"Teltonika FM1100\",\n \"value\": {\n \"key\": \"teltonica_fm1100\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm1100\"\n }\n },\n {\n \"key\": \"Teltonika FM4200\",\n \"value\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n }\n },\n {\n \"key\": \"Navtelecom SMART\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","loadwln",":company_id","units","analyze_terminals"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"ab1fdf66-a6ed-4ab5-ad22-f88d40ab4369"},{"name":"/loadwln/:company_id/units/analyze_params","id":"c595c07d-843d-45fb-ab70-10fcf17ea77d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals\": [\n {\n \"key\": \"Navtelecom Signal S-2551\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n },\n {\n \"key\": \"Teltonika FM1100\",\n \"value\": {\n \"key\": \"teltonica_fm1100\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm1100\"\n }\n },\n {\n \"key\": \"Teltonika FM4200\",\n \"value\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n }\n },\n {\n \"key\": \"Navtelecom SMART\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/loadwln/:company_id/units/analyze_params","description":"Запрос проверки параметров при загрузке объектов из Wialon
\n
\nПараметры запроса:
company_id - ID компании
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/units/analyze_params
\nТело запроса:
id - ID сеанса которое получено из первого запроса POST /loadwln/:company_id/units/analyze_terminals
terminals - список преобразований для терминалов
- key - названия терминала в wialon
- value - терминал в скиф
\n{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals\": [\n {\n \"key\": \"Navtelecom Signal S-2551\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n },\n {\n \"key\": \"Teltonika FM1100\",\n \"value\": {\n \"key\": \"teltonica_fm1100\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm1100\"\n }\n },\n {\n \"key\": \"Teltonika FM4200\",\n \"value\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n }\n },\n {\n \"key\": \"Navtelecom SMART\",\n \"value\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n }\n }\n ]\n}\n\n
\nПример ответа:
\nid - уникальный ID сеанса. Такой же, как в запросе.
terminals_params - список предлагаемых преобразований для параметров датчиков.
terminal_type - тип терминала.
params - список предлагаемых преобразований для терминала.
- key - название параметра в wialon.
- value - название параметра в скиф, можно изменить значение. Если не найден, тогда возвращается null.
\n{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals_params\": [\n {\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"params\": [\n {\n \"key\": \"engine_load\",\n \"value\": null\n },\n {\n \"key\": \"engine_coolant_temp\",\n \"value\": null\n },\n {\n \"key\": \"engine_rpm\",\n \"value\": null\n },\n {\n \"key\": \"in2\",\n \"value\": \"in_2_st\"\n },\n {\n \"key\": \"touch_key\",\n \"value\": \"touch_mem_key\"\n },\n {\n \"key\": \"in1\",\n \"value\": \"in_1_st\"\n },\n {\n \"key\": \"in4\",\n \"value\": \"in_4_st\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"in_3_st\"\n },\n {\n \"key\": \"in5\",\n \"value\": \"in_5_st\"\n },\n {\n \"key\": \"can_fuel_volume\",\n \"value\": null\n },\n {\n \"key\": \"can_engine_hours\",\n \"value\": null\n },\n {\n \"key\": \"can_fuel_consumpt\",\n \"value\": null\n },\n {\n \"key\": \"out1\",\n \"value\": \"out_1_st\"\n },\n {\n \"key\": \"accel_pedal_pos\",\n \"value\": null\n }\n ]\n },\n {\n \"terminal_type\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n },\n \"params\": [\n {\n \"key\": \"in1\",\n \"value\": \"din1\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"din3\"\n }\n ]\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","loadwln",":company_id","units","analyze_params"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"c595c07d-843d-45fb-ab70-10fcf17ea77d"},{"name":"/loadwln/:company_id/units/create","id":"aa92eee5-2d91-4243-8a8e-870d2c1751f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals_params\": [\n {\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"params\": [\n {\n \"key\": \"engine_load\",\n \"value\": \"can_eng_load\"\n },\n {\n \"key\": \"engine_coolant_temp\",\n \"value\": \"dut_temp_485_3\"\n },\n {\n \"key\": \"engine_rpm\",\n \"value\": \"can_rpm\"\n },\n {\n \"key\": \"in2\",\n \"value\": \"in_2_st\"\n },\n {\n \"key\": \"touch_key\",\n \"value\": \"touch_mem_key\"\n },\n {\n \"key\": \"in1\",\n \"value\": \"in_1_st\"\n },\n {\n \"key\": \"in4\",\n \"value\": \"in_4_st\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"in_3_st\"\n },\n {\n \"key\": \"in5\",\n \"value\": \"in_5_st\"\n },\n {\n \"key\": \"can_fuel_volume\",\n \"value\": \"can_fuel_rate\"\n },\n {\n \"key\": \"can_engine_hours\",\n \"value\": \"can_eng_hours\"\n },\n {\n \"key\": \"can_fuel_consumpt\",\n \"value\": \"can_fuel_level\"\n },\n {\n \"key\": \"out1\",\n \"value\": \"out_1_st\"\n },\n {\n \"key\": \"accel_pedal_pos\",\n \"value\": \"can_accel_pos\"\n }\n ]\n },\n {\n \"terminal_type\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n },\n \"params\": [\n {\n \"key\": \"in1\",\n \"value\": \"din1\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"din3\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/loadwln/:company_id/units/create","description":"Запрос создания объектов при загрузке объекты из Wialon
\n
\nПараметры запроса:
company_id - ID компании
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/units/analyze_params
\nТело запроса:
id - ID сеанса которое получено из первого запроса POST /loadwln/:company_id/units/analyze_terminals
terminals_params - список преобразований для параметров датчиков.
terminal_type - тип терминала.
params - список преобразований пераметров для терминала.
- key - название параметра в wialon.
- value - название параметра в скиф.
\n{\n \"id\": \"b0bdff74-6901-4366-a06a-c32dfde15e5b\",\n \"terminals_params\": [\n {\n \"terminal_type\": {\n \"key\": \"navtelecom\",\n \"type\": \"terminal_type\",\n \"value\": \"Navtelecom\"\n },\n \"params\": [\n {\n \"key\": \"engine_load\",\n \"value\": \"can_eng_load\"\n },\n {\n \"key\": \"engine_coolant_temp\",\n \"value\": \"dut_temp_485_3\"\n },\n {\n \"key\": \"engine_rpm\",\n \"value\": \"can_rpm\"\n },\n {\n \"key\": \"in2\",\n \"value\": \"in_2_st\"\n },\n {\n \"key\": \"touch_key\",\n \"value\": \"touch_mem_key\"\n },\n {\n \"key\": \"in1\",\n \"value\": \"in_1_st\"\n },\n {\n \"key\": \"in4\",\n \"value\": \"in_4_st\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"in_3_st\"\n },\n {\n \"key\": \"in5\",\n \"value\": \"in_5_st\"\n },\n {\n \"key\": \"can_fuel_volume\",\n \"value\": \"can_fuel_rate\"\n },\n {\n \"key\": \"can_engine_hours\",\n \"value\": \"can_eng_hours\"\n },\n {\n \"key\": \"can_fuel_consumpt\",\n \"value\": \"can_fuel_level\"\n },\n {\n \"key\": \"out1\",\n \"value\": \"out_1_st\"\n },\n {\n \"key\": \"accel_pedal_pos\",\n \"value\": \"can_accel_pos\"\n }\n ]\n },\n {\n \"terminal_type\": {\n \"key\": \"teltonica_fm4200\",\n \"type\": \"terminal_type\",\n \"value\": \"teltonica_fm4200\"\n },\n \"params\": [\n {\n \"key\": \"in1\",\n \"value\": \"din1\"\n },\n {\n \"key\": \"in3\",\n \"value\": \"din3\"\n }\n ]\n }\n ]\n}\n\n
\nПример ответа:
\n{\n \"result\": \"Добавлены 4 объекты\"\n}\n\n
","urlObject":{"path":["api_v1","loadwln",":company_id","units","create"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"aa92eee5-2d91-4243-8a8e-870d2c1751f1"},{"name":"/loadwln/:company_id/units/add_services","id":"0f57a10a-ea97-4409-a15e-6215eb9be724","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/Downloads/А898МТ.wlp"}]},"url":"{{base_url}}/api_v1/loadwln/:company_id/units/add_services","description":"Параметры запроса:
company_id - ID компании
\nВ теле запроса в form-data укажите zip или wlp файл в поле file
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/units/add_services
\n{\n \"result\": \"Обновлена ТО для объектов 1\",\n \"found_units\": [\n \"А898МТ\"\n ],\n \"not_found_units\": []\n}\n\n
","urlObject":{"path":["api_v1","loadwln",":company_id","units","add_services"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"0f57a10a-ea97-4409-a15e-6215eb9be724"},{"name":"/loadwln/geozones/create","id":"606d65cf-902c-4e11-b793-121d955aa036","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/Downloads/example.kmz"},{"key":"companies_ids","value":"c968398b-be00-4b4a-9e2c-7d7bdc0d43ad,c0c7d3e7-3dab-4fc8-aba6-6c8169efe3e3","type":"text"}]},"url":"{{base_url}}/api_v1/loadwln/geozones/create","description":"Загрузка геозон из форматов kml, kmz и zip
\n
\nВ FormData необходимо отправить следующие поля:
\nfile - отправить файл с форматом kml, kmz и zip. ZIP-файл может содержать несколько файлов KML. Максимальный размер файла 5 Мб.
\ncompanies_ids - ID компаний, разделенные запятыми.
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/geozones/create
\n
\nПример ответа:
\nВ случае успеха статус ответа — 200, а тело ответа содержит информацию о количестве добавленных геозон:
\n{\n \"result\": \"Добавлены геозоны: 4\"\n}\n\n
В случае ошибки тело ответа содержит информацию об ошибке:
\n{\n \"error\": {\n \"code\": 4220,\n \"message\": \"Геозоны не найдены\"\n }\n}\n\n
","urlObject":{"path":["api_v1","loadwln","geozones","create"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"606d65cf-902c-4e11-b793-121d955aa036"},{"name":"/loadwln/:units_id/data/analyze_params","id":"2cd264ac-4b42-4ccf-82c8-5f15686f0e4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/skif_projects/skif_units/test/data/geozones.kml"}]},"url":"{{base_url}}/api_v1/loadwln/:units_id/geozones/create","description":"Загрузка геозон из формата kml
\n
\nПараметры запроса:
company_id - ID компании
В FormData в поле file необходимо отправить kml файл.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/geozones/create
\n
\nПример ответа:
\n{\n \"result\": \"Добавлены 4 геозоны\"\n}\n\n
","urlObject":{"path":["api_v1","loadwln",":units_id","geozones","create"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"units_id"}]}},"response":[],"_postman_id":"2cd264ac-4b42-4ccf-82c8-5f15686f0e4c"},{"name":"/loadwln/:units_id/data/create","id":"5849c77f-1551-4763-8045-19d152b4817e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/home/azat/skif_projects/skif_units/test/data/geozones.kml"}]},"url":"{{base_url}}/api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/geozones/create","description":"Загрузка геозон из формата kml
\n
\nПараметры запроса:
company_id - ID компании
В FormData в поле file необходимо отправить kml файл.
\n
\nПример запроса:
\nPOST /api_v1/loadwln/3aafd100-c44d-4b04-ae93-06978b908ea9/geozones/create
\n
\nПример ответа:
\n{\n \"result\": \"Добавлены 4 геозоны\"\n}\n\n
","urlObject":{"path":["api_v1","loadwln","3aafd100-c44d-4b04-ae93-06978b908ea9","geozones","create"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5849c77f-1551-4763-8045-19d152b4817e"}],"id":"830df9f0-a87b-448e-8c46-b3086edb8618","_postman_id":"830df9f0-a87b-448e-8c46-b3086edb8618","description":""},{"name":"Удаление данных","item":[{"name":"/data_deletions","id":"bb1b1854-4252-4ef5-89b3-91b5be819a46","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"start_date\": \"2022-08-01 12:30:09\",\n \"finish_date\": \"2022-08-02 15:31:19\",\n \"unit\": {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n}"},"url":"{{base_url}}/api_v1/data_deletions","description":"Удаление данных для объекта в диапазоне дат
\n
\nПараметры:
\n\"start_date\": Начала интервала, в формате yyyy-MM-dd HH:mm:ss
\"finish_date\": Конец интервала, в формате yyyy-MM-dd HH:mm:ss
\"unit\": Объект, достаточно указать ID.
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"start_date\": \"2022-08-01 12:30:09\",\n \"finish_date\": \"2022-08-02 15:31:19\",\n \"unit\": {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n}\n\n
\nПример ответа:
\n{\n \"id\": \"62cc8ce7-da3d-4e1e-8086-4a8e165fcd1f\",\n \"start_date\": \"2022-08-01 12:30:09\",\n \"finish_date\": \"2022-08-02 15:31:19\",\n \"unit\": {\n \"id\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n }\n}\n\n
","urlObject":{"path":["api_v1","data_deletions"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bb1b1854-4252-4ef5-89b3-91b5be819a46"},{"name":"/data_deletions/:id","id":"8f23b05e-1b35-4813-92c9-a88835744cdc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api_v1/data_deletions/:id","description":"Отмена удаления данных для объекта в диапазоне дат
\n
\nПараметры:
id - ID записи
\n
\nПример запроса:
DELETE /data_deletions/62cc8ce7-da3d-4e1e-8086-4a8e165fcd1f
\n","urlObject":{"path":["api_v1","data_deletions",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID записи
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"8f23b05e-1b35-4813-92c9-a88835744cdc"},{"name":"/data_deletions/list","id":"866e13dd-0390-4936-80bb-018db79dbabf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n },\n {\n \"field\": \"start_date\",\n \"value\": \"2022-08-01 00:00:00\"\n },\n {\n \"field\": \"finish_date\",\n \"value\": \"2022-08-30 00:00:00\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/data_deletions/list","description":"Получение списка удаленных интервалов
\n
\nВ conditions можно указать фильтры:
\n\nunit.id - ID объекта
\nstart_date - Дата, от
\nfinish_date - Дата, до
\n
\n
\nРоль: Читатель и выше.
\n
\nПример запроса:
\n{\n \"conditions\": [\n {\n \"field\": \"unit.id\",\n \"value\": \"97fba3d2-841b-43cd-911a-073b84ad5438\"\n },\n {\n \"field\": \"start_date\",\n \"value\": \"2022-08-01 00:00:00\"\n },\n {\n \"field\": \"finish_date\",\n \"value\": \"2022-08-30 00:00:00\"\n }\n ]\n}\n\n
\nПример ответа:
\n{\n \"max\": 4,\n \"list\": [\n {\n \"id\": \"5a1e36c2-a389-4a80-8acb-ec913d54df29\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"359633107825189\",\n \"start_date\": \"2022-08-10 00:00:00\",\n \"finish_date\": \"2022-08-12 00:00:00\"\n },\n {\n \"id\": \"c2efec3c-5dda-4c53-904f-d79acce20537\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"359633107825189\",\n \"start_date\": \"2022-08-15 00:00:00\",\n \"finish_date\": \"2022-08-20 00:00:00\"\n },\n {\n \"id\": \"4877a5cc-b26b-4aca-95c6-2bd3480f9495\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"359633107825189\",\n \"start_date\": \"2022-08-18 00:00:00\",\n \"finish_date\": \"2022-08-21 00:00:00\"\n },\n {\n \"id\": \"9b0389a4-b149-4b01-9ee7-7766c58b8d4a\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"359633107825189\",\n \"start_date\": \"2022-08-23 02:00:00\",\n \"finish_date\": \"2022-08-24 22:00:00\"\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","data_deletions","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"866e13dd-0390-4936-80bb-018db79dbabf"}],"id":"af84ca20-4164-4eb9-92a6-2131bff4a75a","_postman_id":"af84ca20-4164-4eb9-92a6-2131bff4a75a","description":""},{"name":"Видео","item":[{"name":"/videos","id":"69f01981-d010-4827-8e16-bbf586ff6c1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"units\": [\n {\n \"id\": \"d0dd6178-fd10-4f49-8627-a386ac35b8c3в\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/videos","description":"Запрос на получение видео-потоков для регистратора, связанного с объектом
\n
\nПараметры:
\nid объекта.
\nСейчас обрабатывается только первый объект в списке.
\n{\n \"units\": [\n {\n \"id\": \"d0dd6178-fd10-4f49-8627-a386ac35b8c3\"\n }\n ]\n}\n\n
В доп полях передаваемых объектов должны быть прописаны поля со соледующими ключами:
\n1. Видео устройство - video_device_name
2. ID-видео устройства - video_device_id
3. Камеры (потоки) - video_cameras (числа через запятую)
\n
\nОтвет:
\nstream - код потока
\nurl - url потока
\n[\n {\n \"stream\": \"0\",\n \"url\": \"http://dev.skif.pro:9090/start?deviceid=019000021045&channel=1&stream=1&token=9f44b390f3a00875528d529912e535adb77aef235f8fe492661bcdcc22ae3e0a\"\n },\n {\n \"stream\": \"1\",\n \"url\": \"http://dev.skif.pro:9090/start?deviceid=019000021045&channel=2&stream=1&token=9f44b390f3a00875528d529912e535adb77aef235f8fe492661bcdcc22ae3e0a\"\n }\n]\n\n
Возможные виды ошибок:
\n{\n \"code\": 5000,\n \"message\": \"Внутренняя ошибка сервера\"\n}\n\n
где code - внутренний код ошибки.
\nmessage - текст, который можно отобразить пользователю.
\n","urlObject":{"path":["api_v1","videos"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"69f01981-d010-4827-8e16-bbf586ff6c1b"}],"id":"be438d80-6281-4939-b7e5-86f9ac20b08e","_postman_id":"be438d80-6281-4939-b7e5-86f9ac20b08e","description":""},{"name":"Группы доступа","item":[{"name":"/units_groups_access?units_group_id=units_group_id","id":"f3aaa147-4ed8-4d3b-9ac0-159e060ffa1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units_groups_access?units_group_id=","description":"Получение списка пользователей, имеющих доступ к группе объектов
\n
\nПараметры запроса:
\nunits_group_id - ID группы
\n
\nРоль: Администратор и выше.
\n
\nОтвет:
\nПриходит JSON массив. Каждый элемент имеет:
\n\nid - ID действия
\nkey - ключ действия
\nname - название действия
\n
\n[\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n }\n ],\n \"user\": {\n \"id\": \"95568a4b-9ca8-4552-95d1-d22ce5020cdc\",\n \"name\": \"User1\"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n },\n {\n \"id\": \"262b7e97-dbfa-4288-9878-ad564672796e\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\"\n },\n {\n \"id\": \"5f182c77-dfa7-4fb2-947a-2a1fc44ee83b\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\"\n }\n ],\n \"user\": {\n \"id\": \"e09239ea-b09f-4801-94c8-cc15af7606a4\",\n \"name\": \"User2\"\n }\n }\n]\n\n
","urlObject":{"path":["api_v1","units_groups_access"],"host":["{{base_url}}"],"query":[{"key":"units_group_id","value":""}],"variable":[]}},"response":[],"_postman_id":"f3aaa147-4ed8-4d3b-9ac0-159e060ffa1a"},{"name":"/units_groups_access/:company_id?units_group_id=units_group_id","id":"20171c93-e556-45a3-82d3-1154ef7ed5ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/units_groups_access/:company_id?units_group_id=","description":"Получение списка пользователей, имеющих доступ к группе объектов
\n
\nПараметры запроса:
\ncompany_id - ID компании
\nunits_group_id - ID группы
\n
\nРоль: Администратор и выше.
\n
\nОтвет:
\nПриходит JSON массив. Каждый элемент имеет:
\n\nid - ID действия
\nkey - ключ действия
\nname - название действия
\n
\n[\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n }\n ],\n \"user\": {\n \"id\": \"95568a4b-9ca8-4552-95d1-d22ce5020cdc\",\n \"name\": \"User1\"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n },\n {\n \"id\": \"262b7e97-dbfa-4288-9878-ad564672796e\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\"\n },\n {\n \"id\": \"5f182c77-dfa7-4fb2-947a-2a1fc44ee83b\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\"\n }\n ],\n \"user\": {\n \"id\": \"e09239ea-b09f-4801-94c8-cc15af7606a4\",\n \"name\": \"User2\"\n }\n }\n]\n\n
","urlObject":{"path":["api_v1","units_groups_access",":company_id"],"host":["{{base_url}}"],"query":[{"description":{"content":"ID группы
\n","type":"text/plain"},"key":"units_group_id","value":""}],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"}]}},"response":[],"_postman_id":"20171c93-e556-45a3-82d3-1154ef7ed5ea"},{"name":"/units_groups_access/:units_group_id","id":"c5b32349-b7e0-4211-a5e2-4628749ef086","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"[\n {\n \"actions\": [\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n }\n ],\n \"user\": {\n \"id\": \"ec8dc446-f72e-4524-88be-2980c960706a\",\n \"name\": \"hafobe2078@larland.com\"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n }\n ],\n \"user\": {\n \"id\": \"473e1c5e-497f-4ca2-b359-0ccf1e5bb27b\",\n \"name\": \"Офис \"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"7c20d415-6b8c-47fe-b5d4-737e55f1f7a7\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"e5b7aa86-36c3-49db-ad93-7fcfc4f3a790\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\",\n \"parent_id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n }\n ],\n \"user\": {\n \"id\": \"161fb066-94c8-474c-9ff4-d53daa70312c\",\n \"name\": \"Офис1\"\n }\n }\n]","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_groups_access/:units_group_id","description":"Обновление списка пользователей, имеющих доступ к группе объектов
\n
\nПараметры запроса:
\nunits_group_id - ID группы
\n
\nРоль: Администратор и выше.
\n
\nОтвет:
\nПриходит JSON массив. Каждый элемент имеет: actions и user.
\n[\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n }\n ],\n \"user\": {\n \"id\": \"95568a4b-9ca8-4552-95d1-d22ce5020cdc\",\n \"name\": \"User1\"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n },\n {\n \"id\": \"262b7e97-dbfa-4288-9878-ad564672796e\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\"\n },\n {\n \"id\": \"5f182c77-dfa7-4fb2-947a-2a1fc44ee83b\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\"\n }\n ],\n \"user\": {\n \"id\": \"e09239ea-b09f-4801-94c8-cc15af7606a4\",\n \"name\": \"User2\"\n }\n }\n]\n\n
Запрос и ответ имеет структура такой же как GET /units_groups_access?units_group_id=units_group_id
\n","urlObject":{"path":["api_v1","units_groups_access",":units_group_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID группы
\n","type":"text/plain"},"type":"any","value":"","key":"units_group_id"}]}},"response":[],"_postman_id":"c5b32349-b7e0-4211-a5e2-4628749ef086"},{"name":"/units_groups_access","id":"521d19aa-12d0-42cb-b717-35e212fa13a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Newgroup5\",\n \"units\": [\n {\n \"id\": \"1f6f6863-e202-4bbd-8186-11380e3b6476\"\n }\n ],\n \"users\": [\n {\n \"id\": \"844cb9af-9158-4418-95d7-de9df14ae4d7\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_groups_access","description":"Создание новой группы с доступом
\n
\nname - имя группы
\nunits - объекты
\nusers - пользователи
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"name\": \"Newgroup5\",\n \"units\": [\n {\n \"id\": \"1f6f6863-e202-4bbd-8186-11380e3b6476\"\n }\n ],\n \"users\": [\n {\n \"id\": \"844cb9af-9158-4418-95d7-de9df14ae4d7\"\n }\n ]\n}\n\n
Возвращает созданную группу. Указанные пользователи будут иметь доступ к этой группе
\n","urlObject":{"path":["api_v1","units_groups_access"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"521d19aa-12d0-42cb-b717-35e212fa13a1"},{"name":"/units_groups_access/:company_id/:units_group_id","id":"50d0a445-e85d-4896-bd35-cf926db0123e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"[\n {\n \"actions\": [\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n }\n ],\n \"user\": {\n \"id\": \"1445da1b-6976-492a-8df0-7e790e69e553\",\n \"name\": \"Ivan\",\n \"role\": {\n \"id\": \"6592d562-e965-43bd-9d9e-8319cabd6291\",\n \"key\": \"OPERATOR\",\n \"value\": \"Оператор\"\n }\n },\n \"available_actions_keys\": [\n \"update_unit\",\n \"delete_unit\",\n \"update_unit_imei\",\n \"update_unit_name_icon\",\n \"get_unit\"\n ]\n },\n {\n \"actions\": [\n {\n \"id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"7c20d415-6b8c-47fe-b5d4-737e55f1f7a7\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"0e83be60-b808-4f06-b6db-e01377720d47\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\",\n \"parent_id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n }\n ],\n \"user\": {\n \"id\": \"8462404e-99a9-4226-ae14-2f59e0400768\",\n \"name\": \"vayokor918@ikumaru.com\",\n \"role\": {\n \"id\": \"ed858ec5-a3c7-4901-9078-efc65a350b93\",\n \"key\": \"ADMIN\",\n \"value\": \"Новая роль1124124\"\n }\n },\n \"available_actions_keys\": [\n \"update_unit\",\n \"delete_unit\",\n \"update_unit_imei\",\n \"update_unit_name_icon\",\n \"get_unit\"\n ]\n }\n]","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units_groups_access/:company_id/:units_group_id","description":"Обновление списка пользователей, имеющих доступ к группе объектов
\n
\nПараметры запроса:
\ncompany_id - ID компании
\nunits_group_id - ID группы
\n
\nРоль: Администратор и выше.
\n
\nОтвет:
\nПриходит JSON массив. Каждый элемент имеет: actions и user
\n[\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n }\n ],\n \"user\": {\n \"id\": \"95568a4b-9ca8-4552-95d1-d22ce5020cdc\",\n \"name\": \"User1\"\n }\n },\n {\n \"actions\": [\n {\n \"id\": \"8a94afa3-2f4d-4cae-84ed-05197e412e56\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\"\n },\n {\n \"id\": \"fb369ecf-4446-45e7-9835-57bad481f161\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\"\n },\n {\n \"id\": \"415b7e76-3c57-439c-bbb9-1b1e7eb78a0f\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\"\n },\n {\n \"id\": \"262b7e97-dbfa-4288-9878-ad564672796e\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\"\n },\n {\n \"id\": \"5f182c77-dfa7-4fb2-947a-2a1fc44ee83b\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\"\n }\n ],\n \"user\": {\n \"id\": \"e09239ea-b09f-4801-94c8-cc15af7606a4\",\n \"name\": \"User2\"\n }\n }\n]\n\n
Запрос и ответ имеют такую же структуру, как GET /units_groups_access?units_group_id=units_group_id
\n","urlObject":{"path":["api_v1","units_groups_access",":company_id",":units_group_id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID компании
\n","type":"text/plain"},"type":"any","value":"","key":"company_id"},{"description":{"content":"ID группы
\n","type":"text/plain"},"type":"any","value":"","key":"units_group_id"}]}},"response":[],"_postman_id":"50d0a445-e85d-4896-bd35-cf926db0123e"},{"name":"New Request","id":"10b92c0e-99f3-4ec2-abea-df684250ed93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"10b92c0e-99f3-4ec2-abea-df684250ed93"}],"id":"a56d1f3d-81ef-4eaa-b605-b71c5bb95c53","_postman_id":"a56d1f3d-81ef-4eaa-b605-b71c5bb95c53","description":""},{"name":"Другое","item":[{"name":"/send_push","id":"c0c370bc-e6e3-4962-a5dc-45c1efef8d60","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/send_push","description":"Отправка push-уведомлений пользователям компаний дилера
\n
\nПараметры:
\ntitle - тема
\nbody - текст уведомления
\n
\nРоль: Супервизор и выше.
\n
\n\n- Отправка всем пользователям компаний дилера
\n
\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\"\n}\n\n
\n2. Отправка всем пользователям конкретной компании, в поле company_id указать ID компании
\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\",\n \"company_id\": \"5fb53281-23b1-42ac-a336-315edcd0a30e\"\n}\n\n
\n3. Отправка конкретному пользователю, указать в поле user_id ID пользователя
\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\",\n \"user_id\": \"1c74912a-ebcd-47e0-8828-8bcfcc7ef59d\"\n}\n\n
\n","urlObject":{"path":["api_v1","send_push"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c0c370bc-e6e3-4962-a5dc-45c1efef8d60"},{"name":"/terminals/columns//","id":"21c9add9-8b58-4b63-bdb8-32038c87d3ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/terminals/columns/arnavi/xxxxxx","description":"
\nРоль: Редактор тарифа и выше.
\n","urlObject":{"path":["api_v1","terminals","columns","arnavi","xxxxxx"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"21c9add9-8b58-4b63-bdb8-32038c87d3ac"},{"name":"/branding","id":"0979ffe7-a4b1-4d64-862e-b8588063fe50","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/branding","description":"Получение брендинга по текущему домену
\n
\nПоля, необходимые для фронта:
\n\nНазвание [Текст]: Название компании интегратора. Это название будет заменять название “SKIF.PRO” в системе. - title
\nЛоготип [Изображение]: Логотип компании интегратора, данный логотип будет отображаться в интерфейсе системы. - logo
\nСсылка на сайт интегратора [Текст]: Гиперссылка (интегратор может дать ссылку на свой сайт). Ссылка срабатывает при клике на Логотип или Название (в email письмах). Необязательные данные. - site
\nОбложка для страницы входа [Изображение]: Изображение которое отображается на странице входа (логина). Необязательные данные. Если изображение от интегратора нет, то используется стандартное обложка (важно: не обложка SKIF.PRO, а стандартная обложка).- background
\nКонтакты [Текст]: Любая текстовая информация от интегратора, предполагается что это будет контактная информация техподдержки (не более 320 символов) - contacts
\n
\nДля получение файлов логотипа и Обложки для страницы входа вызывать /api_v1/<значение поля logo> и /api_v1/<значение поля background>
\n","urlObject":{"path":["api_v1","branding"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0979ffe7-a4b1-4d64-862e-b8588063fe50"},{"name":"/terminals/columns// Copy","id":"12e2017e-3a89-4569-8cc0-a6ed0c32e7cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"terminal_type\": \"arnavi\",\n \"check_imei\": \"xxxxxx\",\n \"columns\": [{\"key\":\"sos_state\"}]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/terminals/columns","description":"
\nРоль: Редактор тарифа и выше.
\n","urlObject":{"path":["api_v1","terminals","columns"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"12e2017e-3a89-4569-8cc0-a6ed0c32e7cd"}],"id":"73d1e809-8c06-4e58-a24d-d532553d37d0","_postman_id":"73d1e809-8c06-4e58-a24d-d532553d37d0","description":""},{"name":"Роли","item":[{"name":"/roles","id":"7d27b40e-18c5-4cce-910e-2dd6d90eb3bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/roles","description":"Получение всех ролей
\n
\nСтруктура роли :
\n\nid - uuid, идентификатор роли.
\nkey - string, ключ роли.
\nvalue - string, название роли
\nis_default - boolean, true, если роль по умолчанию для всех компаний, иначе только для текущий компании.
\nactions - массив действий.
\n
\nЭлементы действий имеют такую структуру:
\n\nid - uuid, идентификатор действия.
\nkey - string, ключ действия.
\nname - string, название действия.
\n
\n
\nПример ответа:
\n[\n {\n \"id\": \"3fbd6629-f854-46e9-a190-cae0eb7fb5f0\",\n \"is_default\": true,\n \"key\": \"NO_ACCESS\",\n \"value\": \"Без доступа\",\n \"actions\": []\n },\n {\n \"id\": \"808942ea-a102-47cb-889d-859b182f160c\",\n \"is_default\": true,\n \"key\": \"OBSERVER\",\n \"value\": \"Наблюдатель\",\n \"actions\": [\n {\n \"id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"key\": \"generate_report\",\n \"name\": \"Генерация отчетов\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fd7ee65f-5fd3-46c8-ad39-ce1227816ed6\",\n \"key\": \"generate_journal\",\n \"name\": \"Смотреть Журнала\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"0fd9f710-cad6-4a8c-bd5d-59f1332b8d52\",\n \"key\": \"generate_other_reports\",\n \"name\": \"Генерация отчета(Кроме журнала)\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"7d7292e4-e246-44e1-ac70-b1c7f23e464c\",\n \"is_default\": true,\n \"key\": \"READER\",\n \"value\": \"Читатель\",\n \"actions\": [\n {\n \"id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"key\": \"generate_report\",\n \"name\": \"Генерация отчетов\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fd7ee65f-5fd3-46c8-ad39-ce1227816ed6\",\n \"key\": \"generate_journal\",\n \"name\": \"Смотреть Журнала\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"0fd9f710-cad6-4a8c-bd5d-59f1332b8d52\",\n \"key\": \"generate_other_reports\",\n \"name\": \"Генерация отчета(Кроме журнала)\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fff20839-8dbc-46ad-98bf-0f01d91ff184\",\n \"key\": \"get_units\",\n \"name\": \"Просмотр всех объектов\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"c3be2a31-04be-4531-bf79-d67490e42453\",\n \"key\": \"get_users\",\n \"name\": \"Чтение справочника пользователей\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"6592d562-e965-43bd-9d9e-8319cabd6291\",\n \"is_default\": true,\n \"key\": \"OPERATOR\",\n \"value\": \"Оператор\",\n \"actions\": [\n {\n \"id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"key\": \"generate_report\",\n \"name\": \"Генерация отчетов\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fd7ee65f-5fd3-46c8-ad39-ce1227816ed6\",\n \"key\": \"generate_journal\",\n \"name\": \"Смотреть Журнала\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"0fd9f710-cad6-4a8c-bd5d-59f1332b8d52\",\n \"key\": \"generate_other_reports\",\n \"name\": \"Генерация отчета(Кроме журнала)\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"441a9b9f-ac5d-4f90-8c2a-98d3ac7121af\",\n \"key\": \"cud_events\",\n \"name\": \"Создание/Редактирование/Удаление Событий\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fff20839-8dbc-46ad-98bf-0f01d91ff184\",\n \"key\": \"get_units\",\n \"name\": \"Просмотр всех объектов\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"c3be2a31-04be-4531-bf79-d67490e42453\",\n \"key\": \"get_users\",\n \"name\": \"Чтение справочника пользователей\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"48138886-6220-41fe-adbe-72e479d8e22d\",\n \"key\": \"commands\",\n \"name\": \"Отправка Команд\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"8ae01b09-95dc-445a-8b92-b570cfa94a04\",\n \"is_default\": true,\n \"key\": \"EDITOR\",\n \"value\": \"Редактор\",\n \"actions\": [\n {\n \"id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"key\": \"generate_report\",\n \"name\": \"Генерация отчетов\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fd7ee65f-5fd3-46c8-ad39-ce1227816ed6\",\n \"key\": \"generate_journal\",\n \"name\": \"Смотреть Журнала\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"0fd9f710-cad6-4a8c-bd5d-59f1332b8d52\",\n \"key\": \"generate_other_reports\",\n \"name\": \"Генерация отчета(Кроме журнала)\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"4132cf99-98fd-47d0-a7c5-fbd2fa167336\",\n \"key\": \"create_units\",\n \"name\": \"Создание объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"77d71ff0-bb6c-447c-af3c-4c0fbe17b5c9\",\n \"key\": \"cud_notifications\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов Уведомлений\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"405bb5f4-d0f0-44cc-9550-4f44f1ae9d61\",\n \"key\": \"cud_trips\",\n \"name\": \"Создание/Редактирование/Удаление Рейсов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"aace4f55-fcf5-4aba-ba32-d3a2335b76e2\",\n \"key\": \"cud_mailings\",\n \"name\": \"Создание/Редактирование/Удаление Рассылок\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"1e79a78d-4ed6-494d-90e4-2ebbd15e80bd\",\n \"key\": \"cud_trailers\",\n \"name\": \"Создание/Редактирование/Удаление Прицепов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"ede4829f-9ecf-474c-ba20-a2b00c687591\",\n \"key\": \"cud_units_groups\",\n \"name\": \"Создание/Редактирование/Удаление Групп\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"441a9b9f-ac5d-4f90-8c2a-98d3ac7121af\",\n \"key\": \"cud_events\",\n \"name\": \"Создание/Редактирование/Удаление Событий\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"d95323ae-0b58-4e91-a7e5-1e862fa07a85\",\n \"key\": \"update_units\",\n \"name\": \"Редактирование всех объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"e4de9d83-fb37-447e-855a-1ee81902490f\",\n \"key\": \"delete_units\",\n \"name\": \"Удаление всех объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fff20839-8dbc-46ad-98bf-0f01d91ff184\",\n \"key\": \"get_units\",\n \"name\": \"Просмотр всех объектов\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"c3be2a31-04be-4531-bf79-d67490e42453\",\n \"key\": \"get_users\",\n \"name\": \"Чтение справочника пользователей\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"877ea798-f16d-490f-ab1c-218ab172a244\",\n \"key\": \"cud_locators\",\n \"name\": \"Создание/Редактирование/Удаление/Просмотр Ссылки доступа\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"48138886-6220-41fe-adbe-72e479d8e22d\",\n \"key\": \"commands\",\n \"name\": \"Отправка Команд\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"2c34a621-b048-494b-bc50-80ec835fed17\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"41607791-8948-460b-8950-d60a9c57c372\",\n \"is_default\": true,\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\",\n \"actions\": [\n {\n \"id\": \"6da12577-da5c-426d-8626-5ad628adcb29\",\n \"key\": \"cud_users\",\n \"name\": \"Изменение справочника пользователей\",\n \"role_key\": \"ADMIN\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n },\n {\n \"id\": \"d9566448-3518-4389-8a39-662f4d6e71ec\",\n \"is_default\": true,\n \"key\": \"SUPERVISOR\",\n \"value\": \"Супервизор\",\n \"actions\": [\n {\n \"id\": \"116e6564-2aa3-4783-9b08-e6a0bbfddec9\",\n \"key\": \"cud_terminals\",\n \"name\": \"Создание/Редактирование/Удаление Терминалов\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"487de2c6-7b5e-40a1-83d7-d0f25331d9b7\",\n \"key\": \"cud_company\",\n \"name\": \"Создание/Редактирование компании\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"9f0c1c49-7a06-4474-b051-610588317502\",\n \"key\": \"delete_company\",\n \"name\": \"Удаление компаний\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n }\n]\n\n
","urlObject":{"path":["api_v1","roles"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"7d27b40e-18c5-4cce-910e-2dd6d90eb3bd"},{"name":"/actions","id":"8472ec19-9462-4075-8874-c6c622015fde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/actions","description":"Получение всех действий
\n
\nВозвращается массив действий.
\nЭлементы действий имеют такую структуру:
\n\nid - uuid, идентификатор действия.
\nkey - string, ключ действия.
\nname - string, название действия.
\n
\n
\nРоль: Администратор и выше.
\n
\nПример ответа:
\n[\n {\n \"id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"key\": \"generate_report\",\n \"name\": \"Генерация отчетов\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"fd7ee65f-5fd3-46c8-ad39-ce1227816ed6\",\n \"key\": \"generate_journal\",\n \"name\": \"Смотреть Журнала\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"0fd9f710-cad6-4a8c-bd5d-59f1332b8d52\",\n \"key\": \"generate_other_reports\",\n \"name\": \"Генерация отчета(Кроме журнала)\",\n \"parent_id\": \"3185300e-e471-4fdd-ad80-4c73288f58f4\",\n \"role_key\": \"OBSERVER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"5a1b7d86-122a-4fe8-b364-0531db41951a\",\n \"key\": \"get_unit\",\n \"name\": \"Просмотр объекта\",\n \"role_key\": \"READER\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"fff20839-8dbc-46ad-98bf-0f01d91ff184\",\n \"key\": \"get_units\",\n \"name\": \"Просмотр всех объектов\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"c3be2a31-04be-4531-bf79-d67490e42453\",\n \"key\": \"get_users\",\n \"name\": \"Чтение справочника пользователей\",\n \"role_key\": \"READER\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"441a9b9f-ac5d-4f90-8c2a-98d3ac7121af\",\n \"key\": \"cud_events\",\n \"name\": \"Создание/Редактирование/Удаление Событий\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"48138886-6220-41fe-adbe-72e479d8e22d\",\n \"key\": \"commands\",\n \"name\": \"Отправка Команд\",\n \"role_key\": \"OPERATOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"4132cf99-98fd-47d0-a7c5-fbd2fa167336\",\n \"key\": \"create_units\",\n \"name\": \"Создание объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"77d71ff0-bb6c-447c-af3c-4c0fbe17b5c9\",\n \"key\": \"cud_notifications\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов Уведомлений\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"405bb5f4-d0f0-44cc-9550-4f44f1ae9d61\",\n \"key\": \"cud_trips\",\n \"name\": \"Создание/Редактирование/Удаление Рейсов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"aace4f55-fcf5-4aba-ba32-d3a2335b76e2\",\n \"key\": \"cud_mailings\",\n \"name\": \"Создание/Редактирование/Удаление Рассылок\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"1e79a78d-4ed6-494d-90e4-2ebbd15e80bd\",\n \"key\": \"cud_trailers\",\n \"name\": \"Создание/Редактирование/Удаление Прицепов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"ede4829f-9ecf-474c-ba20-a2b00c687591\",\n \"key\": \"cud_units_groups\",\n \"name\": \"Создание/Редактирование/Удаление Групп\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"key\": \"update_unit\",\n \"name\": \"Редактирование объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"7c20d415-6b8c-47fe-b5d4-737e55f1f7a7\",\n \"key\": \"delete_unit\",\n \"name\": \"Удаление объекта\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"0e83be60-b808-4f06-b6db-e01377720d47\",\n \"key\": \"update_unit_imei\",\n \"name\": \"Изменение IMEI объекта\",\n \"parent_id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"e5b7aa86-36c3-49db-ad93-7fcfc4f3a790\",\n \"key\": \"update_unit_name_icon\",\n \"name\": \"Обновление названия и иконки объекта\",\n \"parent_id\": \"c7d844c5-ede8-41bb-8679-9a1782815c20\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": true,\n \"_unit_action\": true,\n \"_delete\": false\n },\n {\n \"id\": \"d95323ae-0b58-4e91-a7e5-1e862fa07a85\",\n \"key\": \"update_units\",\n \"name\": \"Редактирование всех объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"e4de9d83-fb37-447e-855a-1ee81902490f\",\n \"key\": \"delete_units\",\n \"name\": \"Удаление всех объектов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"877ea798-f16d-490f-ab1c-218ab172a244\",\n \"key\": \"cud_locators\",\n \"name\": \"Создание/Редактирование/Удаление/Просмотр Ссылки доступа\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"6da12577-da5c-426d-8626-5ad628adcb29\",\n \"key\": \"cud_users\",\n \"name\": \"Изменение справочника пользователей\",\n \"role_key\": \"ADMIN\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"6dddfa19-2f20-4d5e-929e-2b489430a1cb\",\n \"key\": \"finance_report\",\n \"name\": \"Доступ к финансовому отчету\",\n \"role_key\": \"ADMIN\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f478bb8c-ad0c-4595-b9a6-a1198fc69bda\",\n \"key\": \"cud_roles\",\n \"name\": \"Изменение ролей\",\n \"role_key\": \"ADMIN\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"116e6564-2aa3-4783-9b08-e6a0bbfddec9\",\n \"key\": \"cud_terminals\",\n \"name\": \"Создание/Редактирование/Удаление Терминалов\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"487de2c6-7b5e-40a1-83d7-d0f25331d9b7\",\n \"key\": \"cud_company\",\n \"name\": \"Создание/Редактирование компании\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"9f0c1c49-7a06-4474-b051-610588317502\",\n \"key\": \"delete_company\",\n \"name\": \"Удаление компаний\",\n \"role_key\": \"SUPERVISOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n]\n\n
","urlObject":{"path":["api_v1","actions"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8472ec19-9462-4075-8874-c6c622015fde"},{"name":"/roles?ids=id","id":"c6b3cc9c-3e21-4119-b64c-8757e9e72de2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/roles?ids=","description":"Получение роли по ее ID
\n
\nМожет использоваться для получения роли при поступлении сообщения в сокет об обновлении роли другими пользователями.
\nВозвращается роль в виде JSON
\n
\nПример запроса:
\nhttps://dev5.skif.pro/api_v1/roles?ids=f1db015a-4848-4518-8cad-2dfd5d6f4407
\n
\nПример ответа:
\nСтруктура ответа такая же, как в запросе GET /roles. Только возвращается не массив, а один элемент.
\n{\n \"id\": \"f1db015a-4848-4518-8cad-2dfd5d6f4407\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов 2\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ],\n \"_default\": false\n}\n\n
","urlObject":{"path":["api_v1","roles"],"host":["{{base_url}}"],"query":[{"key":"ids","value":""}],"variable":[]}},"response":[],"_postman_id":"c6b3cc9c-3e21-4119-b64c-8757e9e72de2"},{"name":"/roles","id":"bab91009-6e2b-4a9e-94e8-9685efeee5f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов 444\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dev5.skif.pro/api_v1/roles","description":"Создание новой роли в компании
\n
\nСтруктура запроса:
\n\nvalue - string, название новой роли.
\nactions - массив действий, выбранный из списка действий базовой роли.
\n
\nДля создания в админ панеле, необходимо указать ID компании в поле company_id
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"value\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n}\n\n
\nОтвет:
\n{\n \"id\": \"2c34a621-b048-494b-bc50-80ec835fed17\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ],\n \"_default\": false\n}\n\n
","urlObject":{"protocol":"https","path":["api_v1","roles"],"host":["dev5","skif","pro"],"query":[],"variable":[]}},"response":[],"_postman_id":"bab91009-6e2b-4a9e-94e8-9685efeee5f7"},{"name":"/roles/:id","id":"83e7caeb-4744-4684-9f4d-0fe681ec6430","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"0f31eeb6-f5f5-4170-a8ac-9b2ec79f1170\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов 888\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ],\n \"users_count\": 0,\n \"_default\": false\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/roles/:id","description":"Обновление роли в компании
\n
\nПараметр запроса:
\nID роли
\nСтруктура тела запроса JSON, как при создании POST /roles
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\n{\n \"id\": \"2c34a621-b048-494b-bc50-80ec835fed17\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"value\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n}\n\n
\nОтвет:
\n{\n \"id\": \"2c34a621-b048-494b-bc50-80ec835fed17\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"value\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","roles",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID роли
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"83e7caeb-4744-4684-9f4d-0fe681ec6430"},{"name":"/roles/:id","id":"cfd2b619-96df-4ab3-aa52-5e8aac4afd22","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"replace_role\": {\n \"id\": \"3476edf5-d2c9-405c-9dfb-29618c47c807\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/roles/:id","description":"Обновление роли в компании
\n
\nПараметр запроса - ID роли
\nВ теле запроса необходимо указать роль для замены ролей пользователей в поле replace_role, если есть пользователи для этой роли. Достаточно указать ID роли.
\n
\nРоль: Администратор и выше.
\n
\nПример запроса:
\nhttps://dev5.skif.pro/api_v1/roles/1f21bbe2-797f-4d16-9667-70211ab3412c
\n{\n \"replace_role\": {\n \"id\": \"3476edf5-d2c9-405c-9dfb-29618c47c807\"\n }\n}\n\n
\nОтвет:
\n{\n \"id\": \"2c34a621-b048-494b-bc50-80ec835fed17\",\n \"is_default\": false,\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"key\": \"EDITOR\",\n \"name\": \"Редактор геозон и шаблонов отчетов\",\n \"actions\": [\n {\n \"id\": \"1c0ff6a6-e1e6-4d20-bb86-b94cd175aa91\",\n \"key\": \"cud_geozones\",\n \"name\": \"Создание/Редактирование/Удаление Геозон\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n },\n {\n \"id\": \"f9df739b-9e3a-4feb-80c4-a3a1519d0b54\",\n \"key\": \"cud_report_templates\",\n \"name\": \"Создание/Редактирование/Удаление Шаблонов отчетов\",\n \"role_key\": \"EDITOR\",\n \"is_unit_action\": false,\n \"_unit_action\": false,\n \"_delete\": false\n }\n ]\n}\n\n
","urlObject":{"path":["api_v1","roles",":id"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID роли
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"cfd2b619-96df-4ab3-aa52-5e8aac4afd22"}],"id":"ac9d1fd1-403b-4ea0-89bb-d029f4bcfd01","description":"Работа с ролями
\n","_postman_id":"ac9d1fd1-403b-4ea0-89bb-d029f4bcfd01"},{"name":"Новости","item":[{"name":"/news","id":"f5badb54-025f-4f56-b9a4-7da97d78d7ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"title\": \"Обновление функционал геозон\",\n \"message\": \"Длииное описание\",\n \"valid_to\": \"2123-12-31 22:00:00\",\n \"companies\": [\n {\"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"},\n {\"id\": \"f08a0297-05c3-42e5-b433-66cd72e72f61\"}\n ],\n \"roles\": [\n {\"key\": \"EDITOR\"},\n {\"key\": \"ADMIN\"}\n ],\n \"send_types\": [\n {\"key\": \"send_online\"},\n {\"key\": \"send_telegram\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/news","description":"Добавление новостей интегратором для своих компаний
\n
\nПоля:
\ntitle - загаловок новости, текстовое.
\nmessage - текст новости, текстовое.
\ncompanies - массив выбранных компаний, достаточно указать id.
\nroles - массив выбранных ролей, достаточно указать key.
\nsend_types - массив выбранных способов доставки, достаточно указать key. Выбираются из properties, где type=send_types
\n
\nРоль: Супервизор и выше.
\n
\nПример запроса:
\n{\n \"title\": \"Обновление функционал геозон\",\n \"message\": \"Длииное описание\",\n \"valid_to\": \"2123-12-31 22:00:00\",\n \"companies\": [\n {\"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"},\n {\"id\": \"f08a0297-05c3-42e5-b433-66cd72e72f61\"}\n ],\n \"roles\": [\n {\"key\": \"EDITOR\"},\n {\"key\": \"ADMIN\"}\n ],\n \"send_types\": [\n {\"key\": \"send_online\"},\n {\"key\": \"send_telegram\"}\n ]\n}\n\n
\n
\nОтвет:
\n{\n \"id\": \"ddee7cdc-eee0-4db2-8430-1c9620fa543f\",\n \"valid_to\": \"2123-12-31 22:00:00\",\n \"title\": \"Обновление функционал геозон\",\n \"message\": \"Длииное описание\",\n \"companies\": [\n {\n \"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"name\": \"0Одуванчик\"\n },\n {\n \"id\": \"f08a0297-05c3-42e5-b433-66cd72e72f61\",\n \"name\": \"ддддддддддааааа\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"send_online\",\n \"type\": \"send_types\",\n \"value\": \"Отобразить в интерфейсе SKIF.PRO\"\n },\n {\n \"key\": \"send_telegram\",\n \"type\": \"send_types\",\n \"value\": \"Отправить в Телеграм\"\n }\n ],\n \"roles\": [\n {\n \"key\": \"EDITOR\",\n \"value\": \"Редактор\"\n },\n {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n ]\n}\n\n
\n
\nПример ошибки:
\n{\n \"code\": 4220,\n \"field\": \"valid_to\",\n \"message\": \"Актуально до должно быть позже текущего времени\"\n}\n\n
\n","urlObject":{"path":["api_v1","news"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f5badb54-025f-4f56-b9a4-7da97d78d7ba"},{"name":"/news/list","id":"babbd792-fad6-4570-bdbc-f71c35a4e0b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"offset\": 0,\n \"max\": 20,\n \"sortField\": \"created\",\n \"sortDesc\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/news/list","description":"Получение новостей по страницам
\n
\nФильтр отправляется в теле запроса:
\noffset - номер первой строки, начинается с нуля.
\nmax - максимальные количество строк на странице.
\nsortField - поле, по которoму нужно делать сортировку (используются следующие поля - created, valid_to, title).
\nsortDesc - тип сортировки поля, если true, тогда по убыванию.
\n
\nПример запроса:
\n{\n \"offset\": 0,\n \"max\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true\n}\n\n
\n
\nПример ответа:
\nВозвращаются новости на указанной странице запроса.
\nmax_rows - количество всех записей.
\nlist - сами записи. Cтруктура записей, как в ответе на запрос POST /news, дополнительно приходит поле is_read - признак прочитанности и created - дата и время создания.
\n{\n \"max_rows\": 2,\n \"list\": [\n {\n \"id\": \"c37494d6-7141-41b3-b0d9-ff3c89fd159a\",\n \"created\": \"2023-12-05 17:49:15\",\n \"valid_to\": \"2110-12-31 22:00:00\",\n \"title\": \"Война и мир. Роман, Лев Толстой. I том\",\n \"message\": \"Действия I тома описывают события войны в союзе с Австрией против Наполеона в 1805—1807 годах. 1-я часть. Июль 1805 года, назревает война с «чудовищем» Буонапарте. Санкт-Петербург. Фрейлина вдовствующей императрицы Анна Шерер устраивает светский приём. Гости обсуждают последние события — убийство герцога Энгиенского, захват Наполеоном итальянских республик Генуи и Лукки, миссию Новосильцева по посредничеству между Францией и Англией. На приёме появляются князь Андрей Болконский со своей беременной женой Лизой, молодой Пьер, незаконный сын богатейшего графа Безухова, князь Василий Курагин со своей прекрасной дочерью Элен. Курагин жалуется Шерер на своих сыновей: беспутного Анатоля и глупого Ипполита. Обедневшая княгиня Анна Друбецкая просит князя Василия похлопотать о зачислении её единственного сына Бориса в гвардию. После приёма Пьер едет к Болконскому, тот убеждает его не участвовать в кутежах Анатоля Курагина. Однако тот всё равно отправляется к Анатолю, кутёж заканчивается печально: Пьера высылают в Москву, заводила Долохов разжалован в солдаты, дело с Анатолем замял отец.Москва. 26 августа[19], день святой Натальи) в большом доме графов Ростовых на Поварской празднуют именины графини Ростовой и её младшей дочери Наташи. Сын Ростова Николай готовится к отправке на войну, он влюблён в свою троюродную сестру бесприданницу Соню. Наташа Ростова тоже хочет любить кого-то, поэтому напрашивается на откровенный разговор с Борисом Друбецким и целует его. На праздник приезжает Пьер и Марья Дмитриевна Ахросимова — влиятельная и уважаемая дама, резкая и категоричная в своих суждениях. Граф Ростов, к восторгу всех присутствующих, танцует с Марьей Дмитриевной свой любимый танец — «Данилу Купора».Отец Пьера граф Безухов находится при смерти после нескольких ударов. Он просит князя Василия, родственника жены, привести к нему Пьера, самого любимого из своих сыновей. Князь Василий и три княжны Мамонтовы опасаются, что наследство может достаться Пьеру. Разобравшись, куда дует ветер, княгиня Друбецкая привозит ничего не подозревающего Пьера в дом графа и силком вырывает у княжны Мамонтовой портфель, где находится письмо графа к государю с просьбой признать Пьера законным сыном. Неожиданно Пьер становится графом, одним из богатейших людей России.Андрей Болконский назначен адьютантом Кутузова и уезжает на войну, мечтая прославиться, оставив Лизу в имении отца Лысые Горы. Его отец, генерал-аншеф князь Николай Андреевич Болконский, много лет безвыездно живёт в своём имении. Он отличается прямотой своих суждений, суровостью и строгостью. Он заставляет дочь княжну Марью заниматься математикой, постоянно третирует и оскорбляет её. Тем не менее набожная и некрасивая княжна любит отца и знает, что он любит её. Княжна Марья получает письмо от Жюли Карагиной, которая пишет о том, что, по слухам, князь Василий хочет женить на ней своего сына Анатоля.2-я часть. Австрия. Русская армия после длительного перехода участвует в смотре в местечке Браунау. На смотр приезжает главнокомандующий Кутузов. Он недоволен бравым видом армии, не желая видеть своих солдат пушечным мясом в замыслах австрийцев. После разгрома генерала Мака под Ульмом армии Кутузова приходится отступить к Кремсу. Кутузов посылает Болконского с посланием о первой русской победе к австрийскому императору Францу. После аудиенции Болконский узнаёт, что французы неожиданно прорвались в Вену, армия Кутузова оказывается под угрозой окружения. Несмотря на предложение дипломата Билибина ехать с ним, Болконский, уверенный что пришло его время, спешит к Кутузову. Кутузов решается идти к Цнайму на соединение с российскими силами. Он посылает четырёхтысячный отряд Багратиона к деревне Шёнграбен, где в отчаянном безнадёжном бою русские задерживают продвижение армии Мюрата. На совещании у Багратиона Болконский заступается за истинного героя сражения — капитана Тушина, чья батарея подожгла деревню в тылу французов и держалась, оказавшись в окружении. Павлоградский гусарский полк тоже участвовал в сражении, где Николай Ростов получает рану.3-я часть. Князь Василий поселяет дезориентированного новой жизнью Пьера у себя, намереваясь женить его на своей дочери. Он устраивает Пьеру назначение в камер-юнкеры. Постепенно светское общество начинает воспринимать Пьера как жениха Элен. Пьер испытывает к красавице влечение, но опасается, что женитьба на глупой Элен станет для него страшным несчастьем. В решающий момент князь Василий представляет дело так, будто Пьер уже объяснился Элен в любви, Пьеру приходится подчиниться. Он поселяется с женой в своём недавно отремонтированном дворце.Закончив дело с Элен, князь Василий с сыном Анатолем едет в имение старого князя Болконского. Старик разгадывает подлинную сущность Анатоля, но предоставляет свободу выбора своей дочери. Марья очарована красавцем офицером Анатолем, но застаёт его в зимнем саду со своей компаньонкой мадемуазелью Амалией Бурьен. Она решает поспособствовать счастью Амалии и говорит князю Василию, что никогда не станет женой его сына.Стороны стягивают силы к Аустерлицу. Император Александр, его приближённые уверены в победе над слабым противником, австрийцы, уже проводившие манёвры в этой местности, составили подробную диспозицию. Тем не менее Кутузов уверен, что битва будет проиграна, а диспозиция Вейротера хороша лишь тем, что уже высочайше одобрена и изменить в ней ничего всё равно нельзя.Болконский не спит накануне сражения, мечтая о славе. Если счастливый случай вознёс Бонапарта, то завтрашнее сражение может вознести и его. Болконский просит об этом Бога, ему не жаль ни семьи, ни богатства, ни даже жизни.На следующее утро Наполеон, в день годовщины его коронования, в счастливом расположении духа, уверенный в успехе, отдаёт приказ начинать дело. Французская армия спешит занять Праценские высоты, с которых спускается союзная армия. Вскоре сражение оказывается проигранным во всех пунктах. Кутузов замечает наступающую французскую колонну, русские войска разбегаются и он требует от Болконского остановить их. Болконский решив, что наступила долгожданная минута, подбирает знамя и увлекает батальон за собой. Вдруг Болконский чувствует удар по голове и падает. Недвижимый, он видит над собой лишь бескрайнее, бесконечное небо, а всё прежнее теряет всякое значение. Сам Бонапарт смотрит на Болконского («Вот прекрасная смерть!»), но заметив, что Болконский жив, обращается к нему с вопросами. Князь Андрей даже не трудится ответить, воспринимая своего прежнего кумира Бонапарта как ничтожество. Врач Наполеона Ларрей уверен, что Болконский не выживет, его и других безнадёжных раненых, оставляют на попечение местных жителей.\",\n \"dealer_id\": \"c5e63357-6b63-4ea4-8b91-beb53f749f69\",\n \"is_read\": false,\n \"_read\": false,\n \"companies\": [\n {\n \"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"name\": \"0Одуванчик\"\n },\n {\n \"id\": \"f08a0297-05c3-42e5-b433-66cd72e72f61\",\n \"name\": \"ддддддддддааааа\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"send_online\",\n \"type\": \"send_types\",\n \"value\": \"Отобразить в интерфейсе SKIF.PRO\"\n },\n {\n \"key\": \"send_telegram\",\n \"type\": \"send_types\",\n \"value\": \"Отправить в Телеграм\"\n }\n ],\n \"roles\": [\n {\n \"key\": \"EDITOR\",\n \"value\": \"Редактор\"\n },\n {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n ]\n },\n {\n \"id\": \"6a742db8-4c06-44bf-9f69-43a8f0f0071d\",\n \"created\": \"2023-12-05 19:19:05\",\n \"valid_to\": \"2123-12-31 22:00:00\",\n \"title\": \"Обновление функционал геозон\",\n \"message\": \"Длииное описание\",\n \"dealer_id\": \"c5e63357-6b63-4ea4-8b91-beb53f749f69\",\n \"is_read\": true,\n \"_read\": true,\n \"companies\": [\n {\n \"id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\",\n \"name\": \"0Одуванчик\"\n },\n {\n \"id\": \"f08a0297-05c3-42e5-b433-66cd72e72f61\",\n \"name\": \"ддддддддддааааа\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"send_online\",\n \"type\": \"send_types\",\n \"value\": \"Отобразить в интерфейсе SKIF.PRO\"\n },\n {\n \"key\": \"send_telegram\",\n \"type\": \"send_types\",\n \"value\": \"Отправить в Телеграм\"\n }\n ],\n \"roles\": [\n {\n \"key\": \"EDITOR\",\n \"value\": \"Редактор\"\n },\n {\n \"key\": \"ADMIN\",\n \"value\": \"Администратор\"\n }\n ]\n }\n ]\n}\n\n
\n","urlObject":{"path":["api_v1","news","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"babbd792-fad6-4570-bdbc-f71c35a4e0b0"},{"name":"/news/:id/mark_as_read","id":"3d2dd4bc-d1ec-456b-a1bf-606196fa209c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"url":"{{base_url}}/api_v1/news/:id/mark_as_read","description":"Отметить новость, как прочитанную
\n
\nПараметры запроса:
\nid - идентификатор новости.
\n
\nПример запроса:
\nPUT https://dev5.skif.pro/api_v1/news/6a742db8-4c06-44bf-9f69-43a8f0f0071d/mark_as_read\n\n
\n","urlObject":{"path":["api_v1","news",":id","mark_as_read"],"host":["{{base_url}}"],"query":[],"variable":[{"description":{"content":"ID новости
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"3d2dd4bc-d1ec-456b-a1bf-606196fa209c"}],"id":"be6304df-f621-4b15-a2c9-06a667e7cdd9","_postman_id":"be6304df-f621-4b15-a2c9-06a667e7cdd9","description":""},{"name":"Датчики","item":[{"name":"/units/sensors/add_to_units","id":"12607d3c-2a43-4dfb-90ea-de489fdd27c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"units\": [\n {\n \"id\": \"eeb057d5-3653-47d7-a2d4-18af25b51486\"\n }\n ],\n \"sensors\": [\n {\n \"id\": \"385b68de-6af9-4af7-84c3-a0028b54ef30\"\n }\n ],\n \"sensor_copy_type\": {\n \"key\": \"sensor_copy_type_merge\",\n \"type\": \"sensor_copy_type\",\n \"value\": \"Слияние\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/units/sensors/add_to_units","description":"Импортирование датчиков
\n
\nПоля:
\nunits - выбранные объекты.
\nsensors - выбранные датчики.
\nsensor_copy_type - тип импортирования датчиков. Можно получить возможные типы импортирования датчиков из dictionary, где type = sensor_copy_type.
\n
\nРоль: Редактор и выше.
\n","urlObject":{"path":["api_v1","units","sensors","add_to_units"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"12607d3c-2a43-4dfb-90ea-de489fdd27c9"}],"id":"1ba0ae4c-2deb-4baa-aee0-ecd39109b2e2","_postman_id":"1ba0ae4c-2deb-4baa-aee0-ecd39109b2e2","description":""},{"name":"Счета","item":[{"name":"/invoices","id":"a7761744-2329-4a0a-a9aa-2e8f27cc9e23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/invoices","description":"Запрос для получения счетов
\n
\nДля интеграторов для сотрудников с ролью Редактор тарифа, по которому выдаются все счета, выставленные ранее с колонками Интегратор, Дата, Сумма и ссылка на файл pdf.
\nДля сотрудника с ролью Контролер доступны для получения все счета, по всем Интеграторам.
\nДля фильтрации по дате в запросе можно указать from и to. Пример запроса:
\n\nGET /invoices?from=2024-01-01&to=2024-12-31
\n
\n
\nРоль: Редактор тарифа и выше.
\n
\nПоля в ответе:
\ndealer - интегратор.
\ndate - дата в формате yyyy-MM-dd
\nsum - сумма.
\nfile_path - ссылка на файл, можно получить файл через ссылку /api_v1/
\nПример ответа:
\n[\n {\n \"id\": \"b23fc43b-0566-478e-8598-18e83c2b0a92\",\n \"dealer\": {\n \"id\": \"f6a2a3fa-930b-4045-8731-3592b466d48f\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"date\": \"2024-05-01\",\n \"file_path\": \"/files/dealers_invoice/f6a2a3fa-930b-4045-8731-3592b466d48f/2024-05-01_invoice_7032506.pdf\",\n \"sum\": 350000\n },\n {\n \"id\": \"21d20961-ad09-4322-abfb-7b34bce74a1e\",\n \"dealer\": {\n \"id\": \"f6a2a3fa-930b-4045-8731-3592b466d48f\",\n \"name\": \"Мониторинг Плюс Москва\"\n },\n \"date\": \"2024-04-01\",\n \"file_path\": \"/files/dealers_invoice/f6a2a3fa-930b-4045-8731-3592b466d48f/2024-04-01_invoice_2368165.pdf\",\n \"sum\": 340000\n }\n]\n\n
","urlObject":{"path":["api_v1","invoices"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a7761744-2329-4a0a-a9aa-2e8f27cc9e23"}],"id":"100bd35b-8d35-4cd2-8d27-b5fd7dbdc672","_postman_id":"100bd35b-8d35-4cd2-8d27-b5fd7dbdc672","description":""},{"name":"Инструменты","item":[{"name":"/tools/loadwln?table=&imei=","id":"e286ce27-41b5-461a-90f1-0992d62505fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"file","file":{"src":"/home/azat/Downloads/862273040898231.wln.zip"}},"url":"{{base_url}}/api_v1/tools/loadwln?table=&imei=","description":"Загрузка истории по объектам
\n
\nПараметры запроса:
\ntable - ключ протокола передачи данных объекта (terminal_type_key)
\nimei - IMEI объекта.
\n
\nПример запроса:
\nPOST https://dev5.skif.pro/api_v1/tools/loadwln?table=navtelecom&imei=85433234354343
\nВ теле запроса для загрузки принимаются только один файл архива в формате zip, в котором находится файл выгрузки истории из Wialon в формате wln.
\nВ ответе возвращается 200, если загружено успешно или статус для ошибки.
\nТело ответа содержит текст в формате text/plain.
\n","urlObject":{"path":["api_v1","tools","loadwln"],"host":["{{base_url}}"],"query":[{"description":{"content":"Ключ протокола передачи данных объекта
\n","type":"text/plain"},"key":"table","value":""},{"description":{"content":"IMEI объекта
\n","type":"text/plain"},"key":"imei","value":""}],"variable":[]}},"response":[],"_postman_id":"e286ce27-41b5-461a-90f1-0992d62505fe"}],"id":"bb99ee1b-48c3-438d-adc4-61ec2e9720cf","_postman_id":"bb99ee1b-48c3-438d-adc4-61ec2e9720cf","description":""},{"name":"Выгрузка данных","item":[{"name":"/tools/exportwln_multiple","id":"82b45d70-14b2-4488-aeb4-e1d84c4d4674","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"objects\": [\n {\n \"table\": \"novacom\",\n \"imei\": \"863591026316285\"\n },\n {\n \"table\": \"novacom\",\n \"imei\": \"863591026336465\"\n }\n ],\n \"from\" : \"2024-10-24\",\n \"to\": \"2024-10-25\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/tools/exportwln_multiple","description":"Экспортирование множества объектов
\n
\nПример запроса:
\nPOST https://admin-dev.skif.pro/api_v1/tools/exportwln_multiple
\nВозвращает zip файл с необходимыми объектами в формате .wln
\n","urlObject":{"path":["api_v1","tools","exportwln_multiple"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"82b45d70-14b2-4488-aeb4-e1d84c4d4674"},{"name":"/tools/exportwln","id":"40925f45-1419-4aba-867d-24bd472ec85e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/api_v1/tools/exportwln?table=novacom&imei=123&from=2024-10-24&to=2024-10-25","description":"Метод для экспортирования объекта
\n
\nПример:
\n\nВозвращает .wln файл с необходимым объектом
\n","urlObject":{"path":["api_v1","tools","exportwln"],"host":["{{base_url}}"],"query":[{"key":"table","value":"novacom"},{"key":"imei","value":"123"},{"key":"from","value":"2024-10-24"},{"key":"to","value":"2024-10-25"}],"variable":[]}},"response":[],"_postman_id":"40925f45-1419-4aba-867d-24bd472ec85e"}],"id":"ea0b1ccb-9952-48cf-b798-77da66793bb2","_postman_id":"ea0b1ccb-9952-48cf-b798-77da66793bb2","description":""},{"name":"Support","item":[{"name":"/support_key","id":"2af456f5-6327-4efe-8929-69ab35b0e354","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/api_v1/support_key","description":"Запрос на получение API-ключа для HelpDeskEddy.
\nВозвращает ответ JSON со статусом 200 или ошибкой в случае ошибки.
\nПоля ответа:
\nuser_id - ID пользователя в SKIF.PRO, uuid
\nhelpdesk_user_id - ID пользователя в HelpDeskEddy
\nhelpdesk_api_key - API key для HelpDeskEddy
\nПример ответа:
\n{\n \"user_id\": \"0179f5d4-a7b0-4bb3-b499-54825ecba753\",\n \"helpdesk_user_id\": 30,\n \"helpdesk_api_key\": \"ee914ca2-19dc-4b99-af58-08a9863a1a31\"\n}\n\n
\n","urlObject":{"path":["api_v1","support_key"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2af456f5-6327-4efe-8929-69ab35b0e354"},{"name":"/support_hook","id":"14ce5845-8b13-42d8-83b0-8b7c1cfe062a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"ticket_id\": \"27\",\n \"user_id\": \"30\", //id клиента в helpdesck\n \"ticket_name\": \"Тема обращения\",\n \"answer\": \"текст ответа\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api_v1/support_hook","description":"для получения webhook запросов от helpdesckeddy. Требуется API key отправить в хедере
\nПоля JSON запроса:
\n{\n \"ticket_id\": \"27\",\n \"user_id\": \"5\", //id клиента в helpdesck\n \"ticket_name\": \"Тема обращения\",\n \"answer\": \"текст ответа\"\n}\n\n
По результату активному пользователю (подключен к нам по websocket) отправляется websocket-сообщение и всегда отправлять push уведомление в следующем формате:
\n{\n \"thread-id\": \"ID company\",\n \"alert\": {\n \"title\": \"Title\",\n \"body\": \"message\"\n },\n \"type\": \"support\",\n \"ticket_id\": \"27\",\n \"ticket_name\": \"Тема обращения\",\n \"answer\": \"текст ответа\"\n} \n\n
\n","urlObject":{"path":["api_v1","support_hook"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"14ce5845-8b13-42d8-83b0-8b7c1cfe062a"}],"id":"bbbefe61-eb48-4a80-ba1f-a5b22b7b2620","_postman_id":"bbbefe61-eb48-4a80-ba1f-a5b22b7b2620","description":""}],"variable":[{"id":"b590179b-df0b-4571-b304-69eab2ead739","key":"email","value":"test1@ya.ru"},{"id":"90880db0-3006-4a34-ae8d-6aab46489089","key":"password","value":"12345N"},{"id":"e88e4d3f-0c48-46a8-8807-de5ee29401fe","key":"phone","value":"+71111111111"}]}