{ "item": [ { "name": "Авторизация", "description": "", "item": [ { "id": "ecb750a8-7741-4021-b958-8bc6bf9439fa", "name": "/registrate", "request": { "name": "/registrate", "description": { "content": "**Используется для регистрации нового пользователя в системе.**\n\n---\n\nРегистрирует пользователя с указанным email (параметр user_provider_id) и создает новую компанию, в которой пользователь становится администратором (роль Admin).\n\nНа указанный email отправляется ссылка для подтвержения аккаунта.\n\nПользователь сразу логинится в системе (создается сессия) и может выполнять любые запросы, требующие авторизации.\n\n---\n\n**Параметры:**\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\": \"user@example.com\",\n \"type\": \"EMAIL\",\n \"company_name\": \"BigBin\",\n \"password\": \"your_secure_password\",\n \"name\": \"Имя пользователя\",\n \"timezone\": {\n \"key\": \"UTC+3\"\n },\n \"language\": {\n \"key\": \"ru\"\n }\n}\n\n ```\n\n**Параметры ответа:**\n\nКод 200 и пустой body в случае успеха.\n\nЕсли уже есть аккаунт (см. /approve) с таким email, то возращается Код 422 и body c ошибкой session.errors.emailAlreadyRegistered\n\nВ случае частого вызова метода (чаще чем раз в 30 секунд), то возращается Код 400 и body validation.errors.often", "type": "text/plain" }, "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "befba6ae-ed17-4076-861e-490a0d376b69", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7368cda3-6cb1-43ef-8c5f-d37dd609cb5b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7af0a222-d51d-427a-a34b-0fc56cecf5c3", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d689538-048a-47d6-9727-a452bfa3edcb", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b36f871-c4e9-4cc9-a34d-9634776d2bc4", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60451f7b-16a5-459c-81c5-a3698e58bc4f", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "registrate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"invite_id\": \"\",\n \"language\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"password\": \"\",\n \"timezone\": {\n \"key\": \"\"\n },\n \"type\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "57aa394b-76c9-49d2-b1b5-3c5c3f9a22a4", "name": "/login", "request": { "name": "/login", "description": { "content": "**Авторизация пользователя с помощью email**\n\n---\n\nПроверяет корректность связки email и пароля для авторизации пользователя. Если авторизация проходит успешно, то в cookies помещается id сессии пользователя, которая используется для авторизации дальнейших вызовов функции API под авторизованным пользователем. В случае если пользователь заходит по временному паролю (присланному при восстановлении пароля или вторичной регистрации по уже зарегистрированному телефону), то временный пароль становится постоянным.\n\n---\n\n**Параметры:**\n\n\"userProviderId\" - email (обязательный) или логин \n\"provider_key\" - костанта \"TEXT\" (обязательный) \n\"password\" - пароль (обязательный)\n\n\"is_admin_panel\" - true отправляется при входе в админ-панель\n\nВ поле password необходимо указать пароль, полученный при регистрации по смс (или email при тестовом режиме)\n\n```\n{\n \"userProviderId\": \"user@example.com\", (обязательный)\n \"provider_key\": \"EMAIL\", (обязательный)\n \"password\": \"your_secure_password\" (обязательный)\n}\n\n ```\n\n---\n\n**Параметры ответа:**\n\nВ случае успешной авторизации возвращается пустой body с кодом 200.\n\nВ случае не успешной авторизации возвращается status: 422 и json-body с ошибкой.", "type": "text/plain" }, "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a1c12b2c-6dd8-41fc-a684-b68641ef1d8b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "21407773-374d-4a7c-b1f0-3cb31cc2431a", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14b1c05b-c181-4716-9385-815c9e285159", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3de45d8a-e3d3-4966-a74a-67e5817d3918", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "174c54de-f439-4ad7-98cc-5306bf09f28c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fed3c01-ec5f-4f38-8640-98f209863a08", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"password\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2c4fa99-e222-420a-a823-968229f72c26", "name": "/recovery", "request": { "name": "/recovery", "description": { "content": "**Восстановление пароля**\n\n---\n\nМетод создает временный пароль для существующего пользователя. Новый пароль отправляется на указанный email. В тестовой среде отправляет письмо на отладочные почтовые ящики.\n\n---\n\n**Параметры:**\n\n```\nuser_provider_id - телефон пользователя (обязательный)\ntype - константа, всегда \"EMAIL\" (обязательный)\n{\n \"user_provider_id\": \"user@example.com\",\n \"type\": \"EMAIL\"\n}\n\n ```\n\n---\n\n**Параметры ответа:**\n\nКод 200. Даже если пользователь с указанным паролем не существует.\n\n```\n{\n \"pssword\": \"\"\n}\n\n ```\n\nОшибка валидации - код 422, с перечнем ошибок в полях\n\n```\n{\n \"errors\": [\n {\n \"code\": 4221,\n \"field\": \"password\",\n \"message\": \"Отсутствует параметр\"\n }\n ],\n \"code\": 4220, //общий код ошибки\n \"message\": \"Отсутствует параметр\" // частный\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "408eb25d-b9b6-47eb-b615-743f8c5873a7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2f4593fa-d4b3-4765-b155-4be0abeae5da", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffd8ea0d-c6cb-4358-936e-a0f8145a2bda", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca70e29c-55a2-4211-a9dc-7aa86e7e58c6", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19879703-23db-4b1f-9140-7a6f33c0c546", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "977c8eb9-9313-40c6-98f9-80d06096c136", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "recovery" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"user_provider_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "75fa5dc1-560f-4bd0-98ff-5190adbb310b", "name": "/recovery/qr/:user_id", "request": { "name": "/recovery/qr/:user_id", "description": { "content": "**Вход через qr**\n\n---\n\nМетод создает временный пароль для существующего пользователя. По ссылке auth.recovery_url можно получить сессию и сменить пароль. Так же, если для пользователя настроен vpn, его парамеры будут возвращены в теге vpn\n\nПараметры:\n\nuser_id - id пользователя (обязательный)\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Параметры ответа:**\n\nКод 200. Даже если пользователь с указанным паролем не существует. Ответ всегда такого вида\n\n```\n{\n \"vpn\": {\n \"privateKey\": \"EXAMPLE_WIREGUARD_PRIVATE_KEY_BASE64=\",\n \"address\": \"10.8.0.4/23\",\n \"dns\": \"8.8.8.8\",\n \"publicKey\": \"EXAMPLE_WIREGUARD_PUBLIC_KEY_BASE64=\",\n \"allowedIPs\": \"0.0.0.0/0\",\n \"endpoint\": \"vpn.skif.pro:51820\",\n \"persistentKeepalive\": \"20\"\n },\n \"auth\": {\n \"recovery_url\": \"https://api.skif.pro/recovery/75c93998-f410-4e4a-a470-722940f10946\"\n }\n}\n\n ```\n\nОшибка валидации - код 422, с перечнем ошибок в полях\n\n```\n{\n \"errors\": [\n {\n \"code\": 4221,\n \"field\": \"\",\n \"message\": \"Отсутствует параметр\"\n }\n ],\n \"code\": 4220, //общий код ошибки\n \"message\": \"Отсутствует параметр\" // частный\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2d4ef6fa-51a1-4b08-b4fb-2aadfe02e311", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1cb636a0-4ee3-4e7a-931a-9aa3bab0c11b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1aba27fb-5ae4-4324-bcdc-0ee22066c8b9", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3de3024-862f-4aa9-ab20-fac97b8805ce", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72f20a6e-a213-4739-adfd-b7507df9b10a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1c17cfc-a135-4970-b174-aacbe4ca03f2", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", "qr", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для генерации QR восстановления", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "33c7edb8-21a2-4928-8d4a-b0c4fec05aab", "name": "/logout", "request": { "name": "/logout", "description": { "content": "**Выход из учетной записи**\n\n---\n\nУдаляет все сессии пользователя на сервере.\n\n---\n\n**Параметры:** пусто\n\n---\n\n**Ответ**: 200", "type": "text/plain" }, "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a9d37321-c91a-4644-a6a9-05b1d758db36", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "37923126-c760-4f08-8d74-52039fc004f4", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75c0dd08-5405-4f01-aea2-569f0f75a6ec", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "146b1eca-1d74-4dcf-86b0-129bcfa79fe1", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01cccdb3-a190-43b3-bf11-8d196f45205c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abc2c48b-0825-410f-91c3-60b11786fdac", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "671aa74c-0e37-47bb-99d9-22380dfb9c50", "name": "/reset_password/:user_id", "request": { "name": "/reset_password/:user_id", "description": { "content": "**Сбросить пароль пользователя администратором (только администратор)**\n\n---\n\nУстановить новый временный пароль для пользователя. После чего пользователь должен изменить пароль после входа.\n\n---\n\n**Параметры:**\n\nuser_id - ID пользователя \nnewPassword - новый пароль\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nОтвет: Пустой 200. Новый пароль установлен или ошибка\n\n---\n\nПример запроса:\n\n``` json\n{\n \"newPassword\": \"your_secure_password\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "48e8db32-e565-4354-9965-af3a36715713", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b49550bf-0ca3-4ca7-9b54-42d87c484275", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9925f4ec-c8ba-419a-b571-ac59711145a1", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bd86289-5f68-4443-ad00-3e4e0e2e7ef0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5072304-3771-4652-921f-f57e3cd959eb", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49964f68-c1e7-484f-afe4-fb8968800d11", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "reset_password", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя, которому сбрасывается пароль", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"newPassword\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "beffae24-05e8-464e-99c8-63c9142f987f", "name": "/change_my_password", "request": { "name": "/change_my_password", "description": { "content": "**Изменить свой пароль пользователем**\n\n---\n\nУстановить новый пароль пользователя для себя.\n\n---\n\n**Параметры:**\n\npassword - текущий пароль \nnewPassword - новый пароль\n\n---\n\nОтвет: Пустой 200 новый пароль установлен или ошибка\n\n---\n\n**Пример запроса:**\n\n``` json\n{\n \"password\": \"your_secure_password\",\n \"newPassword\": \"your_secure_password\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2070d1a4-373c-42a6-9bd2-61a4528495eb", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "16912f6a-3c22-461a-a54e-bd91e1805f0b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25a8fd5b-88d9-4996-91ac-4dd8a601a79c", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9878055-4ab3-4b9f-8dd1-6c67a30323cc", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f563229-538d-4cec-b9bc-05120f76b38c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf22b929-44c1-4482-874d-6e20b6390c16", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "change_my_password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ef4cdba2-0328-4b18-9583-cefc77fd0dc9", "name": "/approve/:id", "request": { "name": "/approve/:id", "description": { "content": "**Подтверждение email. Используется для подтверждения email по ссылке полученной на почту.**\n\n---\n\nДелает email подтвержденным, после чего зарегистироваться с таким email уже не возможно. \nПользователь сразу авторизуется в системе без ввода email и пароля.\n\nСоздается временный id помещенный в redis со временем жизни 30 мин\n\n---\n\n**Параметры:**\n\nid - временный id связанный с email\n\n---\n\n**Ответ:**\n\nВозвращает код 200 с пустым body\n\nВозвращает код 422 в случае если id не валидно\n\n``` json\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "31537f7a-e58d-4871-af87-28a9a3dd79a2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b38fd6d3-e7af-4700-a848-6a0e716f9da8", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41499d19-f5c6-4412-9757-384e06de7833", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5bad59e5-a373-4368-8214-4354e4cfb948", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b12fc8d-a75a-45ba-854c-c6657a02a290", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "070669f9-58ed-4114-8e25-03c27739e749", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "approve", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор подтверждения учетной записи", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "13e4bf0d-614e-44ee-b841-ade775f91beb", "name": "/company/invite/:id", "request": { "name": "/company/invite/:id", "description": { "content": "**Авторизация по приглашению. Используется для получения доступа к компании по ссылке, полученной на почте.**\n\n---\n\nСоздает пользователя, если он не был ранее зарегистрирован и дает доступ к компании из которой Администратор вызвал метод POST /invite \nПользователь сразу авторизуется в системе без ввода email и пароля под приглашенной Компанией.\n\n---\n\n**Пример запроса:**\n\nСоздается временный id помещенный в redis со временем жизни 30 мин.\n\nid связан с email и компанией, в которую приглашают пользователя (оба значения можно помещать в качестве значения в redis)\n\n**Параметры:**\n\nid - временный id связанный с email и Компанией в которую приглашают пользователя\n\n---\n\n**Ответ:**\n\nВозвращает код 200 с пустым body\n\nВозвращает код 422 в случае если id не валидно\n\n``` json\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ba338432-5bbb-439f-b717-1af7b3a4dd64", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "aea63e79-39b5-4e42-90d9-8f51a5541306", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b80fb29f-21a6-455a-b145-69c368b719f9", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7160cffa-1b56-496c-9b4e-8797236989d9", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56f1e8ed-00a3-4b88-a475-88bfe435c42a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "313b5b9b-e52d-45e4-8064-97490e7570ef", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Токен / ID ссылки приглашения в компанию", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "525250a8-3939-4c33-b3a2-bf4b9638331b", "name": "/recovery/:id", "request": { "name": "/recovery/:id", "description": { "content": "**Авторизация по ссылке восстановления, полученной по почте. Используется для авторизации пользователя в системе для последующей смены пароля.**\n\n---\n\nПользователь сразу авторизуется в системе без ввода email и пароля. При этом если у пользователя доступ к нескольким компаниям, то предлагается выбор Компании, в которую пользователь хочет войти через метод GET switchcompany/:id\n\n---\n\n**Пример запроса:**\n\nСоздается временный id, помещенный в redis со временем жизни 30 мин. id связан с email\n\n**Параметры:**\n\nid - временный id связанный с email\n\n---\n\n**Ответ:**\n\nВозвращает код 200 с пустым body\n\nВозвращает код 422 в случае, если id не валидно\n\n``` json\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Ссылка устарела, повторите операцию\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3cabdb49-9d93-4aa3-9f50-32e28d8a612c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "97a349cb-5934-4fca-8f52-4ff1d30c68b7", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5fe6fd4-1352-461a-8224-a218c0862296", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13e53a0c-11cf-4e80-892a-e5d2b73c455d", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4123fa8e-b37d-4b76-a60f-8e2b488f55b7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a0fcbe6-1846-4b77-8f7b-391369f6fb4b", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "recovery", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ссылки восстановления пароля из email", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ce535a6e-7e63-42ea-aa7d-066c714dfe2e", "name": "/captcha", "request": { "name": "/captcha", "description": { "content": "Для регистрации необходимо передать код с картинки, получаемый из этого метода в поле captcha", "type": "text/plain" }, "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "951fdc57-ea5a-490f-863e-1895dfa8ae15", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6c7b3d15-9fed-4307-8f4d-4b1cf85efaa1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "878ec636-e0e2-4634-b1eb-faf6b960fe60", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "581bfdbb-b732-4808-a531-e6519b98b4c0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bc5e18c-847e-48fb-bc70-0bddeeca37d0", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ceeefdd8-af36-4782-b19c-b466c004980d", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "captcha" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "699239ba-71ff-434e-ac59-8bb197a2f2ac", "name": "/ask_approve_code", "request": { "name": "/ask_approve_code", "description": { "content": "**Запрос получения кода**\n\n---\n\n**Параметры:** \nprovider_key: text, для подтверждения номером телефона (пока только так) provider_key = PHONE \nuserProviderId - text, номер телефона если provider_key = PHONE\n\n**Пример запроса:**\n\n``` json\n{\n \"userProviderId\": \"+7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\"\n}\n\n ```\n\nВ ответ приходит 200, если запрос правильный, иначе ошибка", "type": "text/plain" }, "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c3ddc047-662d-4c79-b189-8d998aeeca50", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4e18fa66-3076-4b4b-a41f-ba61b0cc63fa", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ac363a9-14d0-4953-b1b1-b6c823fa546d", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7aad761d-d5ee-4b90-b7a0-f5f1dae4490b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22a7d345-4fc0-4ced-832c-1e7415c41a40", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bc26fb9-5926-4559-bddc-ebe5321482bb", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3d029c1b-47ea-4786-9a36-e03a219fa61d", "name": "/ask_approve_code_voice", "request": { "name": "/ask_approve_code_voice", "description": { "content": "**Запрос получения кода через звонок**\n\n---\n\n**Параметры:** \nprovider_key: text, для подтверждения номером телефона, provider_key = PHONE \nuserProviderId - text, номер телефона, если provider_key = PHONE\n\n**Пример запроса:**\n\n```\n{\n \"userProviderId\": \"+7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\"\n}\n\n ```\n\nВ ответ приходит 200, если запрос правильный, иначе ошибка", "type": "text/plain" }, "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f8185956-85b1-4d6b-b00f-7581e32b6820", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3e84b3e3-385b-4424-a8ce-3b0c04b657c6", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d89a3233-49a7-4bac-a15b-6156e2c23eda", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9950a95-e5c1-4c5b-8848-61056ef5c7de", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19dfbad7-f6fa-4898-b9a6-a98e621821a6", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a52a7e24-9d72-41f1-ab23-afeff9b91be1", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve_code_voice" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dcc418d2-b4e8-409b-a442-00f1a9101472", "name": "/approve_code", "request": { "name": "/approve_code", "description": { "content": "**Подтверждение аккаунта с помощью кода**\n\n---\n\n**Параметры:** \nprovider_key: text, ддля подтверждения номером телефона(пока только так) provider_key = PHONE \nuserProviderId - text, номер телефона если provider_key = PHONE \ncode: text, полученный код\n\n\n**Пример запроса:**\n\n```\n{\n \"userProviderId\": \"7XXXXXXXXXX\",\n \"provider_key\": \"PHONE\",\n \"code\": \"27280\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "567ffc04-de73-43b1-848b-0643cdb10e82", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4b7e7964-49e4-4ace-92c7-84ba69ac0220", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57024313-869d-44ce-8259-19c5c230a0b9", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f68c9797-64a5-4a27-93d2-e14ca485963c", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a6687e6-8207-49bc-b9ce-6170f6643ced", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "659e68d3-411d-4689-aae4-56980a07fe48", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "approve_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"provider_key\": \"\",\n \"userProviderId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Пользователь", "description": "", "item": [ { "id": "cdc632a2-19aa-43e9-b99b-e144943474a3", "name": "/me", "request": { "name": "/me", "description": { "content": "**Получить информацию о текущем пользователе**\n\n---\n\nМетод выдает информацию по текущему пользователю\n\n---\n\n**Роль:** Наблюдатель и выше.\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\": \"user@example.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\" : \"+79990000001\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "dc0d33fb-7fc7-411e-9c78-ad64a6d57bfa", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "96690ff8-6c9b-4653-9b57-303305fbacd9", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20152470-6b27-43cb-8693-10882bd73b51", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1ca4a23-1f6e-4374-b2e1-022f0eaa4cd8", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdf5841d-23bb-4a7c-93f9-1a867b3a70d9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efbfa141-8935-4247-afd1-b5da3db8bf81", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "865470fb-4eb0-4137-96a8-e20e4c7efe9a", "name": "/me", "request": { "name": "/me", "description": { "content": "**Обновить данные текущего пользователя**\n\n---\n\nОбновляет те поля, которые содержатся в запросе. Поля отсутствующие в запросе, не обновляются.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"name\": \"Иван Иванов\", // имя\n}\n\n ```\n\n**Параметры:**\n\n```\n{\n \"role\": {\"key\": \"Editor\", \"value\": \"Редактор\"}, // не доступно для изменения самому пользователю\n \"password\": \"your_secure_password\" //новый пароль\n \"name\": \"Иван Иванов\", //имя\n \"is_driver\": true // делает пользователя водителем\n \"email\": \"user@example.com\", //email\n \"code\": \"092384\", // id пользователя (rfid), доступно для пользователя с ролью Editor\n \"language\" : {\"key\":\"en\"} //язык пользователя\n \"phone\" : \"+79990000001\" //телефон пользователя\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\n---\n\n**Ответ:**\n\nВозвращает обновленную запись пользователя см. GET /me", "type": "text/plain" }, "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ea656d5b-7b2d-43db-8c7f-9527e817ba12", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4642312b-ead4-41cd-91ef-31d3c9f419f8", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "811b3669-0503-4574-a84f-c3694537a390", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f40cf811-f949-4b28-9261-0bf95756ea8f", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a912c48-bc93-4ae5-be74-3edc9a7ab41c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af56d3cf-f39e-462a-9789-ccee78c0f166", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"age\": \"\",\n \"name\": \"\",\n \"town\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "755cc2c8-6f2e-4d2f-a609-933181c78cd5", "name": "/users?ids=:ids", "request": { "name": "/users?ids=:ids", "description": { "content": "**Получить информацию о текущем пользователе по его id**\n\n---\n\nВозвращает данные по пользователям переданных id. Возвращаются только те пользователи, у которых есть доступ к текущей компании пользователя, который делает запрос.\n\n---\n\n**Параметры:**\n\nids - может содержать как один id пользователя, так и несколько, разделенных через запятую.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Ответ:**\n\nМассив объектов пользователей, каждый объект которого аналогичен возвращаемому через метод GET /me", "type": "text/plain" }, "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e8622d28-c393-4448-9f25-8d778e1fc457", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "74f4f197-e1f8-4c19-b5d7-58903ba59438", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "297f5f9e-7c93-4a2c-b264-b124bfd6b9c5", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b0a0d9e-a981-497a-8ddc-8e3edbef2bae", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "710625b0-55c3-4a8a-92dd-2572f4f21354", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "483d7618-e366-4114-bf76-172c96163f87", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d915df2f-1a95-4945-bdae-47e8d923622d", "name": "/users?ids=:ids", "request": { "name": "/users?ids=:ids", "description": { "content": "**Планирование удаления пользователей по их ID**\n\n---\n\nЛогика использования, как в DELETE /company/users?ids=:ids \nПользователь с ролью SUPERVISOR может удалять других пользователей.\n\n---\n\n**Роль:** Администратор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9122230a-fb9f-4d24-9c3a-edc5f41726d4", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c669f422-b55c-43a4-bd56-efa8fb87125c", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f4362a5-e166-4d97-b061-cfd66082a616", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d072ed95-8654-4d84-a616-875cdbe897ee", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d080f8c-7bd1-4a2f-a128-4817a13f1220", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38095be7-d188-4680-8797-d3c7adeb7e06", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b8e0924-f87c-49f3-a8a4-5b800d240a6f", "name": "Создание пользователя или водителя", "request": { "name": "Создание пользователя или водителя", "description": { "content": "**Создание пользователя или водителя**\n\n---\n\nСоздает пользователя в активной компании без приглашения.\n\nЭкспресс-создание водителя. Если переданы `is_driver: true`, пустой `email`, роль не передана или равна `NO_ACCESS`, а `use_name_as_login` не равен `true`, система сама генерирует технический email вида `driver_@nomail.skif.pro` (`` — 10 случайных шестнадцатеричных символов), случайный пароль и назначает роль «Без доступа». Письмо о создании аккаунта не отправляется.\n\nПользователь по логину и паролю. Если передан `use_name_as_login: true`, в `name` передается логин. Email необязателен: если он не указан, генерируется технический адрес `@nomail.skif.pro`. Логин уникален во всей системе.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Параметры:**\n- name: string - имя (ФИО), при `use_name_as_login: true` — логин. Обязательно.\n- email: string - email для входа. Обязательно, кроме случаев `use_name_as_login: true` и экспресс-создания водителя.\n- password: string - пароль. Необязательно. Проверяется по парольной политике компании. При экспресс-создании водителя игнорируется.\n- use_name_as_login: boolean - вход по `name` вместо email. Необязательно.\n- is_driver: boolean - признак водителя. Необязательно. По умолчанию `false`.\n- role: object - роль пользователя. Необязательно. По умолчанию роль «Без доступа» (`NO_ACCESS`).\n - id: string (UUID) - идентификатор роли, список ролей — `GET /roles`. Необязательно, если указан key.\n - key: string - ключ роли. Необязательно, если указан id. Возможные значения: `NO_ACCESS`, `OBSERVER`, `READER`, `OPERATOR`, `EDITOR`, `ADMIN`.\n- code: number - код водителя (ключ, RFID) для автоназначения. Необязательно. Только цифры. У водителя код должен быть уникален в компании.\n- phone: string - телефон. Необязательно. Уникален в системе.\n- lang: object - язык пользователя. Необязательно. По умолчанию — язык платформы по умолчанию (на SKIF.PRO — `ru`).\n - key: string - ключ языка. Возможные значения: `ru`, `en`, `kz`, `fr`, `bg`.\n- details: string - примечание. Необязательно.\n- telegram_chat_id: number - id чата Telegram для рассылок, получается из бота. Необязательно.\n- properties: object - дополнительные свойства пользователя. Необязательно.\n\n---\n\n**Пример запроса:**\nЭкспресс-создание водителя\n\n```\n{\n \"name\": \"Петров Петр Петрович\",\n \"is_driver\": true,\n \"phone\": \"+79990000001\",\n \"code\": 777\n}\n```\n\nПользователь по логину и паролю\n\n```\n{\n \"name\": \"dispatcher_1\",\n \"password\": \"Passw0rd!\",\n \"use_name_as_login\": true,\n \"role\": {\"key\": \"OBSERVER\"}\n}\n```\n\n---\n\n**Ответ:**\nСозданный пользователь, объект аналогичен `GET /me`.\n\n```\n{\n \"id\": \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"name\": \"Петров Петр Петрович\",\n \"email\": \"driver_a3f09c21b7@nomail.skif.pro\",\n \"phone\": \"+79990000001\",\n \"code\": 777,\n \"details\": \"\",\n \"is_driver\": true,\n \"use_name_as_login\": null,\n \"telegram_chat_id\": null,\n \"lang\": {\"key\": \"ru\"},\n \"role\": {\"id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"key\": \"NO_ACCESS\", \"value\": \"Без доступа\"}\n}\n```\n\nКод 422:\n- пустое `name`;\n- неверный email или email, телефон, логин уже заняты;\n- пароль не соответствует политике компании;\n- код водителя уже есть в компании (`validation.errors.driverCodeAlreadyExists`).\n", "type": "text/plain" }, "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "74911623-8be1-4fb4-8e0c-b31090c5b47c", "name": "Созданный пользователь, объект аналогичен GET /me", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25f33118-dadb-4c0a-aa27-c81f6ed3cecc", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f73236d5-0834-4fba-be72-2e9f624d71ea", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbfb31b3-ec5d-4996-a732-02c2f538167b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0ccbf90-aa8a-4c77-a841-99e91c659188", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b5bd674-e9d9-4e9c-a988-aedec3c5f76f", "name": "Превышен лимит частоты запросов", "originalRequest": { "url": { "path": [ "api_v1", "users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"use_name_as_login\": \"\",\n \"is_driver\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"OPERATOR\"\n },\n \"code\": \"\",\n \"phone\": \"\",\n \"lang\": {\n \"key\": \"ru\"\n },\n \"details\": \"\",\n \"telegram_chat_id\": \"\",\n \"properties\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8d84dc3c-a9ae-4bd8-bb35-4855cbf0e35b", "name": "/users/:id", "request": { "name": "/users/:id", "description": { "content": "**Обновить информацию о текущем пользователе по его id.**\n\n---\n\nОбновление пользователя по его id. Пользователь с ролями User, Provider, Executor может менять только себя.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПараметры и ответ аналогичны методу POST /users", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "39a57cb6-0e35-4933-aca8-68bf7d731f52", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b521da75-3025-4721-9afa-c1f1a6513c12", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b874b2b-4aab-4f83-9429-dd7037f83dea", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "158e967d-1dd2-4016-8d9f-8cb850b2cf0d", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbc49088-1dbd-4073-9d03-9f25a5c9fe25", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2562c89-9623-47e4-b422-7546e695a4a5", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f6d17452-c67b-4c01-a8a9-5991c9238b71", "name": "/users/:id/check_use_name_as_login", "request": { "name": "/users/:id/check_use_name_as_login", "description": { "content": "**Обновить информацию о текущем пользователе по его id.**\n\n---\n\nРоут для проверки уникальности строки Имя пользователя для использования в качестве логина\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПример запроса:\n\n``` json\n{\"name\": \"Иванов Иван Иванович\"}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "40be88c5-a7f9-4ef2-829d-6274a3a66123", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "87fcd4c6-107f-41ff-9898-4b9a9c2df9f1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2967716-8dc9-4031-ba4b-4248dfb6b578", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bc1b1c3-68bc-47c1-b2ef-6fb957b49435", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50ff2d7f-7ccd-41b1-b4bf-90303def8b9f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc1788f0-c49b-4555-89ff-443107a69f95", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e2d7eb9-ba5d-47d1-9a5a-f10e943a199c", "name": "/users/:id", "request": { "name": "/users/:id", "description": { "content": "**Удаление пользователя по его id**\n\n---\n\n**Роль:** Администратор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b611f90b-6a12-48f0-8fb4-fc08c2dcd40c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "561dbd9a-bb05-4735-b23e-02bd0afd9ee1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "161fa8d6-dfbb-4baf-8d0b-eb73c8d216bf", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22da68e6-1abb-47e4-b80b-8ca4369a92c1", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea82882c-756e-452f-a0dc-8c55604d031c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9217bd1b-0386-41dc-9eb4-4670c65e4105", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":user_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр пути user_id", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"transport\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bcaae4ee-52a9-4ee0-bd62-0e67a3c90cd5", "name": "Получение списка пользователей по фильтру", "request": { "name": "Получение списка пользователей по фильтру", "description": { "content": "**Получение списка пользователей по фильтру**\n\n---\n\nВозвращает пользователей активной компании с фильтрацией, сортировкой и постраничным выводом. Пользователи с ролью выше, чем у запрашивающего, не возвращаются.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Параметры:**\n- from: integer - с какой строки возвращать список, 0 — первая. Необязательно.\n- limit: integer - сколько строк возвращать, 0 — все. Необязательно.\n- fields: array of string - поля, которые нужно включить в результат, например `[\"id\", \"name\"]`. Необязательно.\n- sortField: string - поле сортировки. Необязательно. Возможные значения: `name`, `code`, `details`, `role.key`, `email`, `phone`.\n- sortDesc: boolean - сортировка по убыванию. Необязательно.\n- value: string - подстрока для поиска по полям `name`, `code`, `details`, `role.key`, `email`, `phone`. Необязательно.\n- is_driver: boolean - `true` — только водители, `false` — только не водители. Необязательно. Если не передан, возвращаются все.\n- role_keys: array of string - вернуть только пользователей с этими ролями. Необязательно. Возможные значения: ключи ролей, например `OBSERVER`, `ADMIN`, `NO_ACCESS`.\n- exclude_role_keys: array of string - исключить пользователей с этими ролями. Необязательно. Возможные значения аналогичны `role_keys`.\n- with_last_login: boolean - добавить каждому пользователю в `list` время последнего входа в активную компанию (`last_login`). Необязательно. По умолчанию `false`.\n- with_current_shift: boolean - добавить каждому водителю в `list` текущую смену (`current_shift`). Необязательно. По умолчанию `false`. Работает только вместе с `is_driver: true`, без него игнорируется.\n\n`last_login` берется из журнала сессий компании (тот же, что в `POST /company/sessions/query`) и возвращается в формате даты и времени и часовом поясе компании, например `02-09-2026 11:00:00`. Это время начала последнего сеанса: повторные входы с того же IP в пределах сеанса не учитываются, запись в журнале появляется с задержкой до минуты. Если входов нет, `last_login` равен `null`.\n\nПередавайте `with_last_login` и `with_current_shift` только тогда, когда эти колонки показываются: каждый флаг — дополнительный запрос (в журнал сессий и в сервис объектов). Например, `with_current_shift: true` — при открытии списка «Водители», `with_last_login: true` — при открытии списка «Пользователи».\n\n`current_shift` возвращается только в списке водителей: при `is_driver: true` и `with_current_shift: true`. Это смена, которая идет сейчас: объект (`unit`: `id`, `name`), начало и конец смены (`date_to` равен `null`, если смена не закрыта). Если сейчас идет несколько смен, возвращается начавшаяся последней. Если текущей смены нет или сервис объектов не ответил за 3 секунды, `current_shift` равен `null`.\n\n`is_driver: false` исключает и сотрудников, у которых одновременно рабочая роль и признак водителя. Чтобы показать всех пользователей с доступом в систему, включая таких сотрудников, фильтруйте по ролям через `exclude_role_keys`.\n\n---\n\n**Пример запроса:**\nРаздел «Водители»: все водители независимо от роли, с текущей сменой\n\n```\n{\n \"is_driver\": true,\n \"with_current_shift\": true,\n \"sortField\": \"name\",\n \"sortDesc\": false,\n \"from\": 0,\n \"limit\": 50\n}\n```\n\nРаздел «Пользователи»: без роли «Без доступа» и системных ролей, с последним входом\n\n```\n{\n \"exclude_role_keys\": [\"NO_ACCESS\", \"SUPERVISOR\", \"TARIFF_EDITOR\", \"CONTROLLER\"],\n \"with_last_login\": true,\n \"from\": 0,\n \"limit\": 50\n}\n```\n\n---\n\n**Ответ:**\n`max` — сколько всего записей подходит под фильтр, `list` — текущая страница. Поле `last_login` есть только при `with_last_login: true`, `current_shift` — только при `is_driver: true` и `with_current_shift: true`. Объекты списка аналогичны `GET /me`. Если ничего не нашлось, `list` пустой.\n\n```\n{\n \"max\": 1,\n \"list\": [\n {\n \"id\": \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"name\": \"Петров Петр Петрович\",\n \"email\": \"driver_a3f09c21b7@nomail.skif.pro\",\n \"phone\": \"+79990000001\",\n \"code\": 777,\n \"details\": \"\",\n \"is_driver\": true,\n \"role\": {\"id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"key\": \"NO_ACCESS\", \"value\": \"Без доступа\"},\n \"groups_ids\": [],\n \"groups_count\": 0,\n \"company_user\": true,\n \"last_login\": \"02-09-2026 11:00:00\",\n \"current_shift\": {\n \"id\": \"d12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"unit\": {\"id\": \"e12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"КамАЗ 5490 (А123АА777)\"},\n \"date_from\": \"28-09-2026 08:00:00\",\n \"date_to\": null\n }\n }\n ]\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4dd1c6fd-cff7-4cd3-b8be-be7eada4499d", "name": "max — сколько записей подходит под фильтр, list — текущая страница", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "951b4df8-5815-42a2-8f15-a33d90d497b8", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41f629e7-c875-455e-ba57-e61e5a44485a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09bed3b9-cc13-49cc-9f27-26da14f34ddd", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6bc9f94e-e224-4c90-a214-591c8c1dd966", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3868242-6f4d-4e6d-ad2f-4a73c93094f3", "name": "Превышен лимит частоты запросов", "originalRequest": { "url": { "path": [ "api_v1", "users", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"limit\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"sortField\": \"name\",\n \"sortDesc\": \"\",\n \"value\": \"\",\n \"is_driver\": \"\",\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"exclude_role_keys\": [\n \"\",\n \"\"\n ],\n \"with_last_login\": \"\",\n \"with_current_shift\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "32a4d095-c816-4c72-b8a0-8bb1c17b0e8e", "name": "/users/photos", "request": { "name": "/users/photos", "description": { "content": "**Добавление аватарки пользователю**\n\n---\n\nСохраняет фотографии на диске.\n\nПервый - оригинальный с url \"/imgs/\" + photo.id + \"_original.png\"\n\nВторой - миниатюра - с наибольшей стороной не больее 110 px, url - \"/imgs/\" + photo.id + \"_110.png\"\n\nОба файла можно использовать для сохранения в поле photos в сущности users\n\nПараметр - id пользователя, которому устанавливаем аватарку.\n\nОграничение - размер любой стороны передаваемой картинки не может быть больше 3000px\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Ответ:**\n\nВозможные ошибки:\n\n422, No File\n\n422, No Image\n\n422, Image size exceeded 3000x3000\n\nВозвращается модель вложения\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "eb7a443f-3ea2-4ae1-bb36-0196d2d10de7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7642aaa4-d87a-4512-8ebf-e3b5882c8248", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "312d17c3-a5cb-447c-aa99-a67b090e980e", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e0bf7ab-bf49-4e0e-b52e-f9cdc8a66c9b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d537794-6c1c-4ea4-95e0-6e7cd4886321", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4378e12a-e3a8-4ce7-919f-a0bb8ab9726d", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", "photos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "", "type": "text" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b3a9f60c-1bb1-487e-819d-41205346aa86", "name": "/ask_approve/:userId", "request": { "name": "/ask_approve/:userId", "description": { "content": "**Запросить подтверждение пользователя.**\n\n---\n\n**Параметры:** \nuserId - ID пользователя\n\nТела запроса JSON:\n\nДля подтверждение email: { \"type\": \"EMAIL\" }\n\nДля подтверждение номер телефона: { \"type\": \"PHONE\" }\n\nМожно отправить запрос, если пользователь не подтвержден. Это определяется полем **is_approved** пользователя для email и **is_approved_phone** для номера телефона.\n\nВ случае успеха, в результате отправляется ответ 200 и отправляется письмо на почту или на телефон, указанную в настройке пользователя.\n\nИначе возвращается ошибка с кодом 422.", "type": "text/plain" }, "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "userId", "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "44eb9811-ad30-441a-8f9c-1544d5f42f59", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "201b7882-6309-469d-8e0e-d764438c5036", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "663fa3db-e85c-499c-b2e0-2e2a198e5606", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db0cb678-4806-47c9-945c-6fe45995090f", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fb680fe-24b0-42fe-9d33-ae51f84312f2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e3cb034-9b9f-4737-ba3a-307abe012818", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "ask_approve", ":userId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для повторного запроса подтверждения", "type": "text/plain" }, "type": "any", "value": "", "key": "userId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bfff2f2b-8e77-40d0-b05e-5e54286e62d1", "name": "/users/:id/companies", "request": { "name": "/users/:id/companies", "description": { "content": "**Удаление пользователя из выбранных компаний.**\n\n---\n\n**Параметры:**\n\nid - ID пользователя\n\nВ теле запроса указать список компаний (достаточно указать ID компании)", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fdfb7658-fd5b-4577-8f5e-51770212b1bf", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2238627d-dfff-436a-9e87-f9102a99bbdd", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f1326fa-6c26-4f64-8bc2-66bf6ff118e6", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a900230b-fa39-483a-8d32-a1fed18d0004", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af59f927-2304-4988-b137-f92ade0149bc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46bc3384-3d61-4c9d-aadc-4c3155ec57e5", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "companies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c8f3bf12-5ac6-4465-a65e-66fc47adfaab", "name": "/users/:id/change_role", "request": { "name": "/users/:id/change_role", "description": { "content": "**Изменение роли пользователя в компаниях.**\n\n---\n\n**Параметры:**\n\nid - ID пользователя\n\nВ теле запроса указать:\n\n- Список компаний (достаточно указать ID компании).\n\n- Новую роль в поле role.\n\n\n---\n\n**Роль:** Администратор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a4698f5f-52a5-4399-ad2f-8c6d63ac1aa7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3b37f1e6-e846-4f71-9809-7acc4c710cb2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d205f665-6f43-4b83-a29a-02c2b88df14b", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9e85f27-2b31-4171-9f5e-2d5eae9400bd", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c0fdc23-a41b-4819-8e3c-ce8fd6ad88c4", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b6d6b98-9771-419e-8ce0-d64276363064", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "186b62d7-edba-4fde-8bcf-2050fc7bbdcc", "name": "/users/:id/change_role_all", "request": { "name": "/users/:id/change_role_all", "description": { "content": "**Изменение роли пользователя во всех его компаниях, доступных авторизованному пользователю.**\n\n---\n\n**Параметры:**\n\nid - ID пользователя\n\nВ теле запроса указать новую роль в поле role\n\n---\n\n**Пример запроса:**\n\nPUT /api_v1/users/a8fa266e-3c70-44c8-933e-adb3fe17063d/change_role_all\n\n``` json\n{\n \"role\": {\n \"key\": \"EDITOR\",\n \"name\": \"Редактор\"\n }\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2dfb0898-ada2-40c0-83e1-6bf130d38411", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "338851b9-e5de-4825-af5b-a0bd686fc2f5", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9b60154-1080-4916-87b4-b121ad6675a3", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1c42efa-8c64-46bf-b078-d8b1cfccee75", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68677051-bcb3-4b27-a536-a7eefcf3ec56", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83ec8bb5-c899-4c88-bf0d-5b39413ac838", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "change_role_all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"name\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9ec809af-9bad-48df-bb58-2a84ff1886dc", "name": "/users/:id/addable_companies?search=search", "request": { "name": "/users/:id/addable_companies?search=search", "description": { "content": "**Получение списка компаний, доступных для добавления пользователя**\n\n---\n\n**Параметры:**\n\nid - ID пользователя\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nGET /api_v1/users/679bb60d-3563-4bdd-b7c5-bb72bcef69eb/addable_companies?search=Оду\n\n**Пример ответа:**\n\n``` json\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3376b4a6-c18e-4769-904e-59c924116c08", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dfb09e1d-a98a-4b4d-890e-958777289680", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "425aa523-cb96-40b4-8adb-b8af601f5e18", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4d20dff-3bd4-441d-911d-3ec7d4c89088", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6172db30-2461-420a-8162-21216ab48ff8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54b1b635-be0c-41eb-a4a9-0f09be5f640d", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "addable_companies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e9499d89-0cde-4a9c-8d81-6e38ffada750", "name": "/users/schedule_delete", "request": { "name": "/users/schedule_delete", "description": { "content": "**Запланированное удаление пользователя из системы.**\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\nМетод запланирует удаление на 24 часа, а в ответ на метод выдается сообщение\n\n200:\n\n```\n{\n \"msg\": \"Мы запланировали удаление вашего аккаунта. У вас есть 24 часа чтобы отменить удаление по ссылке, которую мы вам отправили на почту.\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3c67971a-8851-41dc-bda0-16ca9f8b9a06", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "76569388-9eb4-4485-acbe-095233e0d4c2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6698b820-6dc6-4a16-b8a4-99d215bdeb49", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fead19a9-79fa-499f-b36d-43af7c976fc5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b78a80a-6379-4ec9-bcaa-22b77afb350f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92f92cab-4bb0-48e1-a1a8-3821059fd298", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8bce5765-6662-4591-bd27-ad865d195a39", "name": "/users/:id/create_token", "request": { "name": "/users/:id/create_token", "description": { "content": "**Создание пользовательского API_KEY для конкретной компании**\n\n---\n\nВы можете предоставить доступ только тем пользователям, у которых есть только одна компания и роль ниже администратора.\n\n**Параметры запроса:**\n\nid - Id пользователя\n\n**В теле запроса:**\n\nvalid_to - срок действия ключа (ссылки).\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /users/8462404e-99a9-4226-ae14-2f59e0400768/create_token\n\n``` json\n{\n \"valid_to\": \"2024-06-21 15:00:00\"\n}\n\n ```\n\nПоле user_company_api_key возвращает ключ, который можно отправлять в запросах в заголовке user_company_api_key.\n\nПоле url возвращает ссылку для авторизации пользователя в компании.\n\n**Пример ответа:**\n\n``` json\n{\n \"user_company_api_key\": \"{{vault:json-web-token}}\",\n \"url\": \"https://api.skif.pro/api_v1/login?user_company_api_key={{vault:json-web-token}}\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4addaf3d-865a-4ae7-8f67-32830dc7bf3f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0f6c1181-1b17-47b6-aa08-d5793517af2a", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25d66025-386e-4a03-aad1-e1e927370b75", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cc20b77-8716-4bb8-8d0e-7ea0aafba1e9", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "853bd2b8-1a8f-40fc-bc4d-24d1a259e9ff", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a99e8a5a-e782-40ca-a7ca-9dcbebd092a2", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id", "create_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "93a70c5a-3ed2-433e-839f-2e880932e988", "name": "/me/settings?company_id=", "request": { "name": "/me/settings?company_id=", "description": { "content": "**Получение пользовательских настроек для текущего пользователя**\n\nПараметр запроса company_id - ID компании, необязательное поле. Если указано, настройки возвращаются только для этой компании.\n\n---\n\n**Описание поля в JSON:**\n\nkey - ключ настройки, строка\n\nvalue - значение настройки, строка\n\nversion - версия настройки, целое число\n\n**Пример**:\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c74f4e80-7a2e-44ba-9d42-9fe80fe4ca6b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "85f3fa4f-8831-40b4-91fd-b92656094f45", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4074914d-a235-48a4-a863-d0620d69170a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84d0969f-4f8e-43c1-a1e6-775c12251b70", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4c62c9c-8a36-4403-8a3d-0fd988b95220", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2854d8ac-3499-4149-8808-d58863d2b1b3", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e83b6d2f-9d62-42fd-83c6-01dc767f8379", "name": "/me/settings", "request": { "name": "/me/settings", "description": { "content": "**Сохранение пользовательских настроек для текущего пользователя**\n\n---\n\n**Описание поля в JSON:**\n\n**key** - ключ настройки, строка. Для уникальных настроек, которые используются только в одном стенде, рекомендуется использовать префикс или суффикс. Например, show_geozones_on_map_web\n\n**value** - значение настройки, строка.\n\n**version** - версия настройки, целое число.\n\n**company_id -** ID компании, в который сохраняется настройка пользователя.\n\n**Пример запроса:**\n\n```\n{\n \"key\": \"show_item_in_moon\",\n \"value\": \"1\"\n}\n\n ```\n\nОтвет возвращает массив JSON: все настройки пользователя:\n\nПример:\n\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Сохранение настройки пользователя в компании:\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "16fffdc5-62a1-4e30-a5b6-31a7291fd266", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "13257b8f-1876-465f-946e-ea57bb599740", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "911d5957-76b3-425f-aa87-91e2abffba8f", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e296568d-bbe0-4478-8bb2-a995141471fa", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e79a155f-0f95-4792-882d-2d0be48c8dcc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "469a97fc-af9c-4741-8eed-7673d97df8ff", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "me", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"value\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b8e05434-afe5-4653-ab3f-6eb58b589165", "name": "/change/user/:user_id/company/:company_id", "request": { "name": "/change/user/:user_id/company/:company_id", "description": { "content": "**Возможность переключение под пользователем без запроса пароля**\n\n---\n\n**Параметры запроса:**\n\nuser_id - ID пользователя для переключения.\n\ncompany_id - ID компании для переключения.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n[https://admin-dev.skif.pro/api_v1/change/user/2f583b2b-a7d6-4d93-94b3-da6eedab69f0/company/459b2824-0035-499d-8062-baccb2ae5581](http://admin-dev.skif.pro/api_v1/change/user/2f583b2b-a7d6-4d93-94b3-da6eedab69f0/company/459b2824-0035-499d-8062-baccb2ae5581)\n\nВ результате пользователь перенаправляется на страницу в которой пользователь авторизуется под выбранным пользователем.\n\nДля авторизованного пользователя таким способом возвращается в GET /me поле `another_user: true`", "type": "text/plain" }, "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "user_id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } }, { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7565f3d3-c6e6-4f30-b963-58fb2948ed25", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a99ab034-5b9a-4fda-abe6-4d43511c41f4", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3db0bc9-471d-4c2d-9d4f-6569b687d0d4", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4a4c9e9-9592-4688-b272-108d275f614a", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2280e7db-f6b9-4e43-a3b5-dc269f8ca195", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d211736c-73a2-4ee1-8ba7-d6f74c82c891", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "change", "user", ":user_id", "company", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" }, { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "user_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e7edbcbf-20f0-4bce-8c90-766248eeedce", "name": "/users", "request": { "name": "/users", "description": { "content": "

Создание пользователей, минуя приглашение.

\n
\n

Добавление пользователя с ролью Редактор

\n
\n

Роль: Администратор и выше.

\n
\n

Параметры:

\n
{\n  \"role\": {\"key\": \"EDITOR\", \"value\": \"Редактор\", \"id\": \"5ac818aa-f66e-4ecd-8981-5bcbafe03255\"}, // Роль выбирается из списка ролей; достаточно указать только идентификатор. Получить все роли GET /roles\n  \"name\": \"Иван Иванов\",     //имя\n  \"password\": \"your_secure_password\",    \n  \"is_driver\": false // является ли пользователь водителем      \n  \"email\": \"user@example.com\", //email\n  \"code\": \"092384\",                //  id пользователя (rfid), доступно для пользоваетля с ролью Editor\n  \"language\" : {\"key\":\"en\"}               //язык пользователя\n  \"phone\" : \"+79990000001\" //телефон пользователя\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
\n

Ответ аналогичен PUT /me

", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "42859d35-6ba3-420e-be90-7ffebbc23f81", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dfefce8f-d280-41ac-8c32-11f24afe80a5", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51abef16-e2eb-4409-a831-c4e980493993", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac6de178-c566-4539-ae58-c899b31e776c", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4badd9fa-cf97-4ef4-8651-ca4e96c30ec4", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56683f48-45c5-47f9-b379-a7a0d49d4c39", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c20009c9-a0be-4a76-ad1f-d85306aca043", "name": "Импорт водителей из CSV", "request": { "name": "Импорт водителей из CSV", "description": { "content": "**Импорт водителей из CSV**\n\n---\n\nСоздает водителей пачкой. Файл CSV разбирает клиент: сопоставляет колонки (ФИО; ФИО и код; ФИО, код и телефон) и передает готовые строки. Каждый водитель создается с ролью «Без доступа», `is_driver: true`, случайным паролем, техническим email вида `driver_@nomail.skif.pro` и языком платформы по умолчанию.\n\nСтроки с ошибками пропускаются и возвращаются в `errors`, остальные сохраняются одной транзакцией.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Параметры:**\n- rows: array - строки для импорта. Обязательно. От 1 до 1000 строк.\n - name: string - ФИО водителя. Обязательно.\n - code: string - код водителя (ключ, RFID). Необязательно. Только цифры. Уникален в компании и в пределах запроса.\n - phone: string - телефон. Необязательно. Уникален в системе и в пределах запроса.\n- companies: array - компании, в которые импортировать водителей (для админ-панели). Необязательно. По умолчанию — активная компания. Водитель создается один раз и добавляется в каждую компанию с ролью «Без доступа». У запрашивающего в каждой компании должна быть роль «Администратор» и выше. Код водителя должен быть свободен в каждой компании.\n - id: string (UUID) - идентификатор компании. Обязательно для каждого элемента.\n- company_id: string (UUID) - одна компания для импорта, то же, что `companies` с одним элементом. Необязательно. Если передан `companies`, не учитывается.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"rows\": [\n {\"name\": \"Иванов Иван Иванович\"},\n {\"name\": \"Сидоров Сидор Сидорович\", \"code\": \"101\"},\n {\"name\": \"Козлов Павел Петрович\", \"code\": \"102\", \"phone\": \"+79990000002\"},\n {\"name\": \"Дубль Кода\", \"code\": \"101\"}\n ]\n}\n```\n\n---\n\n**Ответ:**\n`created` — сколько водителей создано. `errors` — пропущенные строки: `row` — номер строки с 1, `field` — поле с ошибкой (`name`, `code`, `phone`), `message` — текст ошибки. `list` — созданные водители.\n\n```\n{\n \"created\": 3,\n \"errors\": [\n {\"row\": 4, \"name\": \"Дубль Кода\", \"field\": \"code\", \"message\": \"Водитель с кодом 101 уже есть в компании\"}\n ],\n \"list\": [\n {\"id\": \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"Иванов Иван Иванович\", \"code\": null, \"is_driver\": true},\n {\"id\": \"c12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"Сидоров Сидор Сидорович\", \"code\": 101, \"is_driver\": true},\n {\"id\": \"d12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"Козлов Павел Петрович\", \"code\": 102, \"is_driver\": true}\n ]\n}\n```\n\nКод 422:\n- `rows` не передан или пустой;\n- строк больше 1000 (`validation.errors.tooManyRows`);\n- компания не найдена или у запрашивающего в ней роль ниже «Администратора» (`validation.errors.companyNotFound`).\n", "type": "text/plain" }, "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9bda6ad2-b028-41e5-b8ae-4b79a3dfa89f", "name": "created — создано, errors — пропущенные строки, list — созданные водители", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"created\": \"\",\n \"errors\": [\n {\n \"row\": \"\",\n \"name\": \"\",\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"row\": \"\",\n \"name\": \"\",\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69631af3-80c2-4a64-b83f-d27c81372fc2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f89b0d3-2787-4278-a19b-9532197e16ae", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31f7e7af-9f91-4723-8036-f2c9cc1b28ca", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb3b93ec-3ec5-4105-9939-214a4cd3ed91", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1822b3f1-6cd1-487f-9097-807dd057cfa8", "name": "Превышен лимит частоты запросов", "originalRequest": { "url": { "path": [ "api_v1", "drivers", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"name\": \"\",\n \"code\": \"\",\n \"phone\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dc6b6faa-f588-4636-a46e-f1fd4c6f0257", "name": "Импорт пользователей из CSV", "request": { "name": "Импорт пользователей из CSV", "description": { "content": "**Импорт пользователей из CSV**\n\n---\n\nСоздает пользователей активной компании пачкой. Пользователи входят по логину и паролю. Файл CSV разбирает клиент и передает готовые строки: логин, пароль и необязательный email. Всей пачке назначается одна роль и язык платформы по умолчанию. Письма о создании аккаунтов не отправляются.\n\nСтроки с ошибками пропускаются и возвращаются в `errors`, остальные сохраняются одной транзакцией.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Параметры:**\n- role: object - роль для всех импортируемых пользователей. Необязательно. По умолчанию «Наблюдатель» (`OBSERVER`). Роль не выше «Администратора» и не выше роли запрашивающего.\n - id: string (UUID) - идентификатор роли, список ролей — `GET /roles`. Необязательно, если указан key. Роль, созданная в компании, должна принадлежать активной компании.\n - key: string - ключ базовой роли. Необязательно, если указан id. Возможные значения: `NO_ACCESS`, `OBSERVER`, `READER`, `OPERATOR`, `EDITOR`, `ADMIN`.\n- companies: array - компании, в которые импортировать пользователей (для админ-панели). Необязательно. По умолчанию — активная компания. Пользователь создается один раз и добавляется в каждую компанию с одной ролью. У запрашивающего в каждой компании должна быть роль «Администратор» и выше. Роль, созданная в компании, подходит только при импорте в эту одну компанию. Пароль проверяется по строгой политике, если она включена хотя бы в одной из компаний.\n - id: string (UUID) - идентификатор компании. Обязательно для каждого элемента.\n- rows: array - строки для импорта. Обязательно. От 1 до 1000 строк.\n - login: string - логин. Обязательно. Уникален во всей системе и в пределах запроса, без пробелов в начале и конце и без двойных пробелов.\n - password: string - пароль. Обязательно. Проверяется по парольной политике компании.\n - email: string - email. Необязательно. Если не передан, генерируется технический адрес `@nomail.skif.pro`.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"role\": {\"id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\"},\n \"rows\": [\n {\"login\": \"dispatcher_1\", \"password\": \"Passw0rd!\"},\n {\"login\": \"dispatcher_2\", \"password\": \"Passw0rd!\", \"email\": \"demo_user@skif.pro\"},\n {\"login\": \"dispatcher_1\", \"password\": \"Passw0rd!\"}\n ]\n}\n```\n\n---\n\n**Ответ:**\n`created` — сколько пользователей создано. `errors` — пропущенные строки: `row` — номер строки с 1, `field` — поле с ошибкой (`login`, `password`, `email`), `message` — текст ошибки. `list` — созданные пользователи.\n\n```\n{\n \"created\": 2,\n \"errors\": [\n {\"row\": 3, \"login\": \"dispatcher_1\", \"field\": \"login\", \"message\": \"Такое имя уже используется в системе, выберите другое, или деактивируйте возможность логина по имени\"}\n ],\n \"list\": [\n {\"id\": \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"dispatcher_1\", \"email\": \"k3j9x0a1b2c3@nomail.skif.pro\"},\n {\"id\": \"c12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"name\": \"dispatcher_2\", \"email\": \"demo_user@skif.pro\"}\n ]\n}\n```\n\nКод 422:\n- `rows` не передан или пустой;\n- строк больше 1000 (`validation.errors.tooManyRows`);\n- компания из `companies` не найдена или у запрашивающего в ней роль ниже «Администратора» (`validation.errors.companyNotFound`);\n- роль не найдена;\n- роль выше «Администратора» или выше роли запрашивающего (`session.errors.noPermission`).\n", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "26746d65-b58d-48ab-8cdf-27f4fe84b0fe", "name": "created — создано, errors — пропущенные строки, list — созданные пользователи", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"created\": \"\",\n \"errors\": [\n {\n \"row\": \"\",\n \"login\": \"\",\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"row\": \"\",\n \"login\": \"\",\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1870d65-a1a8-4846-b252-b5bb6ca0b932", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d76be041-cb64-44fd-9407-3d4c2bb462db", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92acf1ef-b731-454b-a699-b323706f86b0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8e55e56-dce9-4a8f-a223-8c26558bcea3", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d172ceea-77f5-4856-b6a4-5fd131cc148a", "name": "Превышен лимит частоты запросов", "originalRequest": { "url": { "path": [ "api_v1", "users", "import_csv" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"rows\": [\n {\n \"login\": \"\",\n \"password\": \"\",\n \"email\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"READER\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "556254d5-fc33-413c-98fe-d415c8cadc98", "name": "Массовая смена роли пользователей", "request": { "name": "Массовая смена роли пользователей", "description": { "content": "**Массовая смена роли пользователей**\n\n---\n\nНазначает одну роль нескольким пользователям активной компании. Права пользователей в группах объектов пересчитываются под новую роль так же, как при смене роли в карточке пользователя. Если хотя бы одному пользователю роль сменить нельзя, роли не меняются ни у кого.\n\nНельзя менять роль себе и пользователю с ролью выше, чем у запрашивающего.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Параметры:**\n- user_ids: array of string (UUID) - пользователи, которым меняется роль. Обязательно. От 1 до 1000. Все пользователи должны состоять в активной компании.\n- role: object - новая роль. Обязательно. Роль не выше «Администратора» и не выше роли запрашивающего.\n - id: string (UUID) - идентификатор роли, список ролей — `GET /roles`. Обязательно, если не указан key.\n - key: string - ключ базовой роли. Обязательно, если не указан id. Возможные значения: `NO_ACCESS`, `OBSERVER`, `READER`, `OPERATOR`, `EDITOR`, `ADMIN`.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"role\": {\"id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\"},\n \"user_ids\": [\n \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"c12345b2-6789-1ab2-3cd4-1ab234cd5e67\"\n ]\n}\n```\n\n---\n\n**Ответ:**\n`updated` — у скольких пользователей сменилась роль.\n\n```\n{\n \"updated\": 2\n}\n```\n\nКод 422, если хотя бы один пользователь не прошел проверку: роли не меняются, в `errors` по одной записи на каждого такого пользователя, `field` — его id.\n\n```\n{\n \"code\": 4220,\n \"message\": \"Указанный пользователь не найден\",\n \"errors\": [\n {\"code\": 4220, \"field\": \"c12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"message\": \"Указанный пользователь не найден\"}\n ]\n}\n```\n\nКод 422 также возвращается, если:\n- `user_ids` не передан, пустой или содержит не UUID;\n- пользователей больше 1000;\n- роль не передана или не найдена;\n- роль выше «Администратора» или выше роли запрашивающего (`session.errors.noPermission`).\n", "type": "text/plain" }, "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "af17bcb4-1d2f-4ca5-9971-928959b660e8", "name": "updated — у скольких пользователей сменилась роль", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38ea1d2d-36e6-41eb-9a66-b9294ee38f95", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d99dfe1-e91b-4334-aebd-be6ae76ef628", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d27f2ab5-9c03-4c0a-ae51-f886a2ede804", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "431fadd6-a4c2-41d5-8a4c-cde088a916a1", "name": "Роль не сменилась ни у кого: errors[].field — id пользователя, не прошедшего проверку; либо ошибка параметров", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c34d957-ba3d-4f4d-a870-c41b5810ba9d", "name": "Превышен лимит частоты запросов", "originalRequest": { "url": { "path": [ "api_v1", "users", "roles", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\"\n ],\n \"role\": {\n \"id\": \"\",\n \"key\": \"ADMIN\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Общее", "description": "", "item": [ { "id": "31868dea-0ac9-47eb-a160-6489e1f799c1", "name": "Системные справочники (типы ТС, иконки)", "request": { "name": "Системные справочники (типы ТС, иконки)", "description": { "content": "**Получить все записи справочника Dictionary с указанным типом.**\n\n---\n\n**Описание параметров:**\n\ndicType - тип записей, которые необходимо получить.\n\nМожет принимать следующие значения:\n\nadmin_modules \ncolor_code \ncustomfield_groups \nformula \ngeo_icon \ngeozone_type \nnotification_type \nperiodic_type \nreport_template_table_grouping \nreport_template_table_type \nsensor_type \nterminal_type \ntrip_activation_type \ntrip_passage_order_type \nunit_icon \nunit_type \nweekdays_type\n\n---\n\n**Пример запроса:**\n\nGET /dictionaries/unit_type\n\nвозвращает все часовые пояса в формате (пример для английской локали):\n\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 ```\n\n**Описание параметров ответа:** \ntype - тип справочника, \nkey - ключ справочника, \nvalue - перевод справочника на язык пользователя\n\nВ случае отсутствия записей переданного типа возвращает пустой массив \\[\\]", "type": "text/plain" }, "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "dicType", "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "87d34ab6-43e7-46f6-963c-3a49d7fbf6e7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4fb48283-5564-44b7-97d8-ad6ac8d89b2f", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f6cff54-973e-4bc4-b848-b5659f965004", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a5b0cb1-fc96-4fb1-bb83-cfe63d3f8a79", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0472691-b91f-4483-a035-b77997cfd2d1", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27a21f49-6bb3-4ee6-a97f-2dcc1c54af44", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "661f7c87-7ee5-4648-a9f8-2f0d700d11b8", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", ":dicType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Тип справочника", "type": "text/plain" }, "type": "any", "value": "", "key": "dicType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a2224b3b-49c6-4650-bd4b-ff734ed6e104", "name": "Справочник типов транспортных средств", "request": { "name": "Справочник типов транспортных средств", "description": { "content": "**Получить все записи справочника Dictionary**\n\n---\n\nПример запроса:\n\nGET /dictionaries\n\nвозвращает все справочники (пример для английской локали) сортируя по type:\n\n```\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 ```\n\n**Описание параметров ответа:** \ntype - тип справочника, все возможные знечения: \nadmin_modules \ncolor_code \ncustomfield_groups \nformula \ngeo_icon \ngeozone_type \nnotification_type \nperiodic_type \nreport_template_table_grouping \nreport_template_table_type \nsensor_type \nterminal_type \ntrip_activation_type \ntrip_passage_order_type \nunit_icon \nunit_type \nweekdays_type \nkey - ключ справочника, \nvalue - перевод справочника на язык пользователя", "type": "text/plain" }, "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "be16f2a3-e01b-49f4-a538-f6b540925fdd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "38d78044-5c5c-4fb8-9649-2f04deefd51d", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ef29d0c-a9bf-4078-899b-02016c283f4d", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e760a372-aaeb-4963-ab5b-ee43dcaaca03", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99b02a70-b68c-449a-a0ff-3a2ea16b4fa9", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80984ba8-d78e-4ecb-8a86-e65f0d06664d", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fc90e56-797f-43a7-a1f5-db90d08c5c6e", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "dictionaries", "unit_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "33aa8908-ecb1-40fd-9bb3-3b55c8232a35", "name": "Свойства компании по категории", "request": { "name": "Свойства компании по категории", "description": { "content": "**Получить все записи справочника Properties с указанным типом.**\n\nСправочник 'Properties' предназначен ТОЛЬКО для микросервиса auth и включает в себя только информацию о юзере.\n\n---\n\n**Описание параметров:**\n\npropertiesType - тип записей, которые необходимо получить.\n\nМожет принмать следующие значения:\n\nlanguages (языки),\n\ntimezones (часовые пояса)\n\nroles (роли)\n\ndateformats (форматы даты)\n\ntimeformats (форматы времени)\n\n**Пример запроса:**\n\nGET /properties/timezones\n\nВозвращает все часовые пояса в формате (пример для английской локали):\n\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 ```\n\n**Описание параметров ответа:** \ntype - тип справочника, \nkey - ключ справочника, \nvalue - перевод справочника на язык пользователя\n\nВ случае отсутствия записей переданного типа возвращает пустой массив \\[\\]", "type": "text/plain" }, "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "propertiesType", "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "03d666dc-cae0-465c-be10-bd815e0fded2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "32f446da-8dcb-4290-9444-7e6a03482852", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a48adbe1-a7bc-4fac-b0b0-39c5a043fe23", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05cc3ad8-6f7c-4344-8ed3-252c4e303bb7", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf3ddf70-6739-4570-9f32-219b162b4637", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e262779-44c5-43f2-8db3-c896d619371f", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c9dfbc9-00e8-4732-942b-fb2ba119cc74", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "properties", ":propertiesType" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Категория свойств", "type": "text/plain" }, "type": "any", "value": "", "key": "propertiesType" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1233273e-bf58-41ed-830e-1dc473e31ca9", "name": "Общие настройки и свойства компании", "request": { "name": "Общие настройки и свойства компании", "description": { "content": "**Получить все записи справочника Properties**\n\nСправочник 'Properties' предназначен ТОЛЬКО для микросервиса auth и включает в себя только информацию о пользователе.\n\n---\n\n**Пример запроса:**\n\nGET /properties\n\nВозвращает все записи (пример для английской локали):\n\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 ```\n\n**Описание параметров ответа:** \ntype - тип справочника, все возможные значения:\n\nlanguages - языки \ntimezones - часовые пояса \nroles - роли \ndateformats - форматы даты \ntimeformats - форматы времени \nkey - ключ справочника \nvalue - перевод справочника на язык пользователя", "type": "text/plain" }, "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "15309f3d-8ed6-4e50-b075-8aa689692325", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "04e4aa38-d03c-47e4-8ac7-7b6c7bd45c33", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a5e257c-a83b-459a-b2a8-aeb5cf5f3e6f", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed667892-e42c-4201-9450-7e4fc9aad0fa", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9da54391-e809-41f1-a679-74379db358e6", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2272a575-2947-4067-80e0-333d55bff3c3", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3899afe0-d38c-4f58-84a4-15bb0d182309", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f09d9ce9-d246-418e-8bd4-71ad12b57811", "name": "Проверка прав доступа текущего пользователя", "request": { "name": "Проверка прав доступа текущего пользователя", "description": { "content": "**Получить доступ текущего пользователя к сущностям системы**\n\n---\n\n**Формат возвращаемых данных:**\n\n``` json\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 ```\n\n---\n\n**Описание параметров ответа:**\n\nedit_classes_fields - ключ тега, содержащий массив ограничений на редактирование к сущности\n\ntype - ключ сущности, возможные значения users, units, geozones, routes, report_templates, notifications_templates\n\nfields - массив полей доступных пользователю на редактирование\n\nedit_objects_fields - ключ тега, содержащий массив ограничений, на редактирование конкретных сущностей\n\nid - идентификатор сущности, к которой применяется ограничение\n\nactions - ключ тега, содержащий массив ключей действий, к которым имеет доступ пользователь\n\n---\n\nДоступ определяется на основании роли пользователя к текущей компании и сущностям, к которым он имеет эксклюзивный доступ (например, собственная карточка пользователя)", "type": "text/plain" }, "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "be25fcd2-98ea-490f-898a-992edfe00cbe", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5fe10d88-167b-4f01-a30a-3719a6352d57", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d44105a2-ef08-486d-b522-bc49302ad08e", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca2b68a1-8195-4029-8fea-58d6c889adfa", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c4a1b09-4b11-4841-b827-9901bb7ac283", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bf64a8d-acee-4712-9993-4b00268f8961", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d3fd7c8-c4ea-4903-bd74-88b00c3b9075", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d652cd5-6119-4a13-b56a-0b5bdb09e9bb", "name": "Реестр пользовательских полей компании", "request": { "name": "Реестр пользовательских полей компании", "description": { "content": "**Запрос на получение обязательных custom_fields**\n\n---\n\nCustom_fields юнита делятся на 2 типа - обязательные и необязательные (кастомные).\n\nОбязательные **custom_fields** это поля, которые должны присутствовать у каждого юнита. При создании/изменении юнита лучше всего передавать эти обязательные поля со значениями, установленными юзером. Если бэкенд не обнаружит в юните какого-то обязательного поля, то оно будет создано в нём автоматически, значение будет взято из default_value. \nБэкенд проверяет значения через паттерн. В случае не соответствия паттерну, будет выброшена ошибка.\n\nНеобязательные поля - произвольные поля, созданные юзером дополнительно. Никак не проверяются на стороне бэкенда. По состоянию на май 2020г. используются как поля для дополнительной информации (пояснительные) и не участвуют в каких-либо расчетах.\n\nCustom_field юнита имеет следующие параметры \nname - имя поля, которое отображается в интерфейсе. У обязательных полей - не изменяемо (поэтому пытаться изменить его название в юните не имеет смысла). У НЕобяз. - изменяемое, произвольное. \nkey - ключ **custom_fields**. Все поля определяются и распознаются бэкендом именно по ключу. У обяз.полей - ключ константный, у необяз. полей - ключ произвольный, договорились использовать key такой же как и name. \nvalue - значение, которое пользователь присвоил этому кастом филду.\n\n---\n\n**Пример ответа:**\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "10ab7341-8a10-45a4-b187-7bae43abcc40", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7a89fc8e-f2c8-422a-b982-fe84c21be76f", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56e2ea4e-8ac6-41ec-aa89-b2307723c555", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c204659-41c4-466f-8fc9-fc6f4365891e", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bd9fc61-80ac-4721-8f5d-e76a4079482b", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ee014b1-7695-4ac8-834f-c93a9ec6e93b", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfa41834-0194-40c3-9fea-e3480acf5cde", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "custom_fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "58d04005-cda4-4acd-b7f4-d9c85f4ea538", "name": "Получение телеметрии объекта по ссылке Локатора (Locator)", "request": { "name": "Получение телеметрии объекта по ссылке Локатора (Locator)", "description": { "content": "Публичный интерфейс опроса состояния и координат объекта, расшаренного через временную ссылку Локатора. Авторизация по UUID ссылки.", "type": "text/plain" }, "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a3d30ccc-eabb-4c6d-a83c-0989508d5784", "name": "Текущие координаты и параметры объекта", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"unit_name\": \"\",\n \"datepoint\": \"\",\n \"address\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c817eb14-09c4-4ebd-adb9-8975db5cce2a", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24aaa85b-9955-4204-90cc-6bb788c05333", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e1d521b-a461-4fb3-bea2-25a5ce0bec01", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69a9325e-f1e0-4250-9220-a4dfb71a0ac6", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e04c8286-bf41-4823-965f-5179828f11c6", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9597405e-2f72-4d27-97a2-2e2e19b44c69", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "94510570-c1f9-49de-81b3-e98050680052", "name": "Прямое геокодирование адреса", "request": { "name": "Прямое геокодирование адреса", "description": { "content": "**Получение координат по адресу**", "type": "text/plain" }, "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "address", "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c24b9ff2-bbef-4c3f-89b3-b3324faca0da", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "77415b73-3bbc-48d4-b39d-4ca0f7eec840", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2371913b-654f-4a07-b086-b27387997118", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf0551da-b800-48a7-a15b-f62bc83a0d05", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b742ca1b-ed4d-449c-8f57-cc262f37c7ac", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37a6e7ee-cab0-4a9e-bfca-9389608a0e46", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2748d835-a3e6-44ed-a449-8a025930b060", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "geocode", ":address" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Адресная строка для геокодирования", "type": "text/plain" }, "type": "any", "value": "", "key": "address" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7ee3baab-8c4a-4a9c-b59d-eff1b27fe67c", "name": "Построение маршрута по опорным точкам", "request": { "name": "Построение маршрута по опорным точкам", "description": { "content": "**Построение маршрута, проходящего через указанные точки**\n\n---\n\nСтруктура запроса: \npoints - Список точек в формате : latitude1,longitude1;latitude2,longitude2;...;latitudeN,longitudeN \nМожно указать до 10 точек.\n\nСтруктура ответа, как в ответе на запрос /fastracks\n\nПример запроса: \nGET /routing/76.928054,43.226996;76.913200,43.237085;76.887795,43.217677\n\n\nПример ответа:\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "points", "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a2d02dec-4343-4382-9c0c-cb43819db281", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5e73fa44-4cdc-4e73-82a9-4ff895f0a3b7", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22ae279b-55a0-4a64-a045-27544e2a7d8b", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec8393a2-0049-431c-8c65-490e86c33c84", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68acb940-39a9-4e3a-89a7-2fa1a36683fc", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bad0990-fa93-4e9c-9e45-3629b20b7280", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c235a9a5-ca81-4760-8722-3275203c0e1d", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "routing", ":points" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Координаты точек через точку с запятой", "type": "text/plain" }, "type": "any", "value": "", "key": "points" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "90d3da10-73fc-4097-b2b3-da0fbc188d76", "name": "Автодополнение и поиск адресов", "request": { "name": "Автодополнение и поиск адресов", "description": { "content": "**Поиск места по адресу**\n\n---\n\nЗапрос:\n\n``` json\n{\n \"part\": \"Москва\"\n}\n\n ```\n\npart - часть текста\n\nСтруктура ответа: \nJSON массив, где каждый элемент имеет следующие поля: \n\\- name : Название места \n\\- decription : Описание места \n\\- pos : Координаты места в формате: \\[широта, долгота\\]\n\nПример запроса:\n\n``` json\n{\n \"part\": \"Алма\"\n}\n\n ```\n\nПример ответа:\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7b593eba-6935-4791-aac3-f619b6da0718", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cf8cc299-4ca2-4e83-ac39-5321f02861b0", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "338249b4-c007-49ba-a664-b7398c6bf780", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd08e583-7ddb-4cc6-ab26-46325fe34d2a", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5d4e7aa-e0d6-421a-a18e-ece09f6989b5", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5ba2978-7a2e-4b51-9941-c5cb4063a482", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e8fc4cc-7cfc-4270-977f-9ca2ab68729b", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "geocode_search" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"part\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "516e63e3-e859-46cb-a165-d06b2e8a6656", "name": "Список серверов и шлюзов приёма телеметрии", "request": { "name": "Список серверов и шлюзов приёма телеметрии", "description": { "content": "**Получение серверов по email пользователя**\n\n---\n\nПараметр body содержит следущие поля:\n\nemail (обязательный) - email пользователя\n\nget (необязательный) - возможные значения: \"ktzh\" - для получения серверов приложения КТЖ, \"all\" - для получения всех доступных серверов", "type": "text/plain" }, "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d3e3942c-b42b-4b90-a891-f2b7250fb904", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5508f648-a341-41f7-8eba-1b44266e7113", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ead88855-cee7-4130-9c25-6c1f76bb5675", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "633befb3-432e-4baa-9304-0aca82486ab2", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df783d04-876b-4d18-993e-c28d2ea369d2", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71b49711-78cd-477f-88df-50e6e757d596", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7950da6-bf53-4f9e-a4e4-30a2891b8ac6", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "servers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "25d32cf8-37c6-401c-8347-6694c8dde730", "name": "Клонирование конфигурации сущностей", "request": { "name": "Клонирование конфигурации сущностей", "description": { "content": "**Копирует сущности из одной компании в другую (пока реализовано для units, geozones и reports_templates)**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\nПримеры запросов:\n\nКопирование в 1 компанию:\n\n``` json\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Можно копировать в несколько компаний:\n\n``` json\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 ```\n\nА чтобы копировать все сущности c другой компании:\n\n``` json\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Также можно скопировать в несколько компаний:\n\n``` json\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 ```\n\nВозможные значения type - \"units\", \"geozones\" или \"report_templates\" ( в будущем будут: \"unitsgroup\", \"units\", \"geozones\", \"notifications\", \"routes\", \"trailers\", \"mailings\")\n\nids - id сущностей, которые нужно скопировать в другую компанию.\n\nfrom_company_id - id компании, c которой нужно скопировать все сущности.\n\nto_company_id - id компании, в которую нужно скопировать сущности.\n\nВ случае успеха возвращается код 200, иначе текст ошибки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6fc9ef88-dfe3-4e54-ba50-849763a3a057", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cadba69f-ca73-4ff5-82f2-3b46d3f0854d", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f876c9bf-49c4-4818-9f53-436a16ad5970", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef26c7ed-3b32-4cb4-ad9f-a5dfc152c828", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d298171-f874-4aa3-bc35-ccdcc67fd93d", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2abb1f51-02ae-4a9d-8dc9-960dab597ee7", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bcea432-cc42-4526-81da-606006b661f0", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"to_company_id\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d8522c31-0448-48b6-b2aa-9d7af0bb026d", "name": "Восстановление конфигурации из бэкапа", "request": { "name": "Восстановление конфигурации из бэкапа", "description": { "content": "**Восстанавливает сущности (пока реализовано для units)**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\nПример запроса:\n\n```\n{\n \"type\": \"units\",\n \"ids\": [\"b92f5e06-ee48-4a08-8647-d805465e7be8\", \"b5298b57-df70-405e-b2b6-071ed230d36c\"]\n}\n\n ```\n\nВозможные значения type - \"units\" ( в будущем будут: \"unitsgroup\", \"units\", \"geozones\", \"report_templates\", \"notifications\", \"routes\", \"trailers\", \"mailings\")\n\nids - id сущностей, которые нужно востановить.\n\nВ случае успеха возвращается код 200, иначе текст ошибки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0f5fec5f-8c3c-4bf4-bafd-9c230672ae58", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e8b0b5e1-2dd8-42a7-a84a-9e9eea9fc875", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f32b2f58-09ff-46be-97cb-3811da9e1493", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b83cdce4-8801-409b-922a-8f4dc7c3e822", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "601e03d8-0ace-47ef-bf99-63384bf77b31", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd5648c5-7918-4242-a356-284e3c513043", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f696c010-dcea-4e33-9d4f-9df43c035d3f", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "restore" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e1b2698b-fd17-4467-9bc4-4d906c6ba79b", "name": "Универсальный запрос к сервису авторизации", "request": { "name": "Универсальный запрос к сервису авторизации", "description": { "content": "**Получения сущностей по всем компаниям для** **users и companies**\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПримеры запросов:\n\n```\n{\n \"model\": \"units\",\n \"value\": \"тест\", /для поиска\n \"from\": 0,\n \"count\": 100\n}\n\n ```\n\nВозможные значения model - \"users\", \"companies\"\n\nЧтобы фильтровать по интегратору надо отправить в запросе поле dealer. Достаточно указать id.\n\n\"dealer\": {\"id\": \"8a7d85f9-156e-41ab-9534-da71d1847cba\"}\n\nПример ответа:\n\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 ```\n\n---\n\nДля model \"users\":\n\n\"fields\": [\"id\", \"name\", \"email\", \"is_driver\"] - поля, которые нужно вернуть. Возможные значения: id, name, email, phone, code, details, telegram_chat_id, is_driver, companies, dealers. По умолчанию id, name, email.\n\n\"is_driver\": признак водителя, true или false. Возвращается, если указан в fields.\n\n\"conditions\": [{\"field\": \"is_driver\", \"value\": \"true\"}] - только водители; [{\"field\": \"role_key\", \"values\": [\"ADMIN\", \"EDITOR\"]}] - пользователи, у которых хотя бы в одной компании есть одна из этих ролей. Роли передаются списком values.", "type": "text/plain" }, "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2dffbe43-af69-4c4e-b4dc-57ddc4776ff5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0de7a341-d9f0-4b82-a5fe-1bfdf0026f56", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4f0674d-0145-4c05-96e7-ecdcfd00f3ff", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6811d9ec-13e5-4bef-b5ed-c541a9275119", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef803d04-de5b-4adf-b938-d6def0858604", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61cca0ef-0460-453b-ae6b-dc9902d0c912", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a44bc05b-0da5-404f-8728-59cdea45faa2", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"fields\": [\n \"\",\n \"\"\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"value\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8468237a-0fa2-4bab-b0d9-b516b3fb3638", "name": "Загрузка файла-вложения", "request": { "name": "Загрузка файла-вложения", "description": { "content": "**Добавление вложения, которое можно будет использовать в теге attachments для таблиц шаблонов**\n\n---\n\nсм. POST /report_templates и PUT /report_templates/:template_id\n\nСохраняет файлы на диске, присваивая ему id. \nФайлы сохраняются с именами: \n\"/attachments/\" + attachment.id + \".\" + extension\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:** \nВозвращается модель вложения\n\n```\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 ```\n\nДля получения вложения нужно использовать запрос GET /attachments/80a201ea-67e5-4cd9-aea5-591128d2855a.doc", "type": "text/plain" }, "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c680cccf-6019-48c2-a4f9-d40d313d8d31", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "82112f3c-0e8b-405f-84f3-fea44646637c", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85c22ace-8328-4503-b786-b3dc177a9390", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34d47f0b-ff91-441e-a6ba-9a64c108e005", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a74a222d-a53d-44d1-98e2-3e82e8af622f", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77241fb9-c412-4223-8ffc-1e5f52212ff5", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c241e7d9-5f5a-43a8-b745-e9da0114c700", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "attachments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d434c048-4483-4a3e-a2f0-17ad4d74beaf", "name": "Скачивание вложения по ID", "request": { "name": "Скачивание вложения по ID", "description": { "content": "**Получение вложения**\n\n---\n\nПосле создания вложения через метод POST /attachments возвращается json c url - его нужно использовать для получения файла", "type": "text/plain" }, "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d0a78571-945a-49f7-825e-316257a71665", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7e95e16e-0c7e-451b-8517-ae2d90cf255e", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b648b1ed-cfd5-48d6-a00b-46b3bc5d3e73", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9397af1a-c21f-4b51-bc78-3dcf41f40856", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ec02da9-317b-4ee4-9a54-044a27643bc4", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91645401-deb3-42cd-8cec-297bf70c87dd", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afdc647f-abc1-4949-ae30-69e4aabf9c28", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "attachments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID сущности", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2000d022-698e-4ad3-8c13-84fb7c5174bb", "name": "Восстановление удаленного объекта мониторинга", "request": { "name": "Восстановление удаленного объекта мониторинга", "description": { "content": "**Отмена запроса удаления по уникальному ID**\n\n---\n\nЭтот ID приходит в теле ответа на запрос удаления. см. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:** \nPUT /cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\n\nВозвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d97250fe-0c5d-40eb-b8fd-c1d1c26c2b20", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "57957e06-a65a-4056-b6ea-c3948cbb194f", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e760e3af-cdf9-489b-9039-fbbe7ce416e1", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3420d611-e118-499a-be5e-75944d357ae8", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "015c8f4a-b807-47e0-9674-52a2694b47ae", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "900a9a5e-6ce1-4966-ab16-18c71e6522c6", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2bbb0da-413f-443c-950d-b518ad8cb567", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "87d2f8a0-2610-4e3f-9b71-f4d61a037d5f", "name": "Восстановление удаленного пользователя/роли", "request": { "name": "Восстановление удаленного пользователя/роли", "description": { "content": "**Отмена запроса на удаление по уникальному ID**\n\n---\n\nЭтот ID приходит в теле ответа на запрос удаления. см. DELETE /company/users?ids=:ids\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:** \nPUT /auth_cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\n\nВозвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "30832f81-7d36-4d49-8554-63382956309b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "79767a08-bc60-4d0a-bd81-bb10136f0a7d", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7819bc4a-fab1-4fe5-911b-98d7ed4bea29", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6aedfbc-65d2-4126-8a26-5e8e4f595f97", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "703c48ce-fb80-42b1-b8f6-3b0a11c74725", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b14dae3-f682-4f42-82bb-2934a3cb7283", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d546fa3d-5f6d-4900-a5ac-032b213671e6", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "auth_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного пользователя/роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "95224957-70bf-4b8e-af6d-5302ff929189", "name": "Восстановление удаленного мобильного трекера", "request": { "name": "Восстановление удаленного мобильного трекера", "description": { "content": "**Отмена запроса на удаление по уникальному ID.**\n\n---\n\nУникальный ID приходит в теле ответа на запрос уделения.\n\nсм. DELETE /terminals?ids=:ids или DELETE /retranslators?ids=:ids\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:** \nPUT /mtracker_cancel_delete/80a201ea-67e5-4cd9-aea5-591128d2855a.doc\n\nВозвращает 200 в случае успешной отмены, в противном случае - 422 с текстом ошибки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4f16d100-dfa1-4c72-a76a-6d4c54dd5a24", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ba22a7f2-29f5-469c-af22-3e67f0ec4b0f", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71902d90-13c3-42ce-8e4b-6f79191fe61b", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4412733e-dbf0-4926-8ad2-bc2a7f2797e0", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55588981-7c67-4c91-818b-8285a5c1f4aa", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e28e1990-77ee-447b-b394-fe034530c6cb", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfb181e7-6924-40c2-8070-142c24597ad2", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "mtracker_cancel_delete", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID удаленного мобильного трекера", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d58f7ac2-66a3-46e2-966e-c504d8ae6419", "name": "Отправка тикета в техподдержку", "request": { "name": "Отправка тикета в техподдержку", "description": { "content": "**Отправка письма в поддержку интегратора**\n\n---\n\nТело запроса:\n\n```\n{\n \"subject\": \"тема письма\",\n \"body\": \"текст сообщения\"\n}\n\n ```\n\nСообщение отправляется всем сотрудникам интегратора с ролью \"Редактор тарифа\". \nОтправка доступна всем пользователям Компании.", "type": "text/plain" }, "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "dfcd864f-9dde-4a71-82d1-cb69f026c990", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "35958bc5-65a0-4b1a-aeb0-d50f330f90e2", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbc2eda6-05a5-4d06-a5f1-fb39891bed0b", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a00895fb-80a3-4472-b2ec-67889d2aea96", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40323632-c48a-4197-969f-51c58e841ce3", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90f407df-473b-442b-bdb7-a8214f12ddfb", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91e95218-2877-43a2-a7bc-8671fead83a1", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "support" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"subject\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Компания", "description": "Методы связанные с компанией", "item": [ { "id": "cf8e11d9-2135-4198-accb-8265b876917e", "name": "/company/users/:id", "request": { "name": "/company/users/:id", "description": { "content": "**Удаление пользователя из компании**\n\n---\n\n**Параметры:**\n\nid - ID пользователя\n\nВ админ панеле можно удалить из определенных компаний с укзанием списка компаний в поле companies\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n``` json\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 ```\n\n---\n\n---\n\nОтвет: Пусто 200 \nЕсли пользователь с таким id не найден, то возвращается ошибка 400\n\n```\n{\n \"id\": [\n \"Недопустимый параметр\"\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bec1fb51-a286-4adb-998c-c7b371310031", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "02ef555b-cd42-44d8-b389-3147b329b41e", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42214d00-3174-4e42-9410-1bfde0b8c7e8", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a96ee59-0de2-44fc-851a-6090a4ef20f5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cc778dd-743a-4225-8820-f899883d401e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68daf498-36ca-436b-82c1-bd90e98ab55e", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID пользователя для исключения из компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8f4ddc2c-290c-4807-b895-c43c09f7d98a", "name": "/company/users?ids=:ids", "request": { "name": "/company/users?ids=:ids", "description": { "content": "**Планирует удаление пользователя с доступом к текущей компании по их id.**\n\n---\n\nЕсли пользователь удаляется из последней компании, то создается новая компания, где у него роль Admin.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:** \nDELETE /company/users?ids=456dc493-5983-478b-90cc-5bca0bfe708c,05f6bb8b-84cf-4553-951a-c5cca0be7220\n\n---\n\n**Параметры:**\n\nids - список Id пользователей\n\nПользователь должен обладать правами Admin, иначе возвращается ошибка 403.\n\n---\n\n**Ответ:**\n\nСтатус 200. В теле ответа id задачи на удаление, с помощью которого можно отменить удаление через роут PUT auth_cancel_delete/:id \nЕсли хотя бы один пользователь с таким id не найден, то возвращается ошибка 400\n\n```\n{\n \"id\": [\n \"Недопустимый параметр\"\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fbb61114-fc9f-4f31-a809-a68af81636a0", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3e618a9c-8bfe-4a47-8193-cecb39f2a7fe", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4eebbd13-1a6b-4252-81cb-04a2712169d2", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da35424a-6582-44a2-897b-5a0f76636df1", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8ba8e7c-bf79-43c7-a91e-b9277bee96c7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ceeae068-c261-4ce2-8063-8c759d34331e", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1d749fd8-abf6-4ee8-ac95-c81324fea224", "name": "/company/change/:id", "request": { "name": "/company/change/:id", "description": { "content": "**Переключение в компанию по ссылке**\n\n---\n\nВ cookies пользователя сохраняется сессия компании, переданная через параметр `:id`, после чего происходит перенаправление на главную страницу приложения.", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0eccca78-15b2-4930-89d5-bd16b020d3ba", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ea3863e0-9e3f-489b-8ea5-14123c95f371", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aafa7c40-b9e9-4c90-a4a3-f23fed706573", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d444308-6220-4d1f-903d-d19110e1c0f6", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f6d70c3-c1cb-43d3-9d68-168f8f5ec54a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11729589-3971-4469-9cd6-555a7c72c28c", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9569a266-d23f-4adb-b40b-4ebc298ee4a7", "name": "/company/change/:id", "request": { "name": "/company/change/:id", "description": { "content": "**Выбор компании пользователем**\n\n---\n\nВ cookies пользователя прописывается новая сессия\n\n---\n\n**Пример запроса:**\n\nВ качестве id может использоваться только id доступной пользователю компании из списка companies в сущности user, см GET /me\n\n**Параметры:**\n\nid - id доступной компании пользователя.\n\n---\n\n**Ответ:**\n\nВозвращает код 200:\n\n```\n{\n \"id\": \"75bd17cc-642f-4c7c-982e-e0e991907733\"\n}\n\n ```\n\nВозвращает код 422 в случае если id не валидно:\n\n```\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Вы не имеете доступа к выбранной компании, попробуйте перезайти.\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8d9a3b86-c763-4bab-abaa-c8002f48bc9d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "86e76ea0-d1af-4356-aa47-b942e75a343d", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba9bd752-c88c-4ae4-a518-d0d9a41afcbf", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44af46f7-8684-432e-b1a6-9ee05e4875ee", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9d9177c-1095-409a-b128-a11769d0c0bf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20286d99-a032-4cb3-8b14-87ce7abe5880", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "change", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании, на которую переключается активная сессия", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "39e83f8a-723e-4274-8873-dd78ed37fefc", "name": "/company/:id", "request": { "name": "/company/:id", "description": { "content": "**Изменение параметров компании**\n\n---\n\nИзменяет атрибуты компании. Доступно только для пользователей, у которых доступ к компании на уровне Admin.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nВ качестве id может использоваться только id доступной пользователю компании из списка companies в сущности user, см GET /me\n\n```\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 ```\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
\n logo для компании выбрать из поля small.url\n\n\n ```\n\n---\n\n**Ответ:**\n\nВозвращает код 200 с body:\n\n```\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 ```\n\nВозвращает код 422 в случае если id не валидно, body :\n\n```\n{\n \"code\": 4022,\n \"field\": \"id\",\n \"message\": \"Вы не имеете доступа к выбранной компании, попробуйте перезайти.\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5f905507-8306-45a4-ba31-d96cbb257120", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "53659041-2560-4b90-b708-b356d1c63d37", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cec1d9ed-ba49-4dca-aed5-e8fa6d120801", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc9a960c-a0ce-4ab3-8f1b-f0a4b1877915", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9d3b425-c64a-4469-a80a-cb3d37d989e2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b183b099-e85c-4beb-9614-07fe8b029067", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"auto_kill_sessions\": \"\",\n \"dateformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"dealer\": {\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n \"efis_retranslate\": \"\",\n \"forbidden_layers\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"holidays\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"strong_password\": \"\",\n \"timeformat\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"timezone\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "86997478-c26d-4b21-a6ae-5b30d95b887e", "name": "/company/invite", "request": { "name": "/company/invite", "description": { "content": "**Приглашение пользователя в систему**\n\n---\n\nМетод создает ссылку и отправляет ее на указанный email. По ссылке можно авторизоваться.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПараметры:\n\n```\nemail - email того, кого приглашаем\n{\n \"email\": \"support@example.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\n---\n\n**Параметры ответа:**\n\nКод 200. Даже если пользователь с указанным паролем не существует. Ответ всегда такого вида\n\n```\n{\"code\":200,\"message\":\"На указанный email была выслана ссылка для восстановления.\"}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b7babb9f-0f0f-46e4-99a5-0c2363697f21", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "58937ca2-9845-4586-9c20-d90fc68fef70", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44db6b2f-17fb-4341-abf6-64d814b8ad3d", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a44458a-9ed3-4959-94a1-bbc75c3cf500", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49407db9-7b77-42f5-b488-88f9ae318e26", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7de6e58-3d80-4237-af61-ef0e0a3112a7", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e5a514db-f201-4528-a251-b4d77f5c5d03", "name": "/company/create", "request": { "name": "/company/create", "description": { "content": "**Создание пользователем новой компании**\n\n---\n\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\nПри создании вместе с первым пользователем требуются дополнительные поля:\n\n\"userProviderId\": \"[support@example.com](https://mailto:support@example.com)\", // email пользователя \n\"type\": \"EMAIL\", \n\"password\": \"your_secure_password\", // пароль \n\"name\": \"Имя пользователя\",\n\nЕсли в запросе присутствует поле `userProviderId`, это означает, что компания создаётся вместе с пользователем.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"company_name\": \"A company X\",\n \"timezone\": {\"key\": \"UTC+3\"},\n \"imeis\": [\"3424324324\", \"657657657\"]\n}\n\n ```\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2ab3dae5-2cec-4d18-816b-19e0e450ff7d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ea3d4d73-979e-428c-923d-96375a7ffc1f", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5d358fb-5b15-4b51-8649-1a0c943c9a46", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8ea3876-b6e5-41c6-a8f8-f85202da7b51", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae63b9ba-124c-4189-a860-7ccbc822dc2e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2f4d088-b824-4615-806a-59c705d277cc", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"timezone\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f0092c5c-9b49-4a22-a6e7-c45be06c0944", "name": "/company/sessions/query", "request": { "name": "/company/sessions/query", "description": { "content": "**Получение сессий пользователей компании**\n\n---\n\n**Роль:** Администратор и выше.\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ae0a565c-4a7d-4704-becc-5558e0a12f66", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "aded741e-a6fe-4c03-9e24-34aa379ee68a", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "283a6873-6350-4f6d-9e0c-63bf03c317d5", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcfc7819-df81-4dbc-858c-b780ea4035df", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32afc1e2-4d98-4937-bb06-d751f27fa180", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "28513418-bab5-4975-a2fd-b669ea35321f", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5cdc892e-d877-4908-912b-4109084a41ad", "name": "/company/:id/sessions/query", "request": { "name": "/company/:id/sessions/query", "description": { "content": "**Получение сессий пользователей компании из админ панели**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\nПараметры запроса:\n\nid - ID компании\n\n```\n{\n \"from\":\"2020-10-01 00:00:00\",\n \"first\":0,\n \"count\":100\n}\n\n ```\n\nЗапрос данных ограничен периодом в один месяц", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "91004c09-662b-44ee-bb8d-375b0f254ecc", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e70bafda-0c47-4688-8803-3645f0faf54d", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "593ddf74-512f-437c-828c-d4c289a574fc", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15e9d721-e640-4422-b164-b38ad81683cc", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d9d4d66-c487-43b0-bb76-8b9598a84ac7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f8a014a-e446-402b-be22-98f5871e7c95", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "sessions", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"first\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e229aa37-bfac-4ece-b9d6-26be5fbde463", "name": "/company/updates/query", "request": { "name": "/company/updates/query", "description": { "content": "**Получение истории изменения сущностей**\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПример запроса для одной сущности:\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 ```\n\nПример запроса для всего справочника units:\n\n```\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\nЗапрос данных ограничен периодом в один год\n\n**Возможные параметры:**\n\nmax_rows - максимальное количестов строк.\n\nfrom - дата-время от какой выдавать данные, необязательный параметр. По умолчанию - текущее время минус 7 дней.\n\nto - дата-время до какой выдавать данные, необязательный параметр. По умолчанию - текущее время.\n\nfirst_row - первая строка, необязательный параметр. По умолчанию 0.\n\nmax_rows - максимальное количество строк в выдаче, необязательный параметр. По умолчанию 10000.\n\nobject_id - если нужно запросить изменение по конкретной сущности, используйте id нужной сущности, необязательный параметр.\n\nobjects - по каким типам сущностей возвращать историю - users, units, company, unitsgroup, units_trailers, geozones, report_templates, notifications, routes, trips, trailers, mailings.\n\nsortField - имя поля для сортировки результатов, возможные значения: created, user.name, operation.\n\nsortDesc - true, если надо соортировать по убыванию.\n\nvalue - искомый текст.\n\n---\n\n**Пример ответа:**\n\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\": \"support@example.com\"\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\n ```\n\ncreated - дата время\n\nobjects - тип сущностей\n\nuser - автор изменений\n\noperation - операция PUT, DELETE, POST - изменение, удаление, создание\n\nobject_id - id объекта\n\nmsg - текст", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9ca92ce5-9582-439c-8e02-85da45039ab2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "590f69f1-39bb-4b51-b622-64fd2e927273", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e1b9177-12d1-4958-9ee5-ea15fa581c3d", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6e1a93c-4564-48ff-94b2-cef7cc392e5b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8de4c6f9-0e5c-4b09-a650-50491161d80f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "330efbab-2e72-47b3-89d2-1864d7bf0f09", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a4624f03-97cb-47c5-b540-43ec14131001", "name": "/company/schedule_delete", "request": { "name": "/company/schedule_delete", "description": { "content": "**Удаление компании**\n\n---\n\n**Параметры:**\n\nids - ID удалаемых компаний.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"ids\": [\"acce8268-e0ef-4fda-a6ea-89ed23ffae50\"]\n}\n\n ```\n\nПока можно удалить только одну компанию в одном запросе.\n\n---\n\nЕсли все ok, тогда запланируетсяудаление. Его можно отменить с помощью роут POST /company/cancel_delete", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f7b773de-2171-4046-8fec-d31d1dfa2a52", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f9dc3f75-50ff-4d2c-8186-c82af41a7957", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5003eac7-1713-4e81-baaa-634401924f4a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "074ad2cc-e402-41de-b541-bcbf074ba978", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "116a1141-8476-4fff-aae9-eb94a55977fb", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3c56ea5-eadd-4f64-be8e-9bad39e6cc66", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "schedule_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c5ccf7d1-e38c-4143-8872-b59b3f5db375", "name": "/company/cancel_delete", "request": { "name": "/company/cancel_delete", "description": { "content": "**Отмена удаления компании**\n\n---\n\n**Параметры:**\n\nids - ID удаляемых компаний.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"ids\": [\"acce8268-e0ef-4fda-a6ea-89ed23ffae50\"]\n}\n\n ```\n\n---\n\nЕсли все ok, тогда удаление отменяется.", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7a658d51-0b60-451d-8624-ed40aae637b2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4db233cb-07c2-4c1d-aa75-fb76284065d1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecde62d4-2cc5-4c7a-ad18-69658321ed69", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4005f573-b43c-4f74-9e2c-171db19fbd43", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3020487a-8b01-4965-b586-55df579b2eae", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53215683-080d-40b9-be3c-8be1fa78981e", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", "cancel_delete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "846bd676-534b-43cb-ad07-996e30e4eafd", "name": "/company/:id/roles", "request": { "name": "/company/:id/roles", "description": { "content": "**Получение доступных ролей для компании**\n\n---\n\nid - ID компании\n\nВозвращается массив ролей\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nGET [https://api.skif.pro/api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/roles](https://api.skif.pro/api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/roles)\n\n**Пример ответа:**\n\n``` json\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e2af3a92-20b9-4b44-bba0-ad2fb08a935a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "63ca7ac0-c568-4574-861a-2d97d52dbc49", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e62b44c6-9912-48a9-92ea-e710ddad1f77", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bb5584f-d054-4aa2-ad4b-c882f107e2d2", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1183bbb3-f442-405e-991b-1830b1ab0932", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cb06ae3-2fd0-448f-b132-58e8adc6c0e1", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5a705428-7b90-4285-9d58-2edaed6603cb", "name": "/company/:id/addable_users?search=:search", "request": { "name": "/company/:id/addable_users?search=:search", "description": { "content": "**Получение списка пользователей, доступных для добавления в компанию**\n\n---\n\n**Параметры:**\n\nid - ID компании.\n\nsearch - текст для поиска.\n\noffset - индекс первого элемента в странице.\n\ncount - количество в странице.\n\nВозвращается массив пользователей с полями id, name и email.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nGET /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/addable_users?search=test1\n\n**Пример ответа:**\n\nmax - общее количество\n\nlist - список пользователей\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3b99373d-a39c-42f4-850a-9c8f48febb43", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "34aecba8-b987-4e28-806d-1a29c10650c6", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ccea3305-7035-4ca7-95d8-b6cdd4c8271c", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1c07888-0ee6-408a-bb66-0167f828c331", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af52fae2-645e-4333-ac31-b6b236ab503d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cdea171a-e152-4b41-bb10-7805f65ccb7e", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "addable_users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "текст для поиска", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "индекс первого элемента в странице", "type": "text/plain" }, "key": "offset", "value": "" }, { "disabled": false, "description": { "content": "количество в странице", "type": "text/plain" }, "key": "count", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2363a5b4-4488-43bb-807c-568ada0c02d4", "name": "/company/:id/add_users", "request": { "name": "/company/:id/add_users", "description": { "content": "**Добавление существующих доступных пользователей в компанию**\n\n---\n\nid - ID компании\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/add_users\n\n**Пример тела запроса:**\n\n``` json\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 ```\n\nВозврвщается ответ со статусом 200 или ошибка", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bc1588b9-a221-4965-b6b9-341d83a1724a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "efff6c70-fbc1-41b8-9a81-48e910f119d0", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be5763ee-ce8d-419d-81ab-e9e0b69bf235", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfb068ac-6a70-4fc5-81c3-f0844714a7c9", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c6d564f-b4bb-4099-8d0b-1d1f9d6b0842", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e098ffa6-8c82-4407-8d03-6610c8fd78cf", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "add_users" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": {\n \"key\": \"\",\n \"value\": \"\"\n },\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8b6bdc7f-9eb3-413d-9452-fcfffbec140d", "name": "/company/:id/users?ids=", "request": { "name": "/company/:id/users?ids=", "description": { "content": "**Добавление существующих доступных пользователей в компанию**\n\n---\n\nid - ID компании\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/add_users\n\n**Пример тела запроса:**\n\n``` json\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 ```\n\nВозврвщается ответ со статусом 200 или ошибка", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "79458846-9991-45a5-9304-9718b99ebda0", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d980c7b3-d0f1-4e72-bdef-ea494e1e54e1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec4797c7-07dd-4026-9353-15ce03201d2e", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94ff6635-ea88-4645-8711-b19d7bb63d9b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce33f3e9-6c72-4e31-8634-364c676e6e01", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e121b7ae-7563-4516-9525-207b9b940f3f", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "users" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID пользователя", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6853c14d-361a-456f-9068-cd701ff206ad", "name": "/company/:id/properties", "request": { "name": "/company/:id/properties", "description": { "content": "**Получение настройки для компании**\n\n---\n\nGET /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nВозвращается ответ со статусом 200\n\n```\ntrack_gradation - цветовая градация трека\nstyles - массив стилей\nmax - максимальное значение скоорости\nhex_color - шестнадцатеричный Код Цвета\nmonitoring_sensors_settings - настройка датчики для мониторинга\nname - название, строка\nsensor_name_mask - маска датчика, строка\nicon - ключ для иконки, строка\ngradation - цветовая градация, такая же структура как в track_gradation\n\n ```\n\n**Пример ответа:**\n\n``` json\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bec66602-25eb-4842-b1d0-356e9958b82b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "28f80a9e-c89b-4df5-8630-edd6b7bce6b0", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c244094d-953c-4b06-a7b2-f431289d4443", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa96786f-09e8-4b74-a347-53bbfb8e42b2", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b11ed4a-ef08-43dc-b973-2beae100c57b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7853b35f-e47c-4415-a088-0e44a3af6f36", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7d4092f1-8171-409b-ae22-15d3bad3fead", "name": "/company/:id/properties", "request": { "name": "/company/:id/properties", "description": { "content": "**Обновление настроек компании**\n\n---\n\nПараметр запроса:\n\nid - ID компании\n\nТело запроса JSON:\n\n```\ntrack_gradation - цветовая градация трека\nstyles - массив стилей\nmax - максимальное значение скоорости\nhex_color - шестнадцатеричный Код Цвета\nmonitoring_sensors_settings - настройка датчиков для мониторинга\nname - название, строка\nsensor_name_mask - маска датчика, строка\nicon - ключ для иконки, строка\ngradation - цветовая градация, такая же структура, как в track_gradation\n\n ```\n\n1. **Пример запроса на обновление цвета трека:**\n\n\nPUT /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties\n\n``` json\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 ```\n\nВозвращается ответ со статусом 200 или ошибка\n\n```\ntrack_gradation - Цветовая градация трека\n styles - массив стилей\n max - максимальное значение скорости\n hex_color - Шестнадцатеричный Код Цвета\n\n ```\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПример тела ответа:\n\n``` json\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 ```\n\n**2\\. Пример запроса на обновление настройки датчиков для мониторинга**\n\n``` json\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c152a644-4286-4b01-99aa-a13f26bf4522", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0c86b92b-3199-420d-a1c6-550e897ec867", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9f19fea-27d0-4627-a394-2ea5d5da5ee5", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0d4a59a-a1d7-4bd2-87a0-44dfbb492ce4", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2551e1e1-88cf-4f49-9306-920aa76019d7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b52f1b4-1f1f-4b12-b816-285cde3495f0", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"track_gradation\": {\n \"styles\": [\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n },\n {\n \"hex_color\": \"\",\n \"max\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bee44b22-7784-4f35-9519-312e41346b1a", "name": "/company/:id/properties/copy", "request": { "name": "/company/:id/properties/copy", "description": { "content": "**Обновление настроек компании**\n\n---\n\nПараметр запроса:\n\nid - ID компании, из которой необходимо скопировать свойства\n\nТело запроса JSON:\n\n**companies** - список компаний, на которые копируются свойств, см. пример \n**properties** - список свойств, которые копируются \nвозможные значения:\n\navailable_maps - Доступные карты \ntrack_gradation - Цвет трека \nmonitoring_sensors_settings - Цветные индикаторы датчиков в мониторинге\n\n1. **Пример запроса на обновление цвета трека:**\n\n\nPUT /api_v1/company/3e70f167-9fad-4753-bccf-d7d47c2c648c/properties/copy\n\n``` json\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 ```\n\nВозвращается ответ со статусом 200 или ошибка\n\n**Роль:** Администратор и выше.\n\n---", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "03330a74-0f26-4bac-8f1a-305074ff78b1", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f5f0a350-ffa9-437a-98fb-6172abefdfc0", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8adcf3f2-9023-4a0d-b2d3-67d4ba145172", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "241ee6ac-d994-4c0a-8d09-14d944347690", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f8b9aec-43d1-46c5-aab9-b7e32bc099f1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fec1e2c-7fa2-478d-b52f-95a9f14a05ff", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "properties", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании для копирования настроек", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"properties\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ea3e63c6-e6ae-4b91-b901-09bc1d73b8ac", "name": "/company/:id/updates/query", "request": { "name": "/company/:id/updates/query", "description": { "content": "**Получение истории изменения сущностей из админ панели**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\nПример запроса для одной сущности:\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 ```\n\nПример запроса для всего справочника units:\n\n```\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\nЗапрос данных ограничен периодом в один год\n\n**Возможные параметры:**\n\nmax_rows - максимальное количество строк.\n\nfrom - дата-время от какой выдавать данные, необязательный параметр. По умолчанию - текущее время минус 7 дней.\n\nto - дата-время до какой выдавать данные, необязательный параметр. По умолчанию - текущее время.\n\nfirst_row - первая строка, необязательный параметр. По умолчанию 0.\n\nmax_rows - максимальное количество строк в выдаче, необязательный параметр. По умолчанию 10000.\n\nobject_id - если нужно запросить изменение по конкретной сущности, используйте id нужной сущности, необязательный параметр.\n\nobjects - по каким типам сущностей возвращать историю - users, units, company, unitsgroup, units_trailers, geozones, report_templates, notifications, routes, trips, trailers, mailings.\n\nsortField - имя поля для сортировки результатов, возможные значения: created, user.name, operation.\n\nsortDesc - true, если надо соортировать по убыванию.\n\nvalue - искомый текст.\n\n---\n\n**Пример ответа:**\n\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\": \"support@example.com\"\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\n ```\n\ncreated - дата время\n\nobjects - тип сущностей\n\nuser - автор изменений\n\noperation - операция PUT, DELETE, POST - изменение, удаление, создание\n\nobject_id - id объекта\n\nmsg - текст", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "26c0cc88-f0dc-4cc3-a0b7-32708dfbf8cd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d20aca25-73a9-40ac-9b6b-ef972e21f0ef", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5fb549d-ea2b-467c-9e4b-80df736e77f7", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79ef017b-1025-4935-8371-1e8ce0c5b278", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a067d0c8-23b7-414a-8568-06184e18a38d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dacd435c-0c35-4cbc-8202-8fa27e1b2aca", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "updates", "query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"objects\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Геозоны", "description": "Работа с Гоезонами", "item": [ { "id": "9f97ae1d-34ae-4800-b58c-a867f7d389ee", "name": "geozones/custom_types", "request": { "name": "geozones/custom_types", "description": { "content": "geozones/custom_types", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9e416bfa-6406-4715-b2d6-21ea84f8a81c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "71d390e7-06d1-4335-b112-f089e68cdc62", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd507668-ee41-49e6-b609-a3289b90ad92", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "675fe8f5-e950-4abf-adaa-721de36082a5", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01af954d-c1f4-43ce-a957-82bb8da2bdba", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "881eae2b-71af-4e66-8eb5-c5551b72cae6", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7855dbaf-b026-4605-a074-d1136b7c2675", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a49c7342-9923-4264-b081-ad9b2d277cf1", "name": "/goezones?ids=", "request": { "name": "/goezones?ids=", "description": { "content": "**Получение геозон**\n\n---\n\nВозвращает массив всех геозон.\n\n---\n\n**Ответ:**\n\nЕсли запрашивается по одному id - вернется не массив, а один объект.\n\nЕсли запрашивать по конкретному id - вернётся даже удаленная геозона.\n\nЕсли запрос без id (просто GET /geozones), то удаленные геозоны не отобразятся.\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "39c0dc75-e483-4912-9bb9-fd09390103d3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bb0805d7-a407-4d54-8af4-3a7efb32b050", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b211e84-9d2a-48fe-8207-3c74e953f5d2", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c80b03a-2bc2-48ec-adbd-a50430e092fe", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1207502-d99e-4809-a1c4-a2de6c841aac", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e01f3fc1-79c8-4e03-afa0-c90273b1d04e", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fccfe343-573f-49cf-af32-feeff4306e42", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f94cb89e-6175-4e9a-bf24-d419a65ded71", "name": "/geozones", "request": { "name": "/geozones", "description": { "content": "**Создание геозоны**\n\n---\n\nДобавляет новую геозону, присваивая id.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Параметры:**\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\n**Ответ:**\n\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bd8f044c-6f1c-4496-969a-7da08b308884", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "82768f37-5e86-4fff-a294-2e8a676a2c35", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "642c0eb4-841c-4637-84dd-7e2b4a0f505f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25974607-80a3-45d7-8d72-20f857a3681c", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a1a27f5-565d-440e-b38c-f2e6753980be", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d7871dc-7c37-4380-b589-32024cec290b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a9eb662-3f75-4284-a7a9-8a24c8854814", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\"\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "64051c96-c9dd-4a93-8b34-b5d2de6047d1", "name": "/geozones?ids=:ids", "request": { "name": "/geozones?ids=:ids", "description": { "content": "**Планирование удаления геозоны**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "544c19a6-1a54-4109-9d01-90c5767d7837", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a78e9202-ad31-418f-984e-1300b4fe988a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c07b9a5b-ef17-4cd8-a185-4b5dc7b50ec1", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac85d954-36cf-4e08-b949-fbfa049e0721", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0c09642-4a2a-442b-a549-bfb238b86952", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0be7159-6053-459f-bc10-54539d09a480", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e914188-a4c4-428b-b1e9-63c91a95d451", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4c2eecc6-e758-4b31-8fcd-5b7561cae3c1", "name": "/goezones_on_map", "request": { "name": "/goezones_on_map", "description": { "content": "**Получение геозон для отображения на карте в виде geojson**\n\n---\n\nВозвращает массив всех геозон, которые нужно отображать на карте.\n\n---\n\n**Ответ:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e5827522-1e3d-4330-b87a-4d1787647eb3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5a38d91c-f515-4774-b63c-682971ab95bc", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53651764-8e90-4009-b72d-d18f3d3e77f7", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e97a529-0a68-4692-958e-7524e24e383b", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51e3bea1-8651-4d92-93d8-8b4600c5e283", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7c23508-02b9-4685-8c58-3ba4cf988516", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa63e6ad-a3cf-41f0-952c-fe3fdb222536", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones_on_map" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0a788ba2-80c7-46c9-9edf-10d07916b23e", "name": "/geozones/:id", "request": { "name": "/geozones/:id", "description": { "content": "**Обновление данных геозоны**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nСм метод POST /geozones\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /geozeons", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d924c945-5ead-4199-a880-2e6def2d8845", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "88263c8c-1ee0-4add-a483-12f3e2f4f538", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7fd5d17d-9a1d-4e58-b0f9-a650e57a95e3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99730424-ccef-4cb3-8367-b11efe20d916", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be1caf57-8126-4e74-9982-1fe4faa7a4a3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4a8dd64-be3b-4023-bb70-b5b86897f6db", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49edc1e0-9373-4492-af0b-4354a500a92e", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "007b081f-6c24-4d1f-b112-25496380be1d", "name": "/geozones/:id", "request": { "name": "/geozones/:id", "description": { "content": "**Удаление геозоны по ее id**\n\n---\n\n**Параметры:**\n\nid геозоны\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\n200 и удаленная геозона\n\nЕсли геозона с таким id не найдена, то возвращается ошибка 400\n\n```\n{\n \"code\": 4000,\n \"field\": \"id\",\n \"message\": \"Недопустимый параметр\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0accf332-83f7-47cb-b841-98b27e119aca", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b4058162-f03f-45a1-9c8b-83dc5744e4a9", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16fd49ec-cf25-4641-9fb1-dd12b6623568", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9325011-56d4-4603-a497-f1fd8d7af88a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e18aae1-9b15-43c9-8fc2-32d5127d2768", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d6ef9f1-4680-487c-ba07-c45cf28bf96a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15333780-ca2e-4dfd-b901-50954623dddf", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f504d30f-a3e0-43be-bd0a-9cdcdcb52608", "name": "/geozones/:id/all", "request": { "name": "/geozones/:id/all", "description": { "content": "**Удаление геозоны по ее id во всех компаниях в админке**\n\n---\n\n**Параметры:**\n\nid геозоны\n\n---\n\n**Ответ:**\n\n200 и удаленная геозона.\n\nЕсли геозона с таким id не найдена, то возвращается ошибка 400.\n\n```\n{\n\"code\": 4000,\n\"field\": \"id\",\n\"message\": \"Недопустимый параметр\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "39553490-4093-4306-898c-8f3507ab1853", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "45fc57b0-6dfc-4032-ab98-23b74c94429b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d3474366-c31b-4cd5-a89b-5792fa11e389", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a72bad9-8263-45a8-b8cb-04207400a287", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50cae4c3-5746-47fe-b023-d0ee323ca14e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26321e02-2437-4593-9006-d2676bb2dcb3", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db3d3e5e-3941-445e-a997-50e9f3aa08e8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "all" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор геозоны (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aeeed1aa-5cbb-4621-824e-a5b501cc0562", "name": "/geozones/list", "request": { "name": "/geozones/list", "description": { "content": "**Получение геозоны по фильтру**\n\n---\n\nАналогична запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[name, created, is_delete, icon.key, color.key, type.key\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - name (можно искать по неполному слову), icon.key, icon.type, color.key, color.type, type.key, type.type\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 геозон, отсортированные по возрастанию по имени, которые имеют тип \"point\" и иконку \"school\"\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "22913e6f-19b3-47a4-a472-609c3300822b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6c2de608-21f7-402e-adb4-9c29ea318d0f", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e32291d-7769-49ed-aae7-d8cdeb9a0fd4", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3179d7cb-699c-4804-9ade-0002ed46282e", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5a9e0d6-1698-4e90-bb89-9da277f432e6", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20e933a6-3f8c-485b-8f9a-f802689bddc4", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "971e4bf7-8c41-436a-a4ad-a6bc9751770d", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "25a1696d-64c4-4392-a695-c8d4b178dd4b", "name": "/geozones/line2polygon", "request": { "name": "/geozones/line2polygon", "description": { "content": "**Генерация координат для линии**\n\n---\n\n**Параметры:**\n\nwidth - ширина\n\ngeometry - координаты линии\n\nВ ответ возвращаются координаты полигона в поле polygon_geometry\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9b0d2729-4635-4371-a54b-f6d7554437a9", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d0cb752e-8c53-4116-96d1-519b3a0ea98d", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83483689-edb9-43f7-8051-fc7fa63ede59", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95b51a65-01e1-478e-b356-b1d7bfc7620a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5aa14883-b4b6-4959-958c-5fd14348844f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1a6ec4a-934f-43fa-ba18-06d2a6ad475e", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7efe40a-4583-43ee-a24e-241afad1ad31", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "line2polygon" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geometry\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"width\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2f45bf25-371d-4ef0-b871-b0adec40f895", "name": "/geozones/export_kml", "request": { "name": "/geozones/export_kml", "description": { "content": "# Экспорт геозон в .kml\n\n---\n\nВ теле запроса укажите требуемые геозоны в geozones. Если geozones не указаны, то запрос формируется для всех геозон компании. Для группы геозон geozones_groups\n\n---\n\n**Роль:** Читател и выше.\n\n---\n\n**Пример запроса:**\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---\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\n**Ответ:**\n\nВ теле ответа возращается kml файл", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "252bbb07-c1fd-4124-93ed-6080ece7e275", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "056783ab-5162-4c93-a031-c4023306ef2a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1b3df00-751e-42ed-ab71-3e6cc3b0176d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cde8617a-1e1c-43ac-94a9-b744bc387177", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "734fba62-931b-4222-9874-faca59a566b2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe200d39-0383-482d-be23-8f1ba496eb8f", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ddff33c2-f282-45a3-b57a-a83fb9a073be", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "export_kml" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f211f7e3-f2be-4ff9-b6a0-6fc19bc26923", "name": "/geozones/:id/add_to_groups", "request": { "name": "/geozones/:id/add_to_groups", "description": { "content": "

Добавление геозоны во множества групп

\n
\n

В теле запроса укажите требуемые группы геозонов в geozones_groups.

\n

Роль: Редактор и выше.

\n
\n

Пример запроса:

\n

POST /geozones/efa8cf52-7eb9-426d-a08e-d79f837ac30a/add_to_groups

\n
{\n    \"geozones_groups\": [\n        {\"id\": \"036ae8ee-94b3-453e-a25b-0bb4fd8dc119\"},\n        {\"id\": \"d2a01c30-8ed7-4289-a8be-c6054f6fde36\"}\n    ]\n}\n\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a5236cd1-9ae8-49f4-92db-23ba2230f260", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9d288274-332e-4481-8894-625ef2ef817e", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7f886ff-4149-46bc-b8f4-506b87957bc9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ddb20454-f927-476b-a4bf-5b99ce17a3cd", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24fb9faf-d263-497a-8402-4bf6e29411d5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8fba75fe-0ed2-49a7-908a-2f6334df24cf", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e28f8c5-4831-42cf-8cc7-43c09c7d10e4", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "add_to_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa46e6d9-45cc-47e2-b9e7-cc43307e9c94", "name": "/geozones/:id/remove_from_groups", "request": { "name": "/geozones/:id/remove_from_groups", "description": { "content": "

Удаление геозоны из множества групп

\n
\n

В теле запроса укажите требуемые группы геозонов в geozones_groups.

\n

Роль: Редактор и выше.

\n
\n

Пример запроса:

\n

POST /geozones/efa8cf52-7eb9-426d-a08e-d79f837ac30a/remove_from_groups

\n
{\n    \"geozones_groups\": [\n        {\"id\": \"036ae8ee-94b3-453e-a25b-0bb4fd8dc119\"},\n        {\"id\": \"d2a01c30-8ed7-4289-a8be-c6054f6fde36\"}\n    ]\n}\n\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c0d523e8-eb88-4161-8994-9acb7cabe1bc", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a67237c6-38f6-44fd-a872-f65f62b80dd9", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73ee80a6-28a2-40b4-acaa-8b41301dd78f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2790c803-9e35-4158-91fe-cd3cb0bb5d41", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bca8e1f2-cc94-4a0a-9e91-1356567d9a40", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3916f95b-f2a4-41f3-b1dd-a79f33d090ea", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "356dc275-0026-4476-81c8-488397389bb3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", ":id", "remove_from_groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр id", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Пользовательский тип геозоны", "description": "", "item": [ { "id": "a07b4d64-4fa6-4411-86ae-4997f048cab1", "name": "geozones/custom_types", "request": { "name": "geozones/custom_types", "description": { "content": "geozones/custom_types", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d7df95b2-2132-4611-8838-3c81c9359495", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "961cd1c7-8591-467c-999f-0864d951b1f4", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11d458ff-f424-4dc6-9887-314467095b9c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48ceb574-7795-44b3-aec7-42087deaaaf8", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c14ee5f-c6fd-4d63-831b-668ad7c713f1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3f51f6f-b7db-4199-933f-a1c3210d324a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "496f0212-55aa-422f-8661-55e2727620aa", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozones", "custom_types" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"name\": \"\",\n \"photo\": {\n \"original\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n },\n \"small\": {\n \"height\": \"\",\n \"param_type\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Группы геозон", "description": "", "item": [ { "id": "f9d21956-1eec-4baf-8911-519f2c37660d", "name": "/geozonesgroup?ids=geozone_id", "request": { "name": "/geozonesgroup?ids=geozone_id", "description": { "content": "**Получение группы геозон по id**\n\n---\n\nВозвращает группу геозон\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2d24ac0b-390d-4374-9415-df034a55a103", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ea236b13-e629-4acd-965b-c87aa755c9b9", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "017d8c5d-9122-425f-b89c-f83d967bea79", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7159abe-7b5d-4115-a90c-60f457795b46", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3dfc58f1-3c2c-4df3-b9fd-0bddb66c49a2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67940c20-8d87-4016-96d1-fc6338d4d912", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54ae42cc-6399-4846-b12e-5964ad7e05dd", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b4f037f0-5037-45c0-a72b-8fd147b5ffc1", "name": "/geozonesgroup", "request": { "name": "/geozonesgroup", "description": { "content": "**Cоздание групп геозон**\n\n---\n\nВ body необходимо указать id геозоны, которая будет в группе и ее имя.\n\n```\n{\n \"name\": \"geozoneName\",\n \"geozones\" : [\n {\n \"id\" : \"geozoneId1\"\n },\n {\n \"id\" : \"geozoneId2\"\n }\n ]\n}\n\n ```\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "52938b14-5865-4118-b3c2-765c82555d4f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "62bcccac-1d8a-4cac-9ee6-9c1df3429507", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f96383df-6e9b-4d2e-b9b4-199b864bca65", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "118dc787-47ee-4973-bab8-4142bc372151", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2829875a-8bb5-47c8-b136-0f4f71e28797", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a197c21-2d56-40e2-b6ee-ee127c5220fe", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9424fa36-5c51-4287-b646-ba56c273bf99", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b980d98b-0ec0-45eb-a037-b158557cea30", "name": "/geozonesgroup?ids=geozonesgroup_id", "request": { "name": "/geozonesgroup?ids=geozonesgroup_id", "description": { "content": "**Планирование удаления группы геозон**\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "77aa0bdb-86f3-45ad-b4a3-c8391e63b471", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c5aa967f-6f9a-4853-b7f6-2dd88989fd54", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f1e107a-08c8-44b7-b011-624f15249f5d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1756a03-11ee-4ffa-b865-b65b5ed79c98", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb6de5bb-2dbe-4e7c-9604-554d1a8f0702", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17ed2ddb-c622-4a1b-aba8-9e80f3faa49d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2568dccc-a01c-4a32-9b35-731fda0ad1d8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b19782c-e95a-48ff-981e-496bd11e1b91", "name": "/geozonesgroup/list", "request": { "name": "/geozonesgroup/list", "description": { "content": "**Получение списка групп геозон**\n\n---\n\nПоля:\n\nВ fields указать нужные поля.\n\n```\n{\"fields\":[\"geozones.id\", \"geozones.name\"]}\n\n ```\n\n---\n\n**Ответ:**\n\ngeozones.id - Id группы.\n\ngeozones.name - имя группы.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "75fe5369-8fdb-46ef-a18c-f9f4bde67966", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "82ed1929-af4d-4e14-b00a-4e1be26f7275", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "187fc7a2-dad0-44d6-9dd3-166e1922ddad", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f8a03d2-3dce-42a5-bfc0-2f8174819415", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2bf101b-eeab-48b1-a580-3cb7476bb632", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "daca1d8e-ce61-4bdd-8590-080051b77150", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7099035-0f73-40cd-8abf-cbbfb8875473", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1b32613d-5db4-4d38-8560-ccf474389953", "name": "/geozonesgroup/:geozonegroup_id", "request": { "name": "/geozonesgroup/:geozonegroup_id", "description": { "content": "**Удаление группы геозон**\n\n---\n\nГруппа удаляется физически.\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "geozonesgroup_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5d907454-d4c2-4c0a-956c-03b4f84606a1", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "239f4705-ec8e-4610-860d-07d959239fea", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08789b02-6569-43ad-9ce4-da4fb4935ee2", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c259a82f-d0ec-4e3e-981f-aabe1be3b162", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdba9d22-368b-4477-a564-ea75c2ba9efe", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f620b02f-1ef9-4c21-8fab-f2a07882462a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ff6aa9b-c838-4e5e-8003-9b130e0ad6be", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b2fc134f-4aba-4521-a0f8-cbf4a568d54a", "name": "Обновление группы геозон", "request": { "name": "Обновление группы геозон", "description": { "content": "Обновление названия, цвета и списка входящих геозон.", "type": "text/plain" }, "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "geozonesgroup_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "028c0519-a5f9-4846-b76a-614275f2fa20", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fe7dce3f-2b3c-4bea-9259-dc99876ce6c6", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b062521b-1aa6-4c53-8a11-b1aa9c253a02", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c31a4206-8bed-41a9-9aad-c6501f984cd1", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89daefa3-5ab9-47c3-9e22-e5708c094cd0", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "820dba56-80d1-43b8-aa81-9336fa1a6610", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "487d7ac0-dc7a-4bd4-8d60-3c91a18b98b1", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "geozonesgroup", ":geozonesgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы геозон (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "geozonesgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Маршруты", "description": "Работа с Маршрутами", "item": [ { "id": "bbc6b16b-0edd-459f-aa08-cdece77449ad", "name": "/routes?ids=", "request": { "name": "/routes?ids=", "description": { "content": "**Получение маршрутов**\n\n---\n\nВозвращает массив всех маршрутов.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Ответ:**\n\nЕсли запрашивается по одному id - вернется не массив, а один объект.\n\nЕсли запрос без id (просто GET /routes), то вернутся все маршруты.\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5b27b866-c54b-4437-836c-68b511b365da", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0e12f303-a2fb-4543-a756-d22133a7d90f", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1c4f6db-86cf-46ea-b83a-dc8f8157267f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "017fd029-5aa1-4daa-b34f-41b16ac9399e", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd2d87ff-ce0c-4f72-9dbe-58f15252579c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02d16ede-9a12-483b-ab7d-db046ee7b19a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f87714e-5ea5-48f3-b14c-7dbf6077fd60", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ebb3ffd4-5d1b-4d3d-bd22-9d36020c61ba", "name": "/routes", "request": { "name": "/routes", "description": { "content": "**Создание маршрута**\n\n---\n\nДобавляет новый маршрут, присваивая id.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Параметры:**\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\n**Ответ:**\n\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "afc99e91-b95f-43eb-9ef5-720d4584dea3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2ea9767b-3a91-4bad-bc08-a8b1d4f6bcea", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2da96a84-11cc-4fb0-b95f-20db3e45d87f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35c6949a-ee3b-4865-a2f3-fc7cebbeacf5", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd223973-a963-4b49-a3bc-9dd2a3815710", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60bd20ab-3020-4ce2-862b-a29925542f36", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e50871cd-6951-44fd-ab84-128c0ecbf709", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dc692030-007d-4b49-bac1-965a77078a96", "name": "/routes?ids=:ids", "request": { "name": "/routes?ids=:ids", "description": { "content": "**Планирование удаление маршрута**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a58d7a35-bb5a-41b9-a8e7-368a45039941", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "49f22967-a937-4018-91a5-755d0a597b7f", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25267e69-1c95-4da8-8856-17fd14e5e2f1", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5c6b7a8-be11-41e4-b8f3-6c3f217e2f7d", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59989ff3-1893-43e3-b532-1d39ad2a82d0", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45002322-d51c-46d9-ba72-03897aadd15f", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0e7811f-e211-4568-a443-76ebbf5e23c2", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "36aad8eb-761b-436a-9ce8-47a9bbe6e2c9", "name": "/routes/:id", "request": { "name": "/routes/:id", "description": { "content": "**Обновление данных маршрута**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nсм метод POST /routes\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /routes", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2b8b45c2-03c0-4a79-a346-4e245adb5c5f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "90f61881-f396-44cf-8284-b6a6537bace2", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5010dba-5898-499f-bfaf-6cea67502b19", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64d39019-7265-478f-bc89-cc64abb430de", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac9635be-dfc2-44e1-80c9-ef694b33413e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6837c7b-b009-40d7-89c1-ae678ad33e71", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8caa10e-01b3-4578-9cc5-b379ee615992", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"points\": [\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n {\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9207e98f-ba13-459a-97f1-67d2c5df786e", "name": "/routes/:id", "request": { "name": "/routes/:id", "description": { "content": "**Удаление маршрута по его id**\n\n---\n\nУдаляет маршрут\n\n---\n\n**Параметры:**\n\nid маршрута\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\n200 Удаленный маршрут\n\nЕсли маршрут с таким id не найден, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1182cfce-770f-42d4-a4cc-9ea1333554d4", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ae3f1813-e18c-41d4-bace-662e866b3093", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ae4f09e-5165-4371-989c-29e1ecf598fa", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad3e5e0f-57b9-4102-a03d-4d3bfb6feebc", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa93d21b-dedd-4084-8418-3dd3d00eb797", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05eeb42a-7e17-4a25-88a4-bbec7210cb8f", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4ec14f2-ea6b-4689-b1b2-ac4ae06b8aa8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "64d6f94d-f767-4913-aae6-a524031c1bc7", "name": "/routes/list", "request": { "name": "/routes/list", "description": { "content": "**Получение маршрутов по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[name, created, is_delete, icon.key, color.key, type.key\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - name(можно искать по неполному слову), icon.key, icon.type, color.key, color.type, type.key, type.type\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 маршрутов, отсортированные по возрастанию, по имени, которые имеют имя \"route2\"\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "139515b6-03e0-4813-b755-012b6ad2dfb5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7f2a99f3-552f-41b9-8f55-6ea5e34040c6", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e181650b-1469-4a3c-a117-1f48e2b45db5", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9743292-2c23-4dd9-9e6c-5dc38d7c730a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "deb9d6f1-ad6c-4c07-aed2-b27a93adce9c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8daf9cde-2164-4ffe-8c7d-b067de98ba98", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d689a395-24eb-4261-82ff-714058bb95e3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "routes", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Рейсы", "description": "Работа с Рейсами", "item": [ { "id": "2cd25438-4088-4a03-bd55-7238a5743d26", "name": "/trips?ids=", "request": { "name": "/trips?ids=", "description": { "content": "**Получить рейсы**\n\n---\n\nВозвращает массив всех рейсов.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Ответ:**\n\nЕсли запрашивается по одному id - вернется не массив, а один объект.\n\nЕсли запрос без id (просто GET /trips), то вернутся все маршруты.\n\n```\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\": \"Рейс №101 (Доставка)\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "70386ba6-436f-4ed8-8205-4461bc2e98f6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "686c8da9-26a2-4bbf-9ad6-54599e92d9ab", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e865f35-7e6f-48ce-bbb5-df8385d76572", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7cc0be2-49dd-4ddc-91d1-14b50c79a782", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73474dd2-8d57-4997-a6d5-8abe2dc0fccc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f497355-d777-4f8e-884a-a4fc7c42d293", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a4fb92e-2283-4fb5-a84c-7432fa45aadf", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0badbd02-f1e9-425c-b3ef-a73a5b9cb063", "name": "/trips", "request": { "name": "/trips", "description": { "content": "**Создание рейса**\n\n---\n\nДобавляет новый рейс, присваивая id.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Параметры:**\n\n```\n{\n \"name\": \"Рейс №101 (Доставка)\", //название, обязательное\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\n**Ответ:**\n\nВозвращает созданную запись и ее id. Пустые поля не возвращаются.", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d5c232d3-8000-41cf-8ae2-e1648290ab51", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "73966b90-d43f-4aa1-8585-66ee409a96b5", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e03acb3-9907-4210-be36-9a5ce36306df", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04f39ec6-d35a-4257-9bec-a41956f55714", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c432e030-c882-49f1-a05b-65e1fbb1d085", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5aca5c5-5a88-411c-85e4-895bc1c12ccf", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d1c576a-87b2-45a4-9824-8d1ba8a45482", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\"\n },\n \"dates\": [\n \"\",\n \"\"\n ],\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1f4b6462-404a-425e-baa8-dcb336992ae2", "name": "/trips?ids=:ids", "request": { "name": "/trips?ids=:ids", "description": { "content": "**Планирование удаления рейсов**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4ab6c61a-e15b-4749-a496-416d2306f1cc", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "46f00c94-127f-485c-a942-eb28f775cb62", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5e89624-4ff3-4c04-b060-224241ea4df9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "833bd9f0-0f04-478e-b0e1-56543dbcaa95", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cfb3a91-0324-458a-a624-c46a8f99ebd0", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "059648f4-55ab-40fb-9e1e-d51f80c6ac7f", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fde9555b-cacf-418d-9c4a-108470b25d47", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b5c6038-b3f2-4489-83d0-a77b2895e06b", "name": "/trips/:id", "request": { "name": "/trips/:id", "description": { "content": "**Обновление данных рейса**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Параметры:**\n\nсм метод POST /trips\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /trips", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "83747d78-cc5a-4153-bbbe-79898f7d4109", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4b528fe4-9584-4885-b5e4-571db9de8945", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "389fde0d-2101-4ca1-bdc1-4fea42e400c1", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "149f7d79-ee5b-41c1-8eaa-c7ba203c4bbe", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7449ca1a-8df9-4ce6-913b-f57f509d1dcf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07195aa1-ec1f-4c52-9330-20d20df3eaf5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92e57b62-d9c2-4a7f-9b86-6d8f10a4cd15", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"activation_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"company_id\": \"\",\n \"dates\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"name\": \"\",\n \"passage_order_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"points\": [\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"arrival\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"coordinates\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"departure\": {\n \"after_days\": \"\",\n \"deviation_minutes\": \"\",\n \"time\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"unit\": {\n \"id\": \"\"\n },\n \"user_id\": \"\",\n \"work_types\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6a40584e-8495-4ade-9035-326cdb59dd92", "name": "/trips/:id", "request": { "name": "/trips/:id", "description": { "content": "**Удаление рейса по его ID**\n\n---\n\n**Параметры:**\n\nid рейса\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\n200 Удаленный рейс\n\nЕсли рейс с таким id не найден возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1add4caa-576e-41ff-a79e-3b77e95ced36", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "41d81e3f-1b1d-4984-8eb8-26be37455799", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a17b6e74-1efa-4e3c-8f86-d446538fe07b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e652e18-e29c-4d85-8560-d995ce657fe2", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "360002ad-8dc6-404e-ac98-a161a7186fea", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c9bb624-ec25-4af7-909e-06757a5eea42", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "031dceb4-cf21-4b75-8838-034746e0f6b6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7c2d3655-a280-448c-9e45-69387ccabd81", "name": "/trips/list", "request": { "name": "/trips/list", "description": { "content": "**Получение рейсов по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[name, created, is_delete\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - name (можно искать по неполному слову), unit.id, user_id, activation_type.key, passage_order_type.key\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 рейсов, отсортированные по возрастанию по имени, которые имеют ID объекта 7e1aaba2-625a-4a4c-b765-9934bec5a096\n\n```\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---\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\": \"Рейс №101 (Доставка)\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "55aa14d7-7f1f-4805-a9db-2eb6fbe24063", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a48bf7e2-97d7-447e-adf4-cd9384136c00", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "869316a8-c0cb-4562-a3b1-2cf5f1f8599c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "701f1e99-a625-44ad-a14a-2c95684af5e9", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5dd6963c-707f-4fbf-8210-74cffb1a8ee8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f002520f-2075-4be9-879d-fa52b9cb4aae", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7435443-57f9-4d2f-a6cf-ed1cb6f66bb2", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trips", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Объекты", "description": "API по работе с Объектами", "item": [ { "id": "bbb6e62e-bc80-4d97-88d4-b647ef0fa506", "name": "/units?ids=:ids", "request": { "name": "/units?ids=:ids", "description": { "content": "**Поиск объектов по ID (через запятую)**\n\n---\n\nВозвращает массив объектов. \nЕсли параметр 'ids' пустой (т.е. запрос = 'GET /units', без параметра), то вернётся список всех объектов по всем компаниям пользователя, из которого исключаются удаленные юниты. Если ids не пустой (т.е. запрос = 'GET /units?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных юнитов.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный объект.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\nПример ответа:\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\":\"ТО-1 (Замена масла)\",\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\":\"ТО-1 (Замена масла)\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0c84b621-8faf-4430-b74d-07b5871bc28b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "55e5cf3a-b4a9-4f93-85e5-d105edf11eea", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2a2e7b0-0739-4732-bebe-0ce418ba95b9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71312698-74df-487a-ac6e-9463ebc42df0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb76d1ec-5b3b-4b65-b098-15bc47b8f44a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f217c815-e39e-401e-817a-8215684b905b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2278df1-3d13-40a7-8cc8-1950596ad0fa", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b1e2530-d545-4edf-98a3-efc0b26c335d", "name": "/units", "request": { "name": "/units", "description": { "content": "**Создание объекта**\n\n---\n\n**Параметры:**\n\n```\n\"name\": \"Автомобиль обычный-1\" // Номер, наименование объекта,\n\"type\": {\"key\":\"transport\"} // Тип объекта (из dictionary, все ключи с типом 'unit_type'),\n\"terminal_type\":{\"key\": \"navtelecom\"} // Тип устройства (из dictionary, все ключи с типом 'terminal_type'),\n\"imei\": \"862531040000001\" // imei устройства\n\"phonenumber\": \"+79990000001\" // номер телефона\n\"phonenumber2\": \"+79990000003\" // второй номер телефона\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 ```\n\nПо доп. полям смотрите [GET /custom_fields](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#05ee6204-6755-48ec-aeac-ba53f1041e9e)\n\nОписание param1, param2 сенсора: Данные параметры являются опциональными и если пользователь их не заполнил, то передавать их вообще не надо. Перед сохранением param1 и param2 происходит пересчет их внутренних калибровочных листов (калибровкиAB и КалибровкиXY). Лист КалибровокAB и лист калибровокXY у конкретного параметра взаимосвязаны и порождают друг друга по определенным формулам, т.е. из листа калибровок XY можно вычислить лист калибровок AB и наоборот.\n\nВ связи с этим РЕКОМЕНДУЕТСЯ перед тем, как сделать запрос, предварительно использовать метод [POST /units/sensors/recalc](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#e6cca9ca-c162-4c2a-ae5b-a762aa3a6500) для пересчета этих листов и передавать в calibrationABlist и calibrationXYlist результат работы этого метода.\n\nПосле создания, создается объект с привязкой объекта к компании пользователя.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример ответа:**\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 А123АА777\",\n \"terminal_type\": {\n \"key\":\"navtelecom\",\n \"type\":\"terminal_type\",\n \"value\":\"navtelecom\"\n },\n \"imei\": \"862531040000002\",\n \"phonenumber\": \"+79990000002\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2e84df23-99f6-4fac-a7a0-f41ba48507cb", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "36af6f4c-cbe9-4b95-9b6a-e541a24f9baa", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88083710-55a8-44ea-b511-4f6d197a7fdd", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06d265f4-aa4a-4ac9-ab78-8f1e33e529b7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "698070eb-9c46-4175-b9a2-ffddf7cb13af", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acabc4b6-1a95-4fff-86fb-23d289e0d3e6", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c69eb435-bf57-4c05-9193-0847d454ae03", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1da4f0b4-3c82-4d1d-bb5f-6e26f230022b", "name": "/units?ids=ids", "request": { "name": "/units?ids=ids", "description": { "content": "**Планирование удаления объектов**\n\n---\n\nПланирование удаления нескольких объектов, в ids указать список идентификаторов удаляемых объектов.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:** \nDELETE /units?ids=eece8fbc-0bad-4a2d-ac24-62573860dda0,fd848416-bf81-4a92-9c01-922b2da4dd5a\n\n---\n\n**Пример ответа:**\n\nВ случае успеха - ответ '200', в теле ответа ID задачи удаления, с помощью которого можно отменить удаление. \nВ случае ошибки - ответ 422, в теле текст ошибки.\n\n```\n{\n \"id\": \"ace239ee-b7ab-42ee-9d57-d749a23987c6\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d1ae99a4-663c-465b-a2e2-1bc98add2953", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8061f8a2-b1d4-48ac-a997-15c4963a37b2", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7a867d3-a21d-4b4c-8fbc-f44bc27d9064", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b8785b7-e20b-4683-aaec-ce8c30c34580", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "160940f1-ff78-4456-8b64-de647fa6859b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d01231b-c818-4fd3-b580-a0950c0d3a1c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49f2bf6a-1ca6-4e35-ac5c-0013686a12b6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "86039c8c-66a3-4b60-9895-3bdd448cecb1", "name": "/units/:unit_id", "request": { "name": "/units/:unit_id", "description": { "content": "**Обновление объекта**\n\n---\n\nДерево объекта должно быть полным (с обновленными полями). Поля, которые будут отсутствовать в запросе, затрутся на null.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\nТот же, что и при [GET /units](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#8d9df07b-752a-4b59-ac91-219b25539c4e) - возвращает обновленное дерево объекта.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6de8e9f7-055c-4b4a-8361-754cd626abe1", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "91b74da0-cb55-4047-a4fe-d3ea46f1b70b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19d8c63a-7c79-423d-8961-9bc30189e642", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54af8814-8eb7-4c8c-a61d-5d714a28c384", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e4795db-6435-401d-aac7-6dbd51509ccb", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6625b782-cbf6-4faa-8da1-73e5701c6aae", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69d15eb0-5624-4b7a-ad14-8bbca8baa9c3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n },\n {\n \"custom_fields\": [\n \"\",\n \"\"\n ],\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n },\n \"user_id\": \"\"\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"id\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"id\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_in_monitoring\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"width\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units_groups_ids\": \"\",\n \"units_groups_names\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fed90873-1636-46e8-8f32-c68938a8ff04", "name": "/units/:unit_id", "request": { "name": "/units/:unit_id", "description": { "content": "**Удаление объекта**\n\n---\n\nФизически объект не удаляется из базы - флаг is_delete переводится в состояние true (необходимо для возможного восстановления объекта).\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\nВ случае успеха - ответ '200'", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "db8956df-ff1d-4c6c-84a0-49c5a989eff3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9c74e453-760a-46b6-9dec-038e22184686", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90944265-5f6e-4225-9670-b4eac223008d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "302dba8a-36cb-4955-b629-2f175d97f223", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e909ebb3-3043-4819-96bd-5ee2d7b01fa5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec565602-6264-49fa-8387-ae21e6af6766", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b40c13d2-3945-4a47-a1e3-8519e7a6a9fa", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "904a42b6-a7b6-4411-8ef0-d693f251cde2", "name": "/units/:id", "request": { "name": "/units/:id", "description": { "content": "**Обновление указанных полей объекта**\n\n---\n\nПока можно указать только custom_fields\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:** \nPATCH /units/836db03e-7475-4628-9323-0ca506e2061f\n\n```\n{\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 ```\n\nСписок все возможных custom_fields [GET /custom_fields](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#05ee6204-6755-48ec-aeac-ba53f1041e9e)\n\n---\n\n**Ответ:**\n\nТот же, что и при [GET /units](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#8d9df07b-752a-4b59-ac91-219b25539c4e) - возвращает обновленное дерево объекта.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9c89af15-1f3d-4d1a-a965-c55c67d4f31a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5016fdcf-9d89-43c0-af7f-a8541168a4ba", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a40e9d12-41f4-4406-8e1d-c2a46e4baa63", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd788763-dc8b-45fe-94b4-73922c4fd9b4", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1da63a92-4aa8-4e4c-93c8-5b0fbdebdb47", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2ce6b3f-8947-46c7-a0fc-228a2f685a1c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff437b09-0ab9-4131-b539-9d615b6f53f7", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b202b02-8ac3-497e-99f7-a9dd0f765871", "name": "/units/recovery/:unit_id", "request": { "name": "/units/recovery/:unit_id", "description": { "content": "**Восстанавливает ранее удаленный юнит**\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:** \n200 OK", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "41d1a8fc-d45f-4ba4-90b9-1e77159306c5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e42193d6-561c-43b3-a057-427bfbaa7fff", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99bfabc9-6cab-4b4c-8331-55ffb670764f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7e868ec-be7a-4951-a6b2-2ce4ba0f2ccf", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c4fe34b-44a7-4d15-a56d-7b5b5dac612e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8e07734-09f8-4978-86c5-e4d03284802d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b97dc8e0-8cbe-4486-bb1e-86748d4b12d9", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "recovery", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f04f47fc-02d8-4ed1-99cc-7040e923e7b4", "name": "/units/physical/:unit_id", "request": { "name": "/units/physical/:unit_id", "description": { "content": "**Удаление объекта безвозвратно**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\nВ случае успеха - ответ '200'", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f37951c8-094f-4451-92a4-3ffa60cc660a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c78f5114-4835-43c9-9268-10d2907b1dd4", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4cdf944d-8393-4475-a0a1-987307d201ca", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be855b1c-4728-4bc3-8ab9-0bc65e44be27", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8dcc6f17-63fd-4b94-b87e-8c2cbb7b20c1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94a337ea-8626-4422-b9e8-dde86f9e1bc5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "440527ca-24df-4395-9c91-11362bf7f404", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "physical", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "829ab2dd-fa45-48d3-b8db-3a6e5b0d27c8", "name": "/units/services?ids=:ids", "request": { "name": "/units/services?ids=:ids", "description": { "content": "**Поиск сервисов по ID (через запятую)**\n\n---\n\n**Пример ответа:**\n\nВозвращает массив найденных сервисов. Если параметр unit_id пустой, значит данный сервис не привязан к какому-либо юниту.\n\n```\n [\n {\n \"id\":\"e257e819-5d09-4da2-8ee4-9c072fef6de0\",\n \"unit_id\":\"2bcd95c4-d520-4203-89fc-b0d3a76a7d6b\",\n \"name\":\"ТО-1 (Замена масла)\",\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\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7ef0190e-4ba1-402e-bd09-ee0dd10a2eeb", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1964dece-7ddf-4fde-af3a-ac1342f16550", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "218e2f24-faa0-4d84-a334-b1a4ac14ac40", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "28c19603-24ab-4d7f-a9ff-eed9d388d86f", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9447253-7875-4145-bd45-270ee9b1e768", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f371a11-e0f5-4ba7-8395-ccd987ff2ddc", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6dff7f8-33fb-4eaf-a26f-0c32ecf0a81c", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3769fd2f-49a2-4100-baa3-98d7ce34eac0", "name": "/units/services", "request": { "name": "/units/services", "description": { "content": "**Отдельное создание сервиса (без привязки к юниту)**\n\n---\n\nТо же самое, что и метод (POST /units/:unit_id/services), но без привязки к какому-то конкретному объекту.\n\n\nОтвет будет аналогичен методу выше (POST /units/:unit_id/services), но поле 'unit_id' будет пустым.\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8f3fa8fd-59aa-4328-ab1b-e1b6dc825019", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2618243a-f050-4d69-9bc9-6cfab89df81d", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29840807-ae5c-418f-96fd-f3ba8bba05ab", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f5ca3ae-bac1-4fa8-bdc8-0a63fe57e62a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af8aaa1c-c66a-4c25-8ff4-636601cfa3a1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eab54235-c7f4-47f3-9565-326b4a3a4412", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66e5481a-d1b8-488d-8277-c092e76626e3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b79edd0e-ce19-404f-82c2-caac1910ec0e", "name": "/units/:unit_id/services", "request": { "name": "/units/:unit_id/services", "description": { "content": "**Поиск всех сервисов юнита**\n\n---\n\nВозвращает все привязанные к юниту сервисы.\n\nОтвет аналогичный [GET /units/services?ids=:ids](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#6dce08c8-6982-4b3e-b8fb-34fe9aca5790)\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "684fa2b0-592f-4d0a-8bee-81839f1c9cd1", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e42fc8b6-c235-4b6b-b5fc-72e9a92467c2", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f42288b5-8c2b-4ef6-a238-2d31a5e83283", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cbdcc2d-9fa6-4b95-b30f-06da55495c8a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5d0474d-cdc9-4293-947b-e9d55b9e1121", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56199071-93f5-4820-b2d7-da57b36bc1df", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54ed2802-dd26-4518-816c-53f1efa48c07", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ad7d3a9-d12c-49a7-9d1b-27464ebf9111", "name": "/units/:unit_id/services", "request": { "name": "/units/:unit_id/services", "description": { "content": "**Отдельное создание сервиса (с привязкой к юниту)**\n\n---\n\nДанный вариант создания сервиса позволяет создать сервис для юнита через отдельный функционал и привязать их друг к другу, используя json форму только сервиса.\n\nТакже его можно создать при создании юнита ([POST /units](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#8d9df07b-752a-4b59-ac91-219b25539c4e)), заполнив в json'е юнита поле 'services', без указания id сервиса. Это позовлит создать и юнит и привязанный к нему сервис одномоментно.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\nПример создания сервиса для юнита с id = '4ca6ed64-3b58-493c-9ac9-862fe1a01f88' по УРЛу /units/4ca6ed64-3b58-493c-9ac9-862fe1a01f88/services:\n\n```\n{\n \"name\": \"ТО-1 (Замена масла)\" // наименование сервиса,\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---\n\n**Пример ответа:**\n\n```\n {\n \"id\":\"2c705ae1-d99c-4be3-b564-8db5ac387caf\",\n \"unit_id\":\"4ca6ed64-3b58-493c-9ac9-862fe1a01f88\",\n \"name\":\"ТО-1 (Замена масла)\",\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "04205f0a-f0a8-41b3-bfd8-d8a1ae5d4a31", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dd8e4438-6c90-42fe-8655-e066efa8a8c7", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d94e7dd7-e55b-4ddf-bb4b-368b296dee09", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e5f2863-531c-43b6-8feb-2d9a2a6183f2", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab7b26de-e2a0-4a84-9c36-77947ae8457e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9235d541-8ac2-400a-b58e-cadb583c6b44", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7accee01-375e-4315-99f9-b3e77b62c5e6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"intervalKm\": \"\",\n \"intervaldays\": \"\",\n \"isActiveDays\": \"\",\n \"isActiveKm\": \"\",\n \"lastKm\": \"\",\n \"lastdays\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2ac3c27c-3387-4c7e-b8fb-2d7932474eca", "name": "/units/sensors?ids=:ids", "request": { "name": "/units/sensors?ids=:ids", "description": { "content": "**Поиск датчиков по ID (через запятую)**\n\n---\n\nТо же самое что и в Сервисах [GET /units/services?ids=:ids](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#6dce08c8-6982-4b3e-b8fb-34fe9aca5790)\n\n---\n\n**Пример ответа:**\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ced49810-3e4d-4fe8-a099-c04de9402e2c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "40aca343-967a-4862-9956-70951f9f1ce8", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2925cfa7-89ef-4be1-9b7f-2a748619d37d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a768dcac-e085-4447-ba29-e88b636ea9fe", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebe7aa4a-1791-4df2-8106-a2f5bf71429b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "205ddf42-07f8-40f6-8098-c4384f283c7d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86bd67b0-cc7a-434d-b1a0-9fb98eada1d9", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c4a2ba00-795f-4fee-babe-a820db1ee43a", "name": "/units/sensors", "request": { "name": "/units/sensors", "description": { "content": "**Отдельное создание датчика (без привязки к объекту)**\n\n---\n\nАналогично [POST /units/services](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#3b7ade96-3cc0-4f96-b90b-2935f1ace7d1)\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6ad8b622-47c6-475d-8aaf-2b975d275f42", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2ff5927c-b3cc-4295-95aa-e6dd692ad122", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1cf1f48-86b0-4d85-afbb-1b739aae605e", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52d982a4-d579-4883-918e-90bf9c323813", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64bca544-c4b1-42e9-bc99-6a7e1241f900", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6410407b-ef53-4419-8933-96301109c320", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcc99ed2-b1ab-48c5-a0c3-fcc67586eaf2", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8e99a28b-1274-4deb-a327-59b5ac1bf6eb", "name": "/units/:unit_id/sensors", "request": { "name": "/units/:unit_id/sensors", "description": { "content": "**Поиск всех датчиков объекта**\n\n---\n\nТо же самое, что и в Сервисах [GET /units/:unit_id/services](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#b114d108-11f0-433f-8e58-40d4ae7d6c58)\n\nОтвет аналогичный методу выше [GET /units/sensors?ids=:ids](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#862c1e9e-5ac4-4145-a9bf-66b5644fa8f8)\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3b12176b-c28f-4602-971f-c0910936b347", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "329eaa90-7205-4172-a6bf-c9f9b9e5fcde", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3dfca254-2ca3-4a51-b331-9d294a9e770f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5b62e32-6da2-486d-81aa-a1f1dfd995ae", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1da46aa9-c3bb-466b-895e-355f6c7d1497", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "268c6917-143b-46ff-b856-cda5b68b4473", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b4ef4b1-799e-4b10-888f-b3a4a10cb8f2", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f0059e68-9ac1-4dcf-8535-af6cc98e607a", "name": "/units/:unit_id/sensors", "request": { "name": "/units/:unit_id/sensors", "description": { "content": "**Отдельное создание датчика (с привязкой к объекту)**\n\n---\n\nАналогично [POST /units/:unit_id/services](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#b1ffc9b0-1783-41ca-bf97-a6227919c280)\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\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 ```\n\nОписание param1, param2 сенсора: Данные параметры являются опциональными и если пользователь их не заполнил, то передавать их вообще не надо. Перед сохранением param1 и param2 происходит пересчет их внутренних калибровочных листов (калибровкиAB и КалибровкиXY). Лист КалибровокAB и лист калибровокXY у конкретного параметра взаимосвязаны и порождают друг друга по определенным формулам, т.е. из листа калибровок XY можно вычислить лист калибровок AB и наоборот.\n\nВ связи с этим РЕКОМЕНДУЕТСЯ перед тем, как сделать запрос, предварительно использовать метод [POST /units/sensors/recalc](https://documenter.getpostman.com/view/13147/RztmtVLV?version=latest#e6cca9ca-c162-4c2a-ae5b-a762aa3a6500) для пересчета этих листов и передавать в calibrationABlist и calibrationXYlist результат работы этого метода.\n\n---\n\n**Пример ответа:**\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "82d7afdc-6613-4e96-9aaf-5990afd3376c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5100f430-82ea-46b2-9643-90d39f36a47b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4474ad22-7732-42f0-836e-47be6c2c06a3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1234b44-0c7b-4a81-8512-8977bd1b9ac5", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95e4cc3c-67ac-4b32-bc72-2a20854fe75f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2bbed1c8-15a3-418f-9cea-9d42c6006907", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c663b1e-339d-4179-8a50-80bc57c2c2e1", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "sensors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f4ad7d66-e0fd-43a9-9e12-cb0e66ece84f", "name": "/units/sensors/recalc", "request": { "name": "/units/sensors/recalc", "description": { "content": "**Пересчет calibrationABlist или calibrationXYlist**\n\n---\n\nМетод для пересчета calibrationABlist или calibrationXYlist. ДАННЫЕ НИГДЕ НЕ СОХРАНЯЮТСЯ. Метод изолированный, создан как вспомогательный. \nВ теле запроса передается массив, либо calibrationABlist, либо calibrationXYlist\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\nПример запроса с calibrationABlist:\n\n```\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 ```\n\nПример запроса с calibrationXYlist:\n\n```\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---\n\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 ```\n\nлибо, если ошибка, со статусом 422.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d541c158-c77e-4919-acb0-dddf54c05be9", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2c183ae7-779f-42ae-9a83-cfde37b0cb78", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c1ae9bc-67c4-4055-9fb8-cfa7005275af", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "687358ef-97b1-4ae8-a42b-49f8b949aea7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1468b9b-8ddf-4c97-a7d3-2aee8ca5f215", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f751572-3cc9-4f6d-ab2b-c61e98826720", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc93443f-e2ce-469d-8153-4650d6b67938", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "recalc" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2322f831-e79d-4ecc-b855-d10b5af07a06", "name": "/units/sensors/validate?terminal_type=", "request": { "name": "/units/sensors/validate?terminal_type=", "description": { "content": "**Валидация списка датчиков**\n\n---\n\nВ запросе отправляется массив датчиков . \nterminal_type - ключ терминала объекта.\n\nВ ответе, если всё успешно, возвращается статус `200` с пустым телом. В случае ошибки возвращается соответствующий код ошибки и её описание.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bb0cda13-0ec4-444f-9521-b74fc74d32d3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "10995799-0c80-483a-8059-43584891bd31", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90a42527-3b5f-4924-bd2f-514413e6d540", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e220b996-1e7c-475b-b26e-7fd98a4bd03b", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d46c35e-7eea-4469-a4dc-33908f005fa6", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2de6c13e-f12a-4951-91e0-2333d05c5707", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "547c5a88-785a-4844-bd46-eb156aa8d627", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"expression\": \"\",\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b78f70f-4b8c-43dc-a1ab-b9c6616533d0", "name": "/units/sensors/params", "request": { "name": "/units/sensors/params", "description": { "content": "**Получение списка параметров датчика по каждой марке терминала**\n\n---\n\n**Роль:** Читатель и выше.\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f7e989b5-3b83-4528-8ffb-a296751c2c8b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ee51be22-e5bd-4264-9017-20c1a24a76be", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c37b8ef1-969e-4f95-8cb4-c05139dc79c5", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55365e1f-de97-40e0-b59d-3bbae8da2e1b", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9753bcf4-ecdf-4770-991f-8004bc119240", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c058d62-1544-4dd0-97e2-830280453d4d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c4bdb20-8384-4c93-9d49-d4b14f539568", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e15a77ff-8a2f-457e-9a89-7362268a45a5", "name": "/units/list", "request": { "name": "/units/list", "description": { "content": "**Получение объектов по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, возможные значения: \n\\[\"name\", \"created\", \"type.key\", \"terminal_type.key\"\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - name (можно искать по неполному слову), \n\"phonenumber\" - часть номера телефона, \n\"imei\" - часть IMEI, \n\"type.key\" - ключ тип объекта, \n\"terminal_type.key\" - ключ тип терминала, \n\"custom_fields\" - , \n\"sensors.name\" - название датчика, \n\"sensors.param\" - параметр датчика, \n\"sensors.type.key\" - ключ тип датчика, \n\"events\" - события\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 объектов, отсортированные по возрастанию по имени\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "cda7ea85-4b71-4923-895a-d9f0660a066e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7329eea1-f6b6-4b72-953a-19bfc4b6bbb3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c9a0de9-68b3-4ba5-9f88-b146089bc10c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "067c9c86-e99c-4387-9d9d-d8e859a04eb3", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9754d11-8db1-45f5-8698-40c43eb17869", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8f0ffa2-925d-4d4b-a114-224f5878233a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3901ec1-4947-4103-8119-a98e91779148", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"fields\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fdb8a83a-26f2-4ddb-a2f3-77ab11c8780c", "name": "/units/validate", "request": { "name": "/units/validate", "description": { "content": "**Валидация всех полей объекта**\n\n---\n\nAPI для валидации всех полей объекта, без сохранения. При этом ошибка может быть в разных полях\\\\сущностях объекта. \nТело запроса, как при создании POST /units, и при обновлении PUT /units/:id\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0f09a91f-1c34-4903-98db-f7f56879125e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8fd32ab0-5072-48b5-bca1-57dbc620aa87", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "edd1034a-ed9d-4022-b12d-e97426f9cc76", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f913fb1-8789-4bb6-85fa-31d2001f9ba6", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c45ab40d-2ed3-46cf-a36d-21a14289029c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04f9681a-dde2-4627-adbd-4e9ff4fad1f2", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77472726-2454-46d6-bd26-4002e4504f17", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"value\": \"\"\n }\n ],\n \"drivers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"user\": {\n \"id\": \"\"\n }\n }\n ],\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"imei\": \"\",\n \"name\": \"\",\n \"phonenumber\": \"\",\n \"phonenumber2\": \"\",\n \"sensors\": [\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"formula\": \"\",\n \"hide_in_reports\": \"\",\n \"invalid\": \"\",\n \"name\": \"\",\n \"param1\": {\n \"calibrationABlist\": [\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n },\n {\n \"a\": \"\",\n \"b\": \"\",\n \"fromValue\": \"\"\n }\n ],\n \"calibrationXYlist\": [\n {\n \"x\": \"\",\n \"y\": \"\"\n },\n {\n \"x\": \"\",\n \"y\": \"\"\n }\n ],\n \"max_valid\": \"\",\n \"min_valid\": \"\",\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"param2\": {\n \"calibrationABlist\": [\n \"\",\n \"\"\n ],\n \"calibrationXYlist\": [\n \"\",\n \"\"\n ],\n \"param_key\": \"\",\n \"smoothing\": \"\"\n },\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ],\n \"services\": [\n \"\",\n \"\"\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"trailers\": [\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n },\n {\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n }\n }\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f8fa688f-a92f-4d9f-a25d-bc7876da64b9", "name": "Получение файла объекта по URL", "request": { "name": "Получение файла объекта по URL", "description": { "content": "**Получение файла объекта по URL**\n\n---\n\n**Параметры:** \nid - ID объекта \nurl - URL файла\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "be1705fe-4f20-40cb-ade7-3ecfb95d7d16", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f71e3148-9326-4584-95bd-fc408091ecb4", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ceb94ef1-7a6b-4b84-94f6-d5e88d58c235", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3074cdf-46b2-45b4-8d27-89cacdb36b7d", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faccca12-4379-44c2-bf94-6d8fa8b91f59", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9dbd007-419b-401b-b144-442cb4e9ac26", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd9b49c6-8386-44b7-84e2-0721fbd1195a", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", ":unit_id", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Относительный путь к файлу", "type": "text/plain" }, "key": "url", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Группы объектов", "description": "", "item": [ { "id": "6911c162-c378-41ed-bd5a-09d3629078e3", "name": "/unitsgroup?ids=:ids", "request": { "name": "/unitsgroup?ids=:ids", "description": { "content": "**Получение групп объектов**\n\n---\n\nПараметр 'ids' опциональный - в случае его отсутствия получим все группы по текущей активной компании.\n\nЕсли в параметре ids указаны конкретные id групп (через запятую), то получим только их.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример ответа:**\n\n```\n[\n {\n \"id\":\"1a48c7d0-8ca7-4790-b001-7cc92075dabe\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"Группа Доставка\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9f560a07-3eab-4c7b-99b4-b2bc8ad66eb9", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "52e22619-01cc-4b98-be28-e0fc90b31a09", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5ad38e3-a290-41d8-bd2e-74d17fa9cd95", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04f65cf1-70d7-4673-b543-fdd790cb54f3", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1f22b63-1f41-4623-a73e-b45a857ffa6e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca559f23-ba07-4d5e-9556-b6a723166610", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f129a354-693c-4a1b-9eb1-450a05bffb08", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a4f43842-6a14-4647-8e41-fde819f588e3", "name": "/unitsgroup", "request": { "name": "/unitsgroup", "description": { "content": "**Создание группы**\n\n---\n\n**Параметры:**\n\n\"name\" - Имя группы. НЕ МОЖЕТ быть пустым или отсутствовать! \n\"units\" - Массив существующих объектов, достаточно передать только id. Может быть пустым, либо вообще отсутствовать. \nhide_in_lists, true если нужно \"Скрыть в списках\"\n\nall_units_included, true если это группа Все объекты в которую автоматически попадают все создаваемые и копируемые объекты\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"name\": \"Группа Доставка\", //\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---\n\n**Пример ответа:**\n\n```\n{\n \"id\":\"b6d098f8-dd71-48e0-b812-8460eadf7b2e\",\n \"company_id\":\"11111111-1111-1111-1111-111111111111\",\n \"name\":\"Группа Доставка\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9b44f4db-76cd-4655-804e-454a3f7e57c6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0117c3a5-dd66-43e9-a6ca-7e9bb7164d7b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e99514d-65a1-4934-8b42-3889c220b57b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "175d92d4-8ad5-44af-beb5-06b4116528c8", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe47842e-bc35-4eb6-9239-b43c5565578a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6be420c3-cf27-4371-867f-9d3bdbea84ca", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2312989f-f14b-4c9d-86a4-3fe98461edb8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f5586f88-0e11-4e97-9ef2-a4a945c6834e", "name": "/unitsgroup?ids=:ids", "request": { "name": "/unitsgroup?ids=:ids", "description": { "content": "**Планирование удаления группы объектов**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3daa1d40-4625-476e-aad9-09addc99a69f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "129717da-d60f-4a86-8835-72a631f0e314", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efc33e1a-2c71-4569-b389-e93b012ed19b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d60fffd8-e086-4b25-9422-72c445eacfa7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d82415a7-0e88-44c0-82a4-5205ce060c5f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae7fe060-823b-47f1-b0cd-c77c2f3132ef", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03023389-bae5-460f-af81-f5778a9536b1", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "96da6b91-7476-4c79-900d-a6693284989b", "name": "/unitsgroup/list", "request": { "name": "/unitsgroup/list", "description": { "content": "**Получение списка групп**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Запрос:**\n\nВ fields указать нужные поля.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\n\"id\"- Id группы\n\n\"name\" - Имя группы. \n\"units\" - Массив объектов в группе \n\"users\" - Массив пользователей имеющий доступ в эту группу. Пустой, если группа не общедоступна внутри компании\n\n---\n\n**Пример запроса:**\n\n```\n{\"fields\":[\"id\",\"name\",\"units.id\",\"units.name\",\"users.id\",\"units.imei\"]}\n\n ```\n\n---\n\n**Пример ответа:**\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 В456ВВ777\",\n \"imei\": \"862531040000007\"\n },\n {\n \"id\": \"c5f41d3c-4388-47bc-b7d0-928415591218\",\n \"name\": \"МАЗ 606 TTA 03\",\n \"imei\": \"8625310400000051\"\n },\n {\n \"id\": \"cdac02c5-ac08-46bd-968d-91da19732784\",\n \"name\": \"КамАЗ 5490 (А123АА777)23\",\n \"imei\": \"862531040000005\"\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\": \"Е789ЕЕ777 (#938)\",\n \"imei\": \"862531040000006\"\n },\n {\n \"id\": \"a9f4bd65-f56c-45ab-865f-9c36d04ce2c2\",\n \"name\": \"Ford В456ВВ777\",\n \"imei\": \"862531040000007\"\n },\n {\n \"id\": \"cfb99142-b07e-40ee-97f0-be19a99db46e\",\n \"name\": \"Кран Урал 676 STA 03\",\n \"imei\": \"862531040000008\"\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d1d7e8db-c392-4eed-9d96-daea48c935e7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b557eb02-a807-4e2d-a58a-6a491553fbe7", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7fc7755-3b5d-4b45-bd4c-c818a944e10b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e0e0c06-ec58-4fe7-a523-cfea5718f9e9", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa0a4459-ec8a-4176-93da-96c8ce3022bc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17c5c084-ae96-4acf-b5a3-ba81d23b6b00", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b9a5ba3-7601-4611-9146-fa1b9bd71de3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "83e7815b-5ce1-4c9f-8ef3-87e735e6b519", "name": "/unitsgroup/:unitsgroup_id ", "request": { "name": "/unitsgroup/:unitsgroup_id ", "description": { "content": "**Изменение группы**\n\n---\n\nCписок units заменяется полностью.\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unitsgroup_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1ada80b4-5dd0-49a6-9ddb-e4a4e2998947", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d37589d5-54c0-4bc7-8458-292ff8e89456", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbb43015-237e-472c-9999-72338a8a2bb9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fcec52b-96a9-40c0-ad3e-bca7ba890378", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68182da7-f960-4d77-a00f-bbbd2d181227", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec090616-3470-4eec-a1a9-c6dd8349c0ea", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ac8cc62-dc3a-4f9e-b099-a3e6bc520e58", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "59dcd980-faaa-4b2b-8354-3b9b422d4d04", "name": "/unitsgroup/:unitsgroup_id ", "request": { "name": "/unitsgroup/:unitsgroup_id ", "description": { "content": "**Удаление группы**\n\n---\n\nГруппа удаляется физически.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример ответа:**\n\n```\nпустая строка (при этом response status = 200)\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unitsgroup_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e5e5a249-c21e-436d-8ab7-36fdff0d0445", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6b03a564-a208-4e7d-a6a3-c71bd0372341", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9530431f-59b6-4a63-918e-41a236401f87", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61063945-f59d-4ed6-a8a7-a8c2501f139d", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01946940-e7a5-4104-a631-39976e6db4c3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c19768d7-5400-4bc9-9462-d66798f0e389", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa50e0a5-7b26-4eca-9780-d5712e027eca", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "unitsgroup", ":unitsgroup_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор группы объектов (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unitsgroup_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Смены", "description": "API по работе со сменами", "item": [ { "id": "0047991d-6204-4fd0-b40e-8d95cbfb53b3", "name": "/units_drivers?ids=:ids", "request": { "name": "/units_drivers?ids=:ids", "description": { "content": "**Поиск смен по ID (через запятую)**\n\n---\n\nВозвращает массив смен. \nЕсли параметр 'ids' пустой (т.е. запрос = 'GET /units_drivers', без параметра), то вернётся список всех связей всех компаний пользователя, из которого исключаются удаленные связи. Если ids не пустой (т.е. запрос = 'GET /units_drivers?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных связей.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная смена.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/units_drivers?ids=da47b5da-d030-44f0-acc4-a43107dbb090\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\": \"2020-10-01 10:00:00\",\n \"date_to\": \"2020-11-01 18:00:00\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "aa9c4bfb-1482-427c-86c9-a3657e87d98d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "45a2e9b7-4e93-4e4a-9a44-0773bf60b18a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e4065b1-54cf-4e74-b116-0d1954e50157", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35389a59-cc23-41ac-ae41-7fc7da9af290", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "310f35c6-7b58-4513-a733-4eb92a4faf8f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecea43f1-8a93-43fa-b50a-ac90e39ba281", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d26fec2d-6bb8-4a56-a099-6f3b6ac1dacb", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fffbe89c-dc7a-480d-87ad-08d3837cee17", "name": "/units_drivers", "request": { "name": "/units_drivers", "description": { "content": "**Создание смены**\n\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\"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\n---\n\n**Роль:** Редактор и выше.\n\n---\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d95f08bc-b04a-46bb-9d53-fe3fed297b14", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "83aa4c2d-af49-4242-a0b5-8b6d7a827a69", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80baac88-be91-4799-a215-57b30b916ad8", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97bf52ed-dc7a-4410-917e-336f01567b1d", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd30b8e0-b0b7-483c-9d02-5d10749b340a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14b0d7dd-a5a9-4c18-b290-bf19c47757dc", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f82f32f-685c-4ea4-9b80-9915e99aae0f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "75800d49-9415-414a-985f-d669f341328e", "name": "/units_drivers?ids=:ids", "request": { "name": "/units_drivers?ids=:ids", "description": { "content": "**Планирование удаления связи объект-водитель**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5e109f1a-e1df-4d6d-8c19-cfebb45058b0", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "814c6da3-9150-4d56-a7a2-bd80e821e4d5", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d041fc6d-8465-4225-977c-de6706448afe", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d80e7d2f-2d0a-41b0-8005-c7ea175aed93", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d19190e3-723f-4410-802a-875dd2b8f2bf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1812ff14-d1e0-4352-9a09-07d1841623f5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93a84f0f-e203-40f8-ae7c-7ee0cbbadc4c", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "20b176f8-c196-4ba0-8d2a-d5e04f4f86d7", "name": "/units_drivers_bulk", "request": { "name": "/units_drivers_bulk", "description": { "content": "**Создание нескольких смен**\n\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\n**Роль:** Редактор и выше.\n\n---\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**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "38796b79-276d-49ee-ad14-f11b3f87f6a3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2d409d9b-2513-4c7c-a256-70b7e31216e0", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f380306d-28ff-4730-8c79-f22e86a398ba", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8998eaa9-385f-4fc4-86fc-2a2fa53c73fd", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c16030e-c0e4-4e4e-997e-3a86a43b76c7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd2404e1-fb62-48d3-a254-dde1b0f4ca83", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21499fd3-34be-46dc-a388-491c96fc9898", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "651b0217-b4fe-4bc8-8b6b-de00fea2021f", "name": "/units_drivers/:id", "request": { "name": "/units_drivers/:id", "description": { "content": "**Обновить данные смены**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nсм метод POST /units_drivers\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /units_drivers?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "eecfe06b-086d-436a-b31d-f805da371719", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bf77e6d3-83f3-436d-acc0-b32036f6bfb4", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "caaffad2-1bda-47cd-97fe-9d84195b587c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b440bfa4-4a87-422a-bf67-73c0ecc024a0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32d78c02-d34a-48fa-8a39-ee3abbd8a58f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2475f4e-01a6-4639-9355-144e9a1ea699", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "270ba23c-2fe5-446c-9ee6-a0f59ffa0b91", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"unit\": {\n \"id\": \"\"\n },\n \"user\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cf9a67fb-30da-4ab6-9652-2c15375b6126", "name": "/units_drivers/:id", "request": { "name": "/units_drivers/:id", "description": { "content": "**Удаление смены по ее id**\n\n---\n\n**Параметры:**\n\nid смены\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:** 200\n\nЕсли смена с таким id не найдена, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "70360160-adcd-4e38-9fb9-68dec4ba9781", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "86d5fe75-eb95-429e-bd31-2f603a5ee08d", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce39bc84-99e7-4fe6-894c-189b6a9dec2f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "87fb991f-7f1f-4db3-85b2-c027f9b12f53", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0b4315c-e43c-4c67-be3b-73b5c79bb99b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "28ddda5f-b5e3-43b0-bb8f-6559ae45d08b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40575730-7fc1-40db-baac-6c69f1b4cb47", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8a7d7a78-9bf0-4a82-b5dd-43c10e2967b4", "name": "/units_drivers/list", "request": { "name": "/units_drivers/list", "description": { "content": "**Получить смены по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[date_from, date_to, created, is_delete\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - unit.id, user.id, date_from, date_to \nЕсли использованы date_from, date_to тогда выбирается смены которые пересекаются с \\[date_from, date_to\\] интервалом.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 смен, отсортированные по возрастанию даты начала, связанные с объектом с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096 и в октябре 2020 года\n\n```\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---\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\n---\n\n**Еще один пример запроса:**\n\nПолучить первые 10 смен, отсортированные по возрастанию даты окончания по убыванию, связанные с водителем (пользователь) с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1c078b21-1c4b-4cdb-a4f3-fa6121d8859c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d05f6d5b-6585-40c5-bdb1-ab37211b83b1", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7e5401e-becc-4832-9556-081f1aaa3ff3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90a3e75f-d543-45a0-a3e4-c165c7aed11d", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37df2055-b095-43df-9e57-fac3697e9926", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69645590-3235-4606-81be-77ccbb1f6c75", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08f5665f-0634-4e01-9348-193196c980cf", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_drivers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Прицепы объектов", "description": "API по работе со связью прицепов и объектов", "item": [ { "id": "6e864e4f-8a3e-424f-be5a-4c92e7b8cf6b", "name": "/units_trailers", "request": { "name": "/units_trailers", "description": { "content": "**Связать объект и прицеп на определенный период**\n\n---\n\n**Параметры:**\n\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\n**Роль:** Редактор и выше.\n\n---\n\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\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 \"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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5bde60c4-ab00-4a77-b4db-1e3c80e5a09a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ac05c37b-7f18-4a85-bd85-411cf2e389df", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3130c32-67b9-43d5-a7a4-079c6d3cc812", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecec7177-8fa0-46a6-8680-a258c9e61a78", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "649bf961-bd6a-4455-aa67-fe1dcaf5334f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e04fd00-e072-4c9a-834a-53a957c50133", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b1dfef8-e1eb-4420-8f71-210d65321d75", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa9f0777-1fe2-4b2a-9f2d-eb336f9fef84", "name": "/units_trailers?ids=:ids", "request": { "name": "/units_trailers?ids=:ids", "description": { "content": "**Планирование удаления связи прицепы-объекты**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "755737bf-98b5-493c-a81c-6f34e408d35c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c1bd2d2c-dec4-4601-b3b3-7adf95651f9a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdfbe4ba-9d14-45bc-9966-f60397384fe9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14292c0c-6fbf-47aa-9bad-25bc9c588558", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4da13165-5681-42c1-b8dd-a128b387f745", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7eacef3d-4570-4fdb-934b-7d8fe0050a85", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60c649c3-d1a3-4481-a40c-701b20834613", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ea87306-ebe7-4259-afd0-1739f2aa51f5", "name": "Получение списка связей объектов и прицепов", "request": { "name": "Получение списка связей объектов и прицепов", "description": { "content": "Возвращает список связей объектов и прицепов. Поддерживается фильтрация по списку ID через query-параметр ids.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c3368d75-2494-47cc-a90c-b32a2017210e", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "41b63dd8-b2aa-4730-b299-57bcb6404ba3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85fd81e8-1a4f-4ca6-a8cc-63ef38617488", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "927e69f9-ff15-4b85-91cd-6ae432ee4091", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e96c3a66-d96b-4e01-bbc5-a2bad38cac09", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fba4608-7812-4e2e-9f40-d7994981fc92", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "111cde5b-faf7-452a-8440-a4ad46e80f78", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Идентификаторы связей через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "84b11021-9b89-4379-b8e7-8a22a22d27c6", "name": "/units_trailers/:id", "request": { "name": "/units_trailers/:id", "description": { "content": "**Обновить данные связи**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nсм метод POST /units_trailers\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /units_trailers?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f06d1008-10a2-4048-a7e2-09ba16fd227f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b82cdbaa-6340-435c-9084-c37be0794f8a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50d87c5d-f669-4ec6-852f-82e3a66780a6", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9866574e-87b6-435c-80b6-0e5354cfbb55", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c17cde59-8d21-4628-a2e6-dd9447fd1ca2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "812bb413-684c-4a11-a041-8bc399dab958", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c43e983-a21a-4b64-99c0-0308670cbcfe", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"trailer\": {\n \"id\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0c3866a2-6f8e-40dc-8929-4d4ce0670e48", "name": "/units_trailers/:id", "request": { "name": "/units_trailers/:id", "description": { "content": "**Удаление связи по его ID**\n\n---\n\n**Параметры:**\n\nid связи\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:**\n\n200\n\nЕсли связь с таким id не найдена, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3638d7f9-f8bb-4532-bdc9-47b68f4e2b7a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cb05a60f-d3f6-435b-9ae0-1d8bb9643421", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8638a377-7f57-4004-93fd-a817f8dae586", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63c75730-e355-49e2-a84f-b65bb32c85f0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e670b5a9-f2c2-431c-beba-e2d9133edd9d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bcbe2e2d-b5ee-4cf7-a7e6-05cb05dc842d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7bedbab4-8ca0-49b0-946e-8f8ccb38bb44", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7cb7103c-f8ac-4048-bdf6-ff6b0f3f0178", "name": "/units_trailes/list", "request": { "name": "/units_trailes/list", "description": { "content": "**Получить связи объектов и прицепов по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[date_from, date_to, created, is_delete\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - unit.id, trailer.id\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 связей, отсортированные по возрастанию даты начала, связанные с объектом с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096\n\n```\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---\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\n**Еще один пример запроса:**\n\nПолучить первые 10 связей, отсортированные по возрастанию даты окончания, по убыванию, связанные с прицепом с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3\n\n```\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---\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8818cf59-2de6-418a-b90d-fb26b583ade8", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "43e3809a-6e74-4c8c-9e0e-aef9fd477a59", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a19a2a79-fcb8-4f90-84f0-d47c57d8c841", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0dfe6a73-3656-4a53-b9ac-34b793b70461", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d89b5344-9210-4b1f-b95b-e34f59170fc9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0433c59-8d08-4824-827d-e40d070927cd", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a130b29f-c589-486d-9fd0-34a22567d92e", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Состояния объекта", "description": "Архив состояний объекта", "item": [ { "id": "0fae32b1-e0be-45d8-83a6-445a9f753af7", "name": "/units_states/:unit_id", "request": { "name": "/units_states/:unit_id", "description": { "content": "**Получение состояний объекта**\n\n---\n\nПараметр запроса **unit_id** - ID объекта\n\nЗапрос без тела\n\n---\n\n**Пример запроса:**\n\nGET /units_states/897c7708-6758-4da0-92f7-208d8caa2f07\n\n---\n\nПример ответа:\n\nВ ответ приходят все состояния объекта в порядке убывания даты (date_from).\n\n**Поля:**\n\nid - ID состояния.\n\nname - имя состояния.\n\ndate_from - дата состояния.\n\nstate_unit - Короткая информация об объекте в этом состоянии, имеет следующие поля:\n\nid - объекта. При нажатии на редактирование необходимо открыть объект по этому ID.\n\nterminal_type - тип терминала\n\nimei - IMEI\n\n``` json\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\": \"862531040000004\"\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\": \"862531040000004\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "24401d2e-aaa9-4c64-96db-aec421fe648c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7ea53387-3c37-4091-a966-3b990fb00457", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efd69328-c7a8-4f2d-be79-99108d60060a", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c77f95a-12a4-4194-87ff-1d52875ad4db", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc70a383-6223-41b3-ab02-116da2eeb448", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "500674a8-7d1b-4541-b090-05234a9f76d7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3762bdec-d2d1-4186-894a-67b9fa28aae9", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "eaf84b31-e0de-4617-b72f-ba4114a79667", "name": "/units_states/:unit_id", "request": { "name": "/units_states/:unit_id", "description": { "content": "**Добавление нового состояния объекта**\n\n---\n\nПараметр запроса **unit_id** - ID объекта\n\n**Тело запроса JSON:**\n\nname - название состояния, обязательная строка.\n\nfrom_date - дата состояния, обязательное в формате yyyy-MM-dd.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /units_states/897c7708-6758-4da0-92f7-208d8caa2f07\n\n``` json\n{\n \"name\": \"Терминал Navtelecom\",\n \"date_from\": \"2022-10-09\"\n}\n\n ```\n\n---\n\n**Пример ответа:**\n\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id\n\n``` json\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\": \"862531040000004\"\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\": \"862531040000004\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "unit_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "27eba74d-9475-4730-b417-e59a48697ad0", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "196f4101-9cd5-47fb-bbcf-3a26bc28dc02", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ead6fc88-c111-4be6-91f3-8f0763cd9c5a", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1ac7bb3-8427-48bc-be93-2f697fae5092", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "70385363-78ff-49ad-b4b1-a7fab35aeb4c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63f13876-c9e5-4021-9c3f-18ac37e6a2ec", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10bcbd77-cfb2-48eb-8f63-f4fe4a6427e9", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":unit_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор объекта мониторинга (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "unit_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "66a35a40-22d9-4a14-9979-983411ff92ef", "name": "/units_states/:id", "request": { "name": "/units_states/:id", "description": { "content": "**Обновление состояния объекта**\n\n---\n\nПараметр запроса id - ID состояния\n\n**Тело запроса JSON:**\n\nname - название состояния, обязательная строка.\n\nfrom_date - дата состояния, обязательное в формате yyyy-MM-dd\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\nPUT /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2\n\n``` json\n{\n \"id\": \"fab2f033-15de-46a4-ad7b-5ae422c0c9a2\",\n \"name\": \"Терминал Gelileo\",\n \"date_from\": \"2022-10-10\"\n}\n\n ```\n\n---\n\n**Пример ответа:**\n\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id\n\n``` json\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\": \"862531040000004\"\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\": \"862531040000004\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "17802271-0d7a-493a-bd17-6d5dae8c8374", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "590b3ecf-90f8-459c-b558-44cdfac9a3f8", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a26ba685-c2cc-4075-b111-c12d762987d0", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2edd28ea-6a6e-49bd-9eee-37d81d1d87bd", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78ca69a4-388d-4bae-984e-fe6a7bb6e703", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0ae040c-cb85-4d0e-8da9-a03106e605b4", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6036eafb-41e6-40fd-8082-806922e56514", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a5c66bf1-a65e-40b1-8b29-5e3b4830dc78", "name": "/units_states/:id", "request": { "name": "/units_states/:id", "description": { "content": "**Удаление состояния объекта**\n\n---\n\nПараметр запроса id - ID состояния\n\n---\n\n**Пример запроса:**\n\nDELETE /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример ответа:**\n\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id\n\n``` json\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\": \"862531040000004\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "865eef69-f748-4714-9763-2656452da66f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "972f69b2-b06e-4ed4-b2db-2312a4f8362d", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8c233db-b803-4572-845d-a4e303e1f8a3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a43e12e7-c269-4f40-b5af-3d97963393e0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e283058-ff13-480c-9e5e-7657406cb8d7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "975d665f-a8df-44e7-b710-ff698bf016c1", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8db59665-1858-43c3-a406-51873e66dea3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e18107c-a7a8-45fb-bfc4-522cd69cdca7", "name": "/units_states/:id/copy", "request": { "name": "/units_states/:id/copy", "description": { "content": "**Копирование состояния объекта**\n\n---\n\nПараметр запроса id - ID состояния\n\nБез тела запроса.\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /units_states/fab2f033-15de-46a4-ad7b-5ae422c0c9a2/copy\n\n---\n\n**Пример ответа:**\n\nВ ответ приходят все состояния объекта, как в запросе GET /units_states/:unit_id\n\n``` json\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\": \"862531040000004\"\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\": \"862531040000004\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "30df2388-fb14-4ea1-ad66-f46da4186e2b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4e7324f8-942e-40e2-8aba-4d0114f494e7", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8229de2-fc42-4744-82e9-f85d895162a1", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07fcd8d0-6ae5-4490-b72f-4ebabdf7ec2c", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa79f1af-324a-427f-af83-42969082bf07", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c557dba3-3f85-4a31-8528-cad1674adb5b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a57bc301-1477-44a8-a013-514a2c98591f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states", ":id", "copy" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "18a572a9-09b7-4528-8c0b-5e407f12ae31", "name": "Подсчет изменений состояний объектов в группах", "request": { "name": "Подсчет изменений состояний объектов в группах", "description": { "content": "Возвращает количество смен состояний (ревизий конфигурации) по каждому объекту в указанных группах за выбранный интервал времени.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2ed93952-457e-4e43-b51a-9c630c20080e", "name": "Список объектов с количеством зафиксированных состояний", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"key_0\": \"\"\n },\n {\n \"key_0\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1836430-6988-41e4-a865-e1982aee2abd", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "231b7bfa-a40a-4dbc-9031-1d789929ec13", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f758a95-62f0-476c-93e1-47b872728755", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59b83eed-398b-4fee-86dd-b28d4f6fd201", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "915fc8d0-9898-4596-9da8-2ead014a0e8c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b05dc96-c646-40e2-841e-bae9edeee007", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units_states_count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"from\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Прицепы", "description": "API по работе с Прицепами", "item": [ { "id": "ea723c71-012b-4e89-8a89-d24bfd73385a", "name": "/trailers?ids=:ids", "request": { "name": "/trailers?ids=:ids", "description": { "content": "**Поиск прицепов по ID (через запятую)**\n\n---\n\nВозвращает массив прицепов. \nЕсли параметр 'ids' пустой (т.е. запрос = 'GET /trailers', без параметра), то вернётся список всех прицепов по всем компаниям пользователя, из которого исключаются удаленные прицепы.\n\nЕсли ids не пустой (т.е. запрос = 'GET /trailers?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных прицепов.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный прицеп.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/trailers?ids=7c4253d5-4bc6-4885-bf25-985a75919fb4&\n\n ```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c3871b9e-9fcc-480f-b2a3-2bb80ccfe444", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ecdf6faa-8808-4d0d-9701-a54b6fd58733", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b483ede0-46f5-46fa-8c8d-fcf255cfaedc", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bce23cf4-15e9-47e6-8945-5e1ef16ce8f4", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0508d8d0-5138-4c95-8612-d56a71ace31c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b300696-b9c4-48ad-94c2-7bf6322c312d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af7035f6-f107-4084-876f-b4dd66f3d0e7", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0516c3a8-26d7-4143-bcd6-1ca5d70f602f", "name": "/trailers", "request": { "name": "/trailers", "description": { "content": "**Создание прицепа**\n\n---\n\n**Параметры:**\n\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\n**Роль:** Редактор и выше.\n\n---\n\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6444b40d-c398-4b93-9cf0-2f91466030f7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b3d6cd26-2aad-43fc-8dd6-51bc428f58b3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a06ad046-ec27-4b03-be41-b6b5504d9bc8", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d128fca5-451e-4e89-b09e-400669820816", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f8079e5-ff19-4fbe-82eb-7403dc9bac14", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef26f41c-cc52-4985-af4f-72e64cf488c3", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8335485-da86-4277-92de-0779cc65d52f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"custom_fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2169903f-cd74-4589-99df-0000b1735574", "name": "/trailers?ids=:ids", "request": { "name": "/trailers?ids=:ids", "description": { "content": "**Планирование удаления прицепов**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "33b6bfa8-8636-463f-9f5f-93f4abf31fc4", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cbf51011-ccb3-4f0e-b516-3649f8bde4cf", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "742f331d-7a4c-4415-a0eb-a193842b1dd0", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2d506ad-8074-4706-83c4-eb660935e48f", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f80c962-827f-49e4-86d8-c873d1753a63", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0de6fbfd-40ec-4ff3-9118-9738af2d61b0", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfdbb2e7-4fd2-4d28-b404-e018ebf059bd", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b74a8628-255f-4670-945d-c98f3e3bb9f5", "name": "/trailers/:trailer_id", "request": { "name": "/trailers/:trailer_id", "description": { "content": "**Обновление данных прицепа**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Параметры:**\n\nсм метод POST /trailers\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /trailers?ids=:trailer_id", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "trailer_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2bced2af-01b0-4b46-a4d6-4192b7730fe6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "37ddabd7-d195-49a4-b086-bc08c91264bd", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9aa30a2c-c56d-4ab5-9e09-8f5267c6392b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b81f21c0-fdb9-4d02-9f90-7c4b9eaa71ed", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45441b04-f971-4615-9ac4-67e7272e26a3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "518c8bf1-0756-40dd-bf23-d3f04989ca9e", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5921a18e-d776-4600-90d8-29645d61b485", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company_id\": \"\",\n \"custom_fields\": [\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df8f06d7-285f-42f2-8ce8-5fb874dfd11a", "name": "/trailers/:trailer_id", "request": { "name": "/trailers/:trailer_id", "description": { "content": "Удаление прицепа по его id\n\n---\n\n**Параметры:**\n\nid прицепа\n\n---\n\n**Роль:** Редактор и выше.\n\n---\n\n**Ответ:** 200\n\nЕсли прицеп с таким id не найден возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "trailer_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2b33406e-215d-456b-8b18-f440d78d8f3e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0f33fe42-571f-4113-97d9-ff1e796594dc", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a7a485c-a5f3-4f3f-9c6a-6445b27a1723", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93998aa3-4f88-4db7-88f0-907b0da79e72", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b02a73ad-3eac-4ff7-85b8-5a107d9fdc5f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78c9fa93-46d6-46b5-86be-89dac4bcc604", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8718b1c9-c38e-4395-947f-f0b3d4c7f79a", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", ":trailer_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор прицепа (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "trailer_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6512ac6a-df89-4137-993f-ca45836f70e4", "name": "/trailes/list", "request": { "name": "/trailes/list", "description": { "content": "**Получить прицепы по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[name, created, is_delete\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - name (можно искать по неполному слову), code, description\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 прицепов, отсортированные по возрастанию, по имени, которые имеют ID прицепа 7e1aaba2-625a-4a4c-b765-9934bec5a096\n\n```\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---\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\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2447a70d-13bb-41bf-b94f-ce0003e1c00f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ef595cf4-32e8-4dca-bdc9-1afb5e2bfe39", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a83e1a6-a9e1-4378-95d7-6586bebbeb8c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c263119e-0c5d-49c7-b85d-acecfc3f03dd", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bcdcb0c2-32e3-453a-86b2-21a050b787f5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c55875e-4d52-4adb-867f-dc37499b0ee7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "349c4f57-d77e-4ded-9d69-f88e265b4786", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "trailers", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortDesc\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "События", "description": "API по работе с событиями", "item": [ { "id": "323be73c-6aa1-4215-8e0a-4c3e2a0edc38", "name": "/events?ids=:ids", "request": { "name": "/events?ids=:ids", "description": { "content": "**Поиск событий по ID (через запятую)**\n\n---\n\nВозвращает массив событий. \nЕсли параметр 'ids' пустой (т.е. запрос = 'GET /events', без параметра), то вернётся список всех событий всех компаний пользователя, из которого исключаются удаленные связи. Если ids не пустой (т.е. запрос = 'GET /events?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных событий.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретное собитие.\n\n---\n\n**Пример запроса:**\n\n```\n/events?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\n ```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fbf99851-f192-4896-9c4c-b6f81336d1bf", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8e8a16fb-7e2d-4191-9d61-682ed1c64d61", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c7aa980-66f5-4f1f-a606-24a70db188f5", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79790289-4080-49c8-8ebc-e58faa1fb957", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66c282b7-b01f-459e-844c-3da6fab7e469", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74c5a8fe-8a5c-4284-8388-88c58ab028ed", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17788e06-e20a-4096-8c64-8922ca4d6120", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b8466cdb-b780-4632-a533-aae15e1345af", "name": "/events", "request": { "name": "/events", "description": { "content": "**Создание события для объекта**\n\n---\n\n**Параметры:**\n\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\n**Роль:** Оператор и выше.\n\n---\n\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\n**Пример ответа:**\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 ```\n\n---\n\nК событиям можно добавлять фотографии. Максимальное количество 10 шт. Максимальный размер одной фотографии 10 мб.\n\nПеред отправкой события, фотографии должны быть загружены на сервер. \nЗагрузить фотографии нужно иcпользуя POST {{base_url}}/upload_photos/events.\n\nВ этот запрос нужно положить одно фото в поле file.\n\nЗапрос должен быть в формате multipart/form-data\n\nПример ответа:\n\nВозвращается два поля в JSON small и original.\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\nsmall - для загрузки изображения в списке.\n\noriginal - для открытия оригинального фото с большим размером.\n\nЗапросить нужное фото можно через роут {{base_url}}://api_v1/{url}. \nВсе добавленные фотографии необходимо отправлять в поле photos при создании и обновлении события.\n\n**Пример запроса:** \nPOST /api_v1/events\n\n```\n{\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "82ed7083-923f-4e41-923a-0ee232574bb7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5ca11aec-1cf9-47b9-8e3d-0b9e6b4d8430", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c458363-e2fd-4432-a7ac-7c7f53f23d70", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fdd1e202-181a-46f1-8897-39c42ac08ca3", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af87a6f1-7a8e-4c69-9090-f237351fac39", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "366c8b72-895e-4c0c-92cc-e9e7ca5bdd9d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "111899e6-2471-4319-b2ea-3038721541b5", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4e5bf415-7c02-4950-9a97-047f53866957", "name": "/events?ids=:ids", "request": { "name": "/events?ids=:ids", "description": { "content": "**Планирование удаления события**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "57dc2033-3c62-40a5-a294-af720c98328a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "801b4199-541a-451a-bc3b-625df494995d", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1316ce1-be6c-4385-9a3a-5eef34718822", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fc9ae30-61aa-4951-a66d-307b0565c7da", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad9a00dd-96c4-44d1-9dcb-8695ad0418db", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57c99ddb-58cb-4038-bd6d-dcbead1817a5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35810aed-1eed-4c8a-b8cc-13e31fae96c8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "db687c47-add1-4b04-a4f5-d8ed60cea0b5", "name": "/events/:id", "request": { "name": "/events/:id", "description": { "content": "**Обновление данных события**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nсм метод POST /events\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному событию из ответа метода GET /events?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8ee8177e-c573-434c-83d7-4b3e09fb4069", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "54a01feb-cb63-46dd-8fca-7eb59ede793e", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "299910fa-ec12-4737-a78e-2a6e0d6bcfd7", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b786e57f-15b4-4d7e-aabb-e94c89af2456", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec66aee3-a37d-4ec5-b478-643f86660134", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "030168d8-4534-4d5b-b785-0011eee2bb5d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a051f070-2b63-44fc-9372-6c7ebb41ef16", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"datetime\": \"\",\n \"deviation_minutes\": \"\",\n \"filled\": \"\",\n \"id\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "497ec26c-4f6c-4771-a32c-8e6a6d23d18c", "name": "/events/:id", "request": { "name": "/events/:id", "description": { "content": "**Удаление события по его id**\n\n---\n\n**Параметры:**\n\nid события\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Ответ:** 200\n\nЕсли событие с таким id не найдено, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "efbd1ae2-2f82-44b5-bd2d-a815c01478e5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "75ba8791-33da-4d9c-93f5-8ce647c910f9", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e8b5204-9bfb-4ddc-a4a0-7b8c14dab42a", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df5ebd09-b598-410b-9bd7-dc08d5c9daea", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63b197b0-4a2e-476f-ac7f-b52b1599ec28", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84eb92d1-ff7d-40ea-b318-fb635ccbc589", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5faca5b9-4801-4280-8dde-1ffdce944377", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "46e687b9-4145-4639-b9be-bdecd77919cc", "name": "/events/list", "request": { "name": "/events/list", "description": { "content": "**Получить события по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[type.key, unit.id\\]\n\nsortDesc - сортировка по убыванию? значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - unit.id, type.key\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 событий от 2020-01-01 00:00:00 до 2020-01-10 00:00:00, отсортированные по возрастанию type.key, для объекта с ID 7e1aaba2-625a-4a4c-b765-9934bec5a096\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "69419769-e58a-49c0-b8eb-f5753a6e06b6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "57e9b8e5-82f8-4886-bffe-d3b6ba02202a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6c65e3b-84d2-4e02-b449-ad76025b6ce6", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbaf3b6d-228c-41fa-a15b-74eff6df32d7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97cfafab-9cf6-4cb3-8b76-59019633344c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e614cd27-99f1-43a3-b5d8-9a124e138b81", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66cce8b9-7589-49bc-bcdd-6305319a30db", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "33d1ae19-7545-4d2a-a874-cba5c4e97a7f", "name": "/events/service_names", "request": { "name": "/events/service_names", "description": { "content": "Получение всех названий ТО при создании события\n\nВоозврашает Осмотр, Замена терминала, Установка ДУТ, Замена ДУТ, Калибровка ДУТ и новые введенные сервисы внутри компании\n\nПример ответа:\n\n```\n[\n \"Осмотр\",\n \"Замена терминала\",\n \"Установка ДУТ\",\n \"Замена ДУТ\",\n \"Калибровка ДУТ\",\n \"21\",\n \"Terminal replacement\",\n \"Замена ремня ГРМ\",\n \"Новый сервмс\",\n \"Пищевая заправка\",\n \"Предыдущий сервис\",\n]\n\n ```\n\n---", "type": "text/plain" }, "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4423ee87-1846-4827-ab68-e8843d7dbb77", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6895ea73-6751-4dd8-8b8b-6f855dcb318a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33ba589b-26b9-464c-b011-e0c8afe5aff8", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb83b211-4861-4489-b7b1-e57b3eaef749", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19453ebb-d1be-42ce-b81b-ca28419359d9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f8ca186-4032-4ef2-b6df-82127acc812e", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b0b2de6-a865-4cde-adf0-5318fb4aae3b", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events", "service_names" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f504f0d4-e03a-404d-a15c-6066b6a356d2", "name": "/events/bulk", "request": { "name": "/events/bulk", "description": { "content": "

Массовое создание событий

\n
\n

Параметры:

\n

Тело запроса должно содержать массив объектов событий.
Общие поля (для каждого объекта в массиве):

\n
    \n

  • \"unit\": {\"id\": \"UUID\"} — (обязательное) ID объекта, для которого создается событие.

    \n
    • \n

  • \"type\": {\"key\": \"string\"} — (обязательное) Ключ типа события. Возможные значения: filling, theft, accident, service, waybill, vehicle_status, random.

    \n
    • \n

  • latitude: Координата широты на карте. Вещественное значение.

    \n
    • \n

  • longitude: Координата долготы на карте. Вещественное значение.

    \n
      \n
    • Примечание: latitude и longitude должны выбираться на стороне клиента для всех типов события, кроме \"путевые листы\" при смене даты с помощью метода POST /point.
      • \n
    \n
    • \n
\n

Остальные поля зависят от типа события (для каждого объекта в массиве):

\n

1) Заправка — type.key=filling

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное) — дата и время события.

    \n
    • \n

  • \"deviation_minutes\": 100 (обязательное) — Отклонение, мин. Числовое поле от 0 до 1000.

    \n
    • \n

  • \"filled\": 30.5 (обязательное) — Заправлено топлива, л. Числовое поле больше 0.

    \n
    • \n

  • \"price\": 3050.7 (необязательное) — Стоимость. Числовое поле от 0.

    \n
    • \n

  • \"description\": \"some details\" (необязательное) — Описание. Текстовое поле.

    \n
    • \n
\n

2) Слив — type.key=theft

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное).

    \n
    • \n

  • \"deviation_minutes\": 100 (обязательное).

    \n
    • \n

  • \"stolen\": 20.8 (обязательное) — Слито топлива, л.

    \n
    • \n

  • \"description\": \"some details\" (необязательное).

    \n
    • \n
\n

3) ДТП — type.key=accident

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное).

    \n
    • \n

  • \"deviation_minutes\": 100 (обязательное).

    \n
    • \n

  • \"description\": \"some details\" (необязательное).

    \n
    • \n
\n

4) Тех. обслуживание — type.key=service

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное).

    \n
    • \n

  • \"deviation_minutes\": 100 (обязательное).

    \n
    • \n

  • \"service_name\": \"Установка ДУТ\" (обязательное) — Название сервиса.

    \n
    • \n

  • \"motohours\": 2345.5 (необязательное) — Моточасы, ч.

    \n
    • \n

  • \"millage\": 23453.5 (необязательное) — Пробег, км.

    \n
    • \n

  • \"duration_hours\": 3.5 (необязательное) — Длительность, ч.

    \n
    • \n

  • \"price\": 3000.4 (необязательное) — Стоимость.

    \n
    • \n

  • \"guaranteed\": true (обязательное) — Гарантийный: true/false.

    \n
    • \n

  • \"description\": \"some details\" (необязательное).

    \n
    • \n
\n

5) Путевой лист — type.key=waybill

\n
    \n

  • \"start_date\": \"2020-01-03 12:30:00\" (обязательное) — Начало: дата и время.

    \n
    • \n

  • \"finish_date\": \"2020-01-05 18:00:00\" (обязательное) — Окончание: дата и время.

    \n
    • \n

  • \"user_id\": ID Водителя (необязательное).

    \n
    • \n

  • \"motohours\": 2345.5 (необязательное).

    \n
    • \n

  • \"millage\": 23453.5 (необязательное).

    \n
    • \n

  • \"filled\": 30.5 (необязательное).

    \n
    • \n
\n

6) Статус ТС — type.key=vehicle_status

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное).

    \n
    • \n

  • \"type_name\": \"В гараже\" (обязательное) — Тип события, текстовое поле.

    \n
    • \n

  • \"description\": \"some details\" (необязательное).

    \n
    • \n
\n

7) Произвольное событие — type.key=random

\n
    \n

  • \"datetime\": \"2020-01-01 12:30:00\" (обязательное).

    \n
    • \n

  • \"deviation_minutes\": 100 (обязательное).

    \n
    • \n

  • \"type_name\": \"Повышение скорости\" (обязательное) — Тип события, текстовое поле.

    \n
    • \n

  • \"description\": \"some details\" (необязательное).

    \n
    • \n
\n

Роль: Оператор и выше.

\n

Важно:
Операция выполняется в одной транзакции. Если хотя бы одно событие в
списке не пройдет валидацию (или у пользователя нет доступа к указанному
объекту), ни одно событие не будет создано.

\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    {\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.862531040000024,\n        \"longitude\": 44.862531040000023,\n        \"photos\": []\n    },\n    ...\n]\n\n
\n
\n

Работа с фотографиями:

\n

К событиям в массовом запросе также можно добавлять фотографии. Логика аналогична методу /create.

\n
    \n

  1. Фотографии загружаются заранее через POST {{base_url}}/upload_photos/events.

    \n
    2. \n

  2. Полученный JSON с small и original добавляется в массив photos нужного объекта события внутри общего списка.

    \n
    3. \n
\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
", "type": "text/plain" }, "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1257e74e-f99d-4339-83c6-52b1be21e1aa", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2c647fb3-5708-4478-a209-f5dd50741f71", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "419fec5d-96b3-4d9e-8e1a-136baaf96cff", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75c2bb20-1fc1-4eb6-8b76-ed92faca08ae", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b178196-9edf-45b4-a445-66231a8678c3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01c0538f-cb4c-411f-b9e2-7dd39523a57d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "062283d0-74d1-4775-9db1-e8a613fe6a41", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "events", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n },\n {\n \"unit\": {\n \"id\": \"\"\n },\n \"datetime\": \"\",\n \"type\": {\n \"key\": \"\"\n },\n \"deviation_minutes\": \"\",\n \"filled\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Мониторинг", "description": "", "item": [ { "id": "51ec09b5-9d8a-4d32-90c4-3707d991041f", "name": "/messages", "request": { "name": "/messages", "description": { "content": "**Получение изменений в справочниках**\n\n---\n\nИспользуется один вебсокет для получения следующих данных:\n\n1. Последнего сообщения от объекта\n\n2. Уведомлений за последние сутки\n\n3. Новых уведомлений\n\n4. Изменения справочников\n\n\nЕсли сервер использует протокол HTTP, то вебсокет должен работать по протоколу WS. Аналогично, если сервер использует HTTPS, то вебсокет должен работать по протоколу WSS.\n\nМожно также передать параметр `?from_time=1628259485000`, где значение — это метка времени в формате Unix (в часовом поясе пользователя). Это нужно, если вы хотите получить данные, начиная с определённого момента времени. Например, если у вас уже есть закэшированные данные на клиенте, и вы хотите получить только новые сообщения, начиная с этого времени.\n\n**Примеры:**\n\n1. Последнего сообщения от объекта\n\n\n```\n[\n {\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"862531040000010\",\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\": \"862531040000010\",\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\": \"862531040000010\",\n \"company_id\": \"3e70f167-9fad-4753-bccf-d7d47c2c648c\"\n }\n]\n\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\": \"Оператор системы обновил объект\" //сообщение\n }\n}\n\n ```\n\n---\n\n**Иконки для наглядного отображения состояния датчиков в мониторинге**\n\n---\n\nДобавляется новое поле `sensors_settings` (массив), если для компании были настроены датчики.\n\n```\n{\n \"columns\": [\n {\n \"key\": \"unit_name\",\n \"name\": \"Имя\",\n \"value\": \"КамАЗ 5490 862531040000011\",\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\": \"КамАЗ 5490\",\n \"company_id\": \"3e70f167-9fad-4753-bуcf-d7d47c2c648c\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9f5a9e2e-2757-4fdb-9f1a-48b11fd7274e", "name": "200", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "29030c5c-fede-4417-ba24-f6177b24ddff", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "288c6878-016a-4542-96c5-fa3e1e3c07bf", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c97cd81-11b8-4091-88e8-b83b9f75ea09", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f64cc461-0217-4952-ac04-c29153dc09ac", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a38967ae-f174-4f9d-ba20-59b8746f1f7c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7eec307b-9f16-4705-ba91-cdfd1bba830a", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "messages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "monitoring_filter", "value": "" }, { "disabled": false, "description": { "content": "Метка времени Unix (в миллисекундах) для получения новых сообщений с указанного момента", "type": "text/plain" }, "key": "from_time", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "38a8e3e9-3135-4842-bf55-25985902a2cb", "name": "Расширенные данные мониторинга (таблицы и интервалы)", "request": { "name": "Расширенные данные мониторинга (таблицы и интервалы)", "description": { "content": "Возвращает детализированные данные объектов (поездки, стоянки, заправки, сливы, сервисы, удаления данных) за интервал времени.", "type": "text/plain" }, "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "abe7a9d3-481e-40a4-8b50-e55b9b0ecac0", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e3c85433-768b-4664-86d1-7600f881411f", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "951c4c30-ba9d-4d05-8ba8-e29f49d42c11", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b3fa5ad-842c-410d-a46c-addb1c060f82", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bfd8110-a1be-4f29-adf9-95a955fc6e90", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29a656f1-4aa7-42b4-b85e-85e6c61548c1", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62d2ca92-7f26-47ce-8ce5-d5584bdd9291", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_extra" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "afab9973-83d1-4f91-b492-527e4557e9fd", "name": "Базовая сводка мониторинга по объектам", "request": { "name": "Базовая сводка мониторинга по объектам", "description": { "content": "Возвращает суммарный суточный пробег, количество заправок и сливов для выбранных объектов (до 100 объектов).", "type": "text/plain" }, "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1059ee72-6d03-4367-9fa4-71e0c58b5ee0", "name": "Сводка мониторинга за сутки", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"sum_distance\": \"\",\n \"cnt_stucked_fillings\": \"\",\n \"cnt_drained_fillings\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf826830-8016-4e60-a51d-52f508f24cb5", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "508c4b22-4f3e-4d9f-9dca-91cd4716e3bc", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4affe09-4004-4bd2-91cc-eaa809c637ad", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10ea4266-2dcb-44b2-a566-3976d513e8b8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa7f551a-c57c-42ce-bdab-d01e605e0ff4", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "194fe02b-e979-441b-80d5-df4af161712f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "monitoring_basic" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Отчеты", "description": "", "item": [ { "id": "7cc6eadf-161f-4d3f-9cec-a6a8f253a6e9", "name": "Генерация отчета", "request": { "name": "Генерация отчета", "description": { "content": "**Запрос отчета**\n\n---\n\nЗапрос отчета содержит следующие параметры:\n\n- units - массив id объектов, по которым требуется сделать отчет. Если отчет по группам, тогда groups - массив id групп объектов, по которым требуется сделать отчет.\n- template_tables - массив id таблиц. Используется ТОЛЬКО первая таблица.\n- from - время начала отчета в формате yyyy-mm-dd hh:mm:ss\n- to - время конца отчета в формате yyyy-mm-dd hh:mm:ss\n- offset - опционально. Параметр для пагинации. Определяет количество пропущенных строк, начиная с нулевой строки. Если параметр отсутствует в запросе, то по дефолту он равен 0.\n- max - опционально. Параметр для пагинации. Определяет максимальное количество строк, выдаваемое в запросе. Если параметр отсутствует в запросе, то по дефолту он равен значению всех строк, которые удалось сформировать в отчете. (Для графика это количество максимальных точек в графике. Если не приходит или значение больше 5000, тогда по умолчанию выбирается 5000).\n- selected_columns - опционально. Только для графиков или для журналов (отчет с типом chart или journal), иначе просто игнорируется. Определяет набор данных (сырых или датчиков), которые будут возвращены, вместе с данными по датчикам. Выбирается из possible_columns. Например ('selected_columns': \\[{'key': '1a590afb-bfe5-44cf-8d78-f5137bfbb7ae', 'name': 'Напряжение', 'sensor': true},{'key': 'voltage_main', 'name': 'voltage_main', 'sensor': false}\\]).\n- only_totals - опционально. Логическое значение. Если параметр отсутствует в запросе, то по дефолту он равен false. Если true, то возвращается только итоговые строки отчета.\n- sortField - опционально. Строка. Ключ поля, по которому нужно сортировать результат.\n- sortDesc - опционально. Логическое значение. True, если нужно сортировать по убыванию.\n- time_group - Группировка по времени, моожно указать hour, day, week, month\n\n\nОграничения:\n\n- Параметры offset и max следует использовать в паре.\n- Параметры sortField и sortDesc следует использовать в паре.\n- Колонки, ключи которых начинаются с \"_\", являются сервисными и не должны быть видимы на фронте, даже если у них случайно 'is_visible' = true. \n Типы сервисных колонок:\n\n\n```\n - '_start_latlon_%ключ отчета%' - начальная координата\n - '_end_latlon_%ключ отчета%' - конечная координата\n - '_start_time_%ключ отчета%' - время начала\n - '_end_time_%ключ отчета%' - время конца\n - '_marker_latlon_%ключ отчета%' - координата маркера\n - '_is_total' - Определяет, является ли строка итоговой. Итоговые строки должны быть выделены жирным шрифтом.\n\n ```\n\n---\n\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\": \"ДВД Грузовой 101 КР 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 ```\n\nПро дефолтные таблицы можно почитать здесь [GET /report_templates?ids=:ids](https://)\n\n---\n\n**Пример запроса:**\n\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Пример запроса с фильтром и сортировкой отчета:\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---\n\n**Пример ответа:**\n\n```\n{\n \"unit_id\": \"712ceae4-f112-4714-9a4d-afe141e47bf7\",\n \"unit_name\": \"ДВД Грузовой 101 КР 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\": \"ДВД Грузовой 101 КР 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\": \"ДВД Грузовой 101 КР 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\": \"ДВД Грузовой 101 КР 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\": \"ДВД Грузовой 101 КР 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\": \"ДВД Грузовой 101 КР 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\n**Примеры запросов и ответов:** \nselected_columns - для журнала можно указать максимум 6 параметров, для графика максимум 2 параметра.\n\n**1) Журнал**\n\nЕсли не указан selected_columns, то приходят дефолтные поля (datepoint, speedkph, latitude, longitude и _marker_latlon_journal)\n\nЗапрос:\n\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Ответ:\n\n```\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"КамАЗ 5490 (А123АА777) Мониторинг\",\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 ```\n\nЕсли указан selected_columns, то приходят значения указанных параметров и дефолтные параметры.\n\nЗапрос:\n\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Ответ:\n\n```\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"КамАЗ 5490 (А123АА777) Мониторинг\",\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\n ```\n\n---\n\n**2) График**\n\nЕсли не указан selected_columns, то приходят поля с данными datepoint, speed, is_trip, trips_intervals и значения 2 первых датчиков (если есть).\n\nЗапрос:\n\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Ответ:\n\n```\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"КамАЗ 5490 (А123АА777) Мониторинг\",\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 ```\n\nЕсли указан selected_columns, то приходят поля с данными datepoint, speed, is_trip, trips_intervals и указанные параметры.\n\nЗапрос:\n\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Ответ:\n\n```\n{\n \"unit_id\": \"d20f49af-d68b-47fa-99f8-bb4e56354391\",\n \"unit_name\": \"КамАЗ 5490 (А123АА777) Мониторинг\",\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 ```\n\nНовые поля для графика в template_tables:\n\n1. Чекбокс \"Отображать сливы и заправки\" - show_fillings_thefts, boolean\n2. Чекбокс \"Сделать отчет закрытым\" - closed_to_change, boolean\n3. Маски названия датчиков топлива - fuel_sensor_name_masks, массив имеющий поле value, как в поле sensor_name_masks\n4. \"Параметры\" - params, массив, имеет поля terminal_type_key - ключ типа протокола (если не указан или null, тогда это для всех протоколов), value-значение параметра\n\n\nПример:\n\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 ```\n\nПриходят новые элементы в columns: fillings_intervals - для заправок и thefts_intervals - для сливов. В data приходят даты начала и окончания, как в trips_intervals.\n\nПример:\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "cbb4379d-0365-400c-ba9d-65e597067dd0", "name": "Результат построения отчета (колонки и агрегированные данные)", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"unit_id\": \"\",\n \"unit_name\": \"\",\n \"report\": {\n \"name\": \"\",\n \"key\": \"\",\n \"max_rows\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b658efe0-1de7-4d64-bfd5-6b12c0cbae70", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4507f4e0-5a62-4e3d-952e-4b834266f8be", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cccafd43-1c86-4666-8ebc-6fcedacd681f", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4ba86b3-2a92-4525-b792-5ee8c269ed82", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25514ac0-bb3e-4851-b4c3-6afbc6d8d100", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "229f0ab0-e42a-4e0f-b2f8-04a9d6a6437b", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7079f0e5-d72e-4cec-a8bd-419a61f0cd98", "name": "Получение данных столбчатого графика (Bar Chart) для отчета", "request": { "name": "Получение данных столбчатого графика (Bar Chart) для отчета", "description": { "content": "Возвращает ряды данных (bar_chart_x, bar_chart_y) для построения диаграмм, если для таблицы отчета включена поддержка bar chart.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "68c377a2-829c-4d09-b1ea-18130ff8096f", "name": "Данные графика для визуализации", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"unit_id\": \"\",\n \"unit_name\": \"\",\n \"report\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e4934e8-ed38-406f-84f6-db94eff66d21", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "baebd250-7156-4b76-a97a-83e591db4447", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e20ee1ff-24dd-4a27-b391-e2845b1d9ae0", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b88a83be-96c2-4d01-b951-680fe83922d5", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa429466-2b8f-45dd-aaf0-122b9a6c9dac", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "996d4f17-76cc-45be-8f4e-84fc657eec80", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report", "bar_chart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9d0aef6a-78e9-4574-bd2f-17055d1d4369", "name": "Выгрузка отчета в формате Excel (GET)", "request": { "name": "Выгрузка отчета в формате Excel (GET)", "description": { "content": "Формирование и скачивание отчета в формате XLSX. Параметры передаются в query-параметре body в виде URL-encoded JSON-строки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "18c13dfb-e4b7-4997-ab3f-41259bc10cdb", "name": "Бинарный файл книги Microsoft Excel (.xlsx)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a7941fa1-034b-412f-9fd2-de492e6999b6", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33af8347-1dd2-4426-a3c8-c43da8090e06", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d80d13e-a190-4983-a483-5ba3b5078ee8", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9784111a-fb0e-40b8-9ee2-79b101fea1d6", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b831685-9962-476c-addf-a391c9466af1", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf93cb4f-2776-4f21-a67b-221f2f1c4edc", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) JSON-строка с параметрами отчета (from, to, template_tables, units/groups). Пример: {\"from\":\"2026-09-01 00:00:00\",\"to\":\"2026-09-02 00:00:00\",\"template_tables\":[{\"id\":\"uuid\"}]}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a1a001cf-66a9-4417-9b84-5470facff5d3", "name": "Выгрузка отчета в формате Excel (POST)", "request": { "name": "Выгрузка отчета в формате Excel (POST)", "description": { "content": "Формирование и скачивание отчета в формате XLSX с передачей параметров в теле запроса (рекомендуется для сложных и объемных отчетов).", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7b2998c1-829e-4f28-a0f0-f0806ca66c1f", "name": "Бинарный файл книги Microsoft Excel (.xlsx)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "94b2d5f5-f046-47a6-ae92-09137142eb6d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13ee49de-8a51-41ec-8ef0-c630a346a705", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27b8f648-5dc4-4600-8966-bc99879ed920", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be81cbe3-ee03-4724-86f6-8011d01ddc10", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90956431-1c17-4cfc-bc15-4fe76c6df512", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12a28e02-a646-46d5-a418-e4397eba0412", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4415d42c-7d80-4c1d-9ac8-b712f3fe870d", "name": "Выгрузка отчета в формате PDF", "request": { "name": "Выгрузка отчета в формате PDF", "description": { "content": "Формирование отчета в виде документа Adobe PDF. Поддерживает включение вложений (files) в формате Base64.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/pdf" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ddf34d00-3d03-4b3d-aedb-05d17218ae25", "name": "Бинарный файл документа Adobe PDF (.pdf)", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/pdf" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "11886e29-ccf4-436d-8a9b-cedca244cf12", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "368ba360-6834-4b7f-87fa-825e07c4e29f", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02c9517a-5b03-4e0f-a5fe-25f56de4f255", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb3a1163-96da-47c2-aaae-0790ec9784a7", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad872b05-c7a9-4f35-8a26-541dacad4022", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36d686da-8abb-4066-a305-8953a6c2c510", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "93384efa-6696-4d3d-bebe-5d0ec9e12c1f", "name": "Выгрузка отчета в формате Word (DOCX)", "request": { "name": "Выгрузка отчета в формате Word (DOCX)", "description": { "content": "Формирование отчета в формате документа Microsoft Word (.docx).", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "79b54a20-f67a-4983-8c63-bc98295f3986", "name": "Бинарный файл документа Microsoft Word (.docx)", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5f811e10-e9b0-439e-ba81-085597e3d8cc", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47d63e20-8b16-4aa8-919c-891dc467bda8", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5407ae78-f103-43a0-89fa-7fa22fdac846", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13cdcf45-48b2-48eb-a531-aa53569939ff", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f87049d3-9fd2-4971-ba48-013ddb131e05", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c1893b1-390c-4e27-b7b9-4f6770e6afee", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_word" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b823c775-f578-4a7e-bf2e-18ecd6c80df4", "name": "Универсальный запрос данных произвольного отчета", "request": { "name": "Универсальный запрос данных произвольного отчета", "description": { "content": "Универсальный шлюз получения аналитических данных по таблицам и датчикам без строгой привязки к сохраненному шаблону.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "05414a83-2183-45d9-af69-12974201d5e6", "name": "Результат запроса отчета", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "611cfa2c-d7f4-484a-b0e7-4a28a89b967c", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94ee6198-029b-49d5-9df5-8f01c798f04a", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4cf1d62a-898b-4ea0-8b78-456abd3788f1", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3065cc6f-698d-440f-9948-e3476d4eb274", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "165597e9-8533-4273-9462-6e7d62bfa9f2", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36c67c51-9a19-4853-8b14-38203f9e9327", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_any" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"files\": [\n \"\",\n \"\"\n ],\n \"from\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c0882dd5-4ad5-4f70-897a-d9759e3fb60a", "name": "Получение финансового отчета по учетным записям", "request": { "name": "Получение финансового отчета по учетным записям", "description": { "content": "Возвращает сводные финансовые данные по компаниям и объектам. В параметре body передается JSON-строка поискового запроса: {\"search\":\"ООО ТехноЛогистика\"}.", "type": "text/plain" }, "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4593cc45-68ae-4627-a021-ea6f74dbf20d", "name": "Финансовый отчет по компаниям и объектам", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"group_name\": \"\",\n \"report\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5706807-d046-4c46-bc60-af6f8c9adb07", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a701bddb-1c71-440a-8f2f-ba2e81b70994", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7764a6bf-82d7-4ac8-a0ce-95d60fd6bfdd", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69a40007-c46f-4cb9-99b6-697b1282b2b0", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7065fe17-2815-47a5-8258-528fe834b4da", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bd185b9-87f8-4f95-bef4-19674a114211", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "finance" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "JSON-строка фильтрации поиска, например: {\"search\":\"ООО ТехноЛогистика\"}", "type": "text/plain" }, "key": "body", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8e0179fa-f03a-4c37-b5c2-7cbdb64f1a0c", "name": "Построение тепловой карты перемещений объектов", "request": { "name": "Построение тепловой карты перемещений объектов", "description": { "content": "Агрегация гео-точек за указанный интервал времени для визуализации плотности и интенсивности перемещения транспорта на карте (Heatmap).", "type": "text/plain" }, "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2391f7e1-371c-457a-9ab9-e0f26846261e", "name": "Массив точек с координатами и весами плотности", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"weight\": \"\"\n },\n {\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"weight\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6117a23-d7df-4f7e-a0a5-85585b88f16d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18484d86-27c7-437c-a0ad-b0c64aa0f32f", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f54e080-3cb5-4522-a680-96a608cd9537", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d860d1f8-8e56-451b-8edd-30d45f4185a9", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b1ab661-04ea-498f-a373-098d518840ee", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97e1bb80-727c-41ee-85a3-07fa9048e03e", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "heat_maps" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"max_radius\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "04bfb78b-2d44-4ab9-9c6d-bf08602b6971", "name": "Получение последних телематических данных по объектам", "request": { "name": "Получение последних телематических данных по объектам", "description": { "content": "**Получение последних данных по объектам**\n\n---\n\nВ запросе можно указать объекты или одну группу\n\n---\n\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Пример запрос с группой:\n\n```\n{\n \"groups\": [\n {\n \"id\": \"5dabceab-ae23-493f-8c04-8028c7066e8a\"\n }\n ]\n}\n\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```\n[\n {\n \"unit\": {\n \"id\": \"2bd74bab-8173-4c06-8fd8-ad923d3ad7d3\",\n \"imei\": \"862531040000001\",\n \"name\": \"КамАЗ 5490 (А123АА777)\",\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\": \"г. Москва, ул. Промышленная, д. 12\",\n \"trip_detector\": \"movement\"\n }\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "82b662c0-e624-460d-9a31-ccdf2c599d38", "name": "Массив последних телематических состояний объектов", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\",\n \"imei\": \"\"\n },\n \"last_point\": {\n \"unix_timestamp\": \"\",\n \"speed\": \"\",\n \"altitude\": \"\",\n \"satellites\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"address\": \"\",\n \"trip_detector\": \"stop\"\n }\n },\n {\n \"unit\": {\n \"id\": \"\",\n \"name\": \"\",\n \"imei\": \"\"\n },\n \"last_point\": {\n \"unix_timestamp\": \"\",\n \"speed\": \"\",\n \"altitude\": \"\",\n \"satellites\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\",\n \"address\": \"\",\n \"trip_detector\": \"movement\"\n }\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbc12492-23a7-4b76-9d69-c14b9f188c1b", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "503b38fc-043d-4d29-9ace-d0e802755f03", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83f5d58c-a01d-4afb-bb5c-7bf6cd835111", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20c821e1-bd9f-41c3-a776-aeac84c5301c", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f438df7a-90ae-47bc-a96a-3ba65c855ed1", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5184afe5-a502-4c22-83f9-bdaa49a63a0a", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "last_point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fa825ca9-70c3-4882-8352-af157c26a9ad", "name": "Отмена фонового расчета отчета", "request": { "name": "Отмена фонового расчета отчета", "description": { "content": "Прерывает асинхронное выполнение генерации отчета на расчетном бэкенде по переданному _requestId.", "type": "text/plain" }, "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "150ebe38-0af7-4cff-bef9-fee2bf4e1720", "name": "Запрос на отмену отчета успешно принят", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d108c2c5-6831-48b0-87a5-f3980f98212d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48694409-1fd9-412a-8307-c924b3ce748c", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e332a5f4-8828-42cf-8dcb-239929c239c4", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a4c9e49-8e83-4b4a-aa8f-7d7c1657f45b", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71ceebe3-0f75-449c-a0c3-8f94e96f631a", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee5ddbe4-4bc9-4c5a-a1d4-c60c831a653f", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "cancel_report" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_requestId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Шаблоны отчетов", "description": "", "item": [ { "id": "e291790d-481e-4719-a4ea-502d6914cafd", "name": "Получение списка шаблонов отчетов", "request": { "name": "Получение списка шаблонов отчетов", "description": { "content": "Возвращает полную конфигурацию шаблонов отчетов компании. Если передан параметр ids (через запятую), возвращает только указанные шаблоны.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "36602f0a-35f7-45d9-8595-638737360ea6", "name": "Список шаблонов отчетов с конфигурацией таблиц и колонок", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f9685a3-8ecc-4cac-9d70-d5dd68c92bca", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5f20a2d-1a00-4f2c-af3e-fd8f32272710", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c83a8a3-97e6-4b46-9ccb-90fd165aacf4", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d4cacb4-cf41-4569-b6fb-4da733be945e", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a9ff298-ade2-4c09-a66d-7da266b2c0fa", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cede5cc-e9d4-4ad2-b687-cee000ef52f9", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Список UUID шаблонов через запятую. Если не передан или пуст — возвращаются все шаблоны.", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d38eda2d-41da-4c30-be4c-f8fb2ae96a5f", "name": "Создание нового шаблона отчета", "request": { "name": "Создание нового шаблона отчета", "description": { "content": "Создает новый шаблон отчета с заданным набором таблиц, вычисляемых параметров и прав видимости.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "594e1de8-8c83-4c68-99ee-8f9f1075f882", "name": "Созданный шаблон отчета", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dedee1da-90c1-4fd4-ba2b-9656461e3c5a", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63e98bf3-7a20-4be1-95d6-41b938e6ce10", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4236dfb2-9d0e-40c6-9d04-755a8132b36c", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8714bc8-4e5e-4e72-b042-0b62f1e00a01", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4523d0b3-3b5c-4d44-9162-4229a1378d57", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40c4b341-a402-469f-9641-39e85b17f3dd", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"template_tables\": [\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n },\n {\n \"_default\": \"\",\n \"geozones\": [\n \"\",\n \"\"\n ],\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"reportTemplate\": {\n \"id\": \"\"\n },\n \"sensors\": [\n \"\",\n \"\"\n ],\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n },\n {\n \"_visible\": \"\",\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"id\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\"\n }\n ],\n \"time_group\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e92c319e-692c-4c4b-b910-b9e503bbe60d", "name": "Массовое удаление шаблонов отчетов", "request": { "name": "Массовое удаление шаблонов отчетов", "description": { "content": "Удаление нескольких шаблонов отчетов по переданному списку идентификаторов в query параметре ids.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c89c6bcf-0d38-47c4-be73-1ead830aec54", "name": "Результат удаления", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6557fbda-88a1-4651-aa2b-ecefe86e4dd2", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10809a83-e863-4df3-8b38-e62404e904bf", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8edae986-731b-4647-a1a6-5ca5fbf2fd4b", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06291ada-cabb-4fa0-bb22-96d2ec2c4298", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64c4fdbe-f79b-4794-a49b-0b7682cff5b1", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "965073b7-1d29-45de-b108-198be7b3674b", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Список UUID шаблонов через запятую для удаления", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a6161e12-a1cd-42de-9ddf-6fc6016a60a7", "name": "Получение списка шаблонов отчетов с пагинацией и сортировкой", "request": { "name": "Получение списка шаблонов отчетов с пагинацией и сортировкой", "description": { "content": "Возвращает реестр шаблонов компании с поддержкой сортировки и пагинации.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e6572de2-d6fc-4c2a-bac6-b1465b46a98a", "name": "Список шаблонов отчетов с общим количеством", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"list\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n }\n ],\n \"max\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6784a18e-69c4-4bde-93e9-d58c59e32c43", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1d37ae7-2735-4e32-9082-a7531a4c11dd", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40b45e1a-846b-41f5-8adc-7a880cd950a9", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d48c0cd4-e451-4a6f-bdc2-9374c3e1e0f3", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee958bea-ca1f-4f69-b76e-7cd49755f660", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f09644cf-4d6a-4e13-81a1-443c9ffeda6c", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\",\n \"search\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd030ddf-fd06-473e-b84b-cea57866cf7d", "name": "Получение вычисляемых полей для таблицы отчета", "request": { "name": "Получение вычисляемых полей для таблицы отчета", "description": { "content": "Возвращает список доступных полей и функций формул для указанного типа таблицы (trips, stays, sensors, statistics и др.).", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9ea3d251-0a6b-4f3d-bb84-eb753ea0ab7b", "name": "Список полей с метаданными (key, name, type, unit)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"key\": \"\",\n \"name\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"type\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b46766f-73e5-47e1-bf13-60bb2959545c", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e94c5313-c786-4f61-8e47-d96595b76a60", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10afce0f-f8f5-43b4-9995-050f0e79f4fd", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c884c744-db4a-49f3-992e-6ab21f6d97dd", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5dd67612-d7f1-44af-8f9e-0af9997cb4d4", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6098bd9-5e11-4b1d-ba82-d20fcc051898", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "computable_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, geozones, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "12cd54d0-ae77-40c6-bb0d-523498a6be62", "name": "Получение списка полей таблицы для экспорта в Excel", "request": { "name": "Получение списка полей таблицы для экспорта в Excel", "description": { "content": "Возвращает список колонок таблицы шаблона отчета, доступных для включения в шаблон Excel-выгрузки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "33c9a048-64d9-479c-878c-989ae621dc47", "name": "Список полей для Excel-экспорта", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fe77c38-10d3-43e1-a843-c4aefd839fcb", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45d2f890-1be3-4999-8d97-4ef566c0c200", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bbce992-ebac-49a7-9a18-56a64797fd08", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "baf600cc-beef-441d-b877-28e936a78cf3", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "298148e4-868b-4e56-a0dc-b451451c0b6a", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6c24be7-b58f-4a5d-91e0-583ed7adfbcc", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "excel_table_fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Ключ типа таблицы отчета", "type": "text/plain" }, "key": "table_key", "value": "" }, { "disabled": false, "description": { "content": "UUID сконфигурированной таблицы шаблона", "type": "text/plain" }, "key": "table_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d86b1426-0212-47cc-ab47-73660a2e294b", "name": "Валидация математической формулы вычисляемого поля", "request": { "name": "Валидация математической формулы вычисляемого поля", "description": { "content": "Проверяет синтаксическую корректность математического выражения вычисляемой колонки шаблона отчета.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7f8a644a-efb3-4a45-a969-36eeb39f43f3", "name": "Результат валидации формулы", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"valid\": \"\",\n \"message\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "135c2e76-d4b3-428e-8b1e-ff7e91932c5b", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcf663e2-b567-495e-961d-0f325e7e44f5", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a5d64f3-a0f2-452a-9264-478ee415065e", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31daff29-eea4-413e-995a-b2d5443b7162", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa8e2649-34c9-4818-b1d9-04f28d57ad56", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0cb244cd-c93b-4368-86e1-c65da0966154", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_formula_check" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"formula\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aafd1e6e-5980-4f09-922e-bd4e53e1a309", "name": "Валидация конфигурации таблицы шаблона отчета", "request": { "name": "Валидация конфигурации таблицы шаблона отчета", "description": { "content": "Проверяет корректность связей, фильтров и группировок таблицы перед ее сохранением в шаблон отчета.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8e451a4c-cdc8-4977-a6ab-4ebbb967eefb", "name": "Результат валидации таблицы шаблона", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"valid\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9af6d6c-aa15-45fe-a5fe-c2cc4b5789bb", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ee99265-2ab0-4df9-8e7c-9e65bb915361", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "363349de-e3e5-4c6c-aba6-50f6b31e076a", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8224ae7d-891d-4fd9-8319-d662ac22ca92", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa33ccf5-7537-40c9-9c93-bf13ca5444b2", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f5fcc9b-d3ae-4de8-8a73-8c4e2364f7fc", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "table_validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"column_group\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"show_itog\": \"\",\n \"template_columns\": [\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n },\n {\n \"filter_max\": \"\",\n \"filter_min\": \"\",\n \"is_visible\": \"\",\n \"key\": \"\",\n \"meta\": \"\",\n \"name\": \"\",\n \"sort\": \"\",\n \"type\": \"\",\n \"use_filter\": \"\"\n }\n ],\n \"template_computable_columns\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n },\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"time_group\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "288d9f0b-3a5f-4028-b0a2-4ada1653fcb2", "name": "Обновление шаблона отчета", "request": { "name": "Обновление шаблона отчета", "description": { "content": "Обновляет параметры существующего шаблона отчета (название, порядок, таблицы, колонки, фильтры).", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "template_id", "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1b4095dc-8364-433c-83e5-bfa68a4bf6b5", "name": "Обновленный шаблон отчета", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c0cbf8c-3805-460e-a348-423e8160c6b5", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "832c91ea-b194-4c6f-8688-4f33bddbe515", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41ec7ff1-dd1e-4af0-a69c-cfe093b4429b", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a3624cb-1f94-4405-8113-8319f53e4451", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ba46527-9c79-4cdb-a693-c571006ed9ea", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66d882dd-2845-4d56-a3d4-f7d7d4287e3f", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"name\": \"\",\n \"is_default\": \"\",\n \"sort\": \"\",\n \"template_tables\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"time_group\": \"\"\n }\n ],\n \"users_ids\": [\n \"\",\n \"\"\n ],\n \"_default\": \"\",\n \"_delete\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cc7d37a5-fc84-4b08-8662-b4e875ef06b4", "name": "Удаление шаблона отчета по ID", "request": { "name": "Удаление шаблона отчета по ID", "description": { "content": "Физическое удаление шаблона отчета из базы данных системы.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "template_id", "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6426e38f-3865-4106-b46b-af1e65d1efba", "name": "Шаблон отчета успешно удален", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d710ff25-d36a-493d-ae2d-c92f8b043c08", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2007e4c4-67d7-472d-bfca-83f407e1504d", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2d33956-a410-495f-b3b5-4d344850e8e9", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f482af99-18a0-4451-a663-07d740dbc31c", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc5fcafa-0612-469d-867d-154e449d490b", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7db74156-8303-4d81-be23-6435a00749f9", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", ":template_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона отчета для удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "template_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1b35de93-a454-424d-bbb1-f0e90e027851", "name": "Получение доступных временных группировок для таблицы отчета", "request": { "name": "Получение доступных временных группировок для таблицы отчета", "description": { "content": "Возвращает перечень доступных способов группировки строк отчета (по дням, по неделям, по месяцам, по объектам, по водителям, по сменам).", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c238d2f6-83c0-4494-991c-c8559cbddad2", "name": "Список группировок", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"key\": \"\",\n \"name\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c95a65ff-f58a-4189-bc07-b446a79e46a8", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fefa2d1f-d0f9-40d8-96ae-8c8599ea0571", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd3dba95-66c9-4813-a4a6-ce34224f1c61", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8f63bac-e98d-4e5b-a35e-43fdd3bbde5a", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f27af2da-4e57-4b7f-87cb-7e6dc5886476", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcf69b49-968f-413e-b798-045779e680cb", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "time_groups" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Ключ таблицы отчета (trips, stays, fuel_movement и т.д.)", "type": "text/plain" }, "key": "table_key", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d39ddfc5-80a4-4c0c-adb2-07caee469eaa", "name": "Изменение порядка сортировки шаблонов отчетов", "request": { "name": "Изменение порядка сортировки шаблонов отчетов", "description": { "content": "Обновляет поле sort для шаблонов отчетов компании в соответствии с переданным массивом идентификаторов.", "type": "text/plain" }, "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "51ba3568-e603-437c-a3b6-993adfc750e2", "name": "Порядок шаблонов успешно сохранен", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35d39632-8015-4f1f-b58b-46e211a8fce4", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06686f64-acd6-4242-864e-adc92ed8e21d", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0aa714eb-492e-426c-9646-4268301cd4bc", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "756a39ad-d9bb-4fe7-8d8e-226614c3bd10", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d096995-6f55-48d3-a455-d755e4792d8a", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4472c9ec-da8e-48ea-8961-553b45e1d81e", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "report_templates", "reorder" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "[\n {\n \"id\": \"\",\n \"sort\": \"\"\n },\n {\n \"id\": \"\",\n \"sort\": \"\"\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Треки", "description": "", "item": [ { "id": "b6ab5e4b-5d43-406f-bc33-cb6052dc38c0", "name": "/points_geozones", "request": { "name": "/points_geozones", "description": { "content": "**Получение точек с информацией о вхождении в геозоны**\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\nПример запроса:\n\n``` json\n{\n \"model\": \"units\",\n \"value\": \"тест\", // для поиска\n \"from\": 0,\n \"count\": 100\n}\n\n ```\n\nПример ответа:\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f2c377a8-8f58-4685-b38e-7854cd530d57", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "49c6fb07-ccb8-47f2-a704-5b1bbce8b911", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e23b5d5-8674-4ce9-a5fc-a74481d9e1cf", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1cad916a-f1de-4a62-9c5d-72a729a492f7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c804e369-d2d5-40db-b019-bc373569351f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "456e28f2-2298-40ba-a8c0-bc7c97702b78", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65d1f9b0-5664-4d32-a0fa-daa4619dd9e3", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "points_geozones" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozones\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"max\": \"\",\n \"offset\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "82b27e65-2b05-4400-beda-3070214bc0a8", "name": "/point", "request": { "name": "/point", "description": { "content": "**Метод возвращает информацию о конкретной точке объекта (аннотация точки).**\n\n---\n\nАннотация содержит в себе краткую информацию о точке: \ndatepoint - время данной точки. \nspeed - скорость в этой точке. \n_marker_latlon - координата в формате \\[longitude, latitude\\]. \n<...далее идут все датчики юнита, со своими показаниями, пересчитанными по формуле. key - id датчика, name - имя...>\n\nПараметр \"from\" опциональный. При его отсутствии будет возвращена последняя точка юнита.\n\n---\n\n**Пример запроса:**\n\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**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d6f587ae-8cac-45ef-81b5-d2b5dd3ceb0a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5032f23a-54c2-465b-a124-f027b55434bc", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c29ce81-a82c-4fec-ab4a-2ed86f6c2e8e", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15c1ac31-f5a8-457b-b30c-f4abf2d72e46", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82c11122-595b-4ee2-b989-34ff530fbb4f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "301a8688-b054-4ded-b4ed-23a992d981d6", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca37a3c1-1d10-4401-993b-3946e83ad6e8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "point" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1367cd04-fa88-45a6-b46c-d5af4272b2dc", "name": "/fasttracks", "request": { "name": "/fasttracks", "description": { "content": "**Запрос на получение трека юнита**\n\n---\n\nЗапрос состоит из 4 параметров.\n\nunits - id объекта, берется всегда ПЕРВЫЙ объект, передавать несколько объектов не имеет смысла.\n\nfrom - начало периода\n\nto - конец периода\n\nzoom - зумирование трека. Чем выше значение, тем больше точек будет пропущено (исключено из выборки) и тем менее точным будет сам трек. По сути, это площадь вокруг текущей точки. Будет отрисована та следующая точка, которая не попадёт в эту площадь, т.е. некий шаг пропуска.\n\nВесь трек состоит из суб-треков, так называемых отрезков, которые в свою очередь состоят из конкретных точек, в которых содержится информация о состоянии объекта в конкретный момент времени.\n\n---\n\nОтвет имеет две колонки: columns и values.\n\nprocess_id - уникальный идентификатор для выделение трека в области карты.\n\nColumns - это набор полей объекта. Данная колонка всегда статична, поэтому индекс поля в этой колонке всегда равен индексу поля в конкретных точках (т.е. Если longitude в Columns имеет индекс 2, то в каждой точке мы найдем конкретное значение для longitude под индексом 2).\n\n---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2b4e8ec5-682c-44e7-9cc5-4156a823388a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "98912cea-7c45-4509-82cf-b9fe7f14c4e3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9182414a-a2e4-4c32-9857-d01b28da41c9", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a407cace-0f2e-48e7-abc3-bf0189f092a2", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df005009-5389-458f-a2f4-93ece602ddce", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31cfbb73-1988-4de7-9211-d61377bd2b34", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b04673b7-e142-432a-94d8-1cf341af5913", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"zoom\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "287fc78e-3a20-4a7d-8a18-312b8936b984", "name": "/box_tracks", "request": { "name": "/box_tracks", "description": { "content": "**Запрос на получение трека в прямоугольной области карты**\n\n---\n\nЗапрос состоит из 2 параметров:\n\nprocess_id - уникальный идентификатор, полученный в ответе на запрос /fasttracks .\n\nbox - массив \\[latitude1, longitude1, latitude2, longitude2\\].\n\nlatitude1, longitude1 - координаты нижнего левого угла прямоугольника.\n\nlatitude2, longitude2 - координаты верхного правого угла прямоугольника.\n\nzoom - зумирование .\n\nОтвет имеет такую же структуру, как в запросе POST /fasttracks.\n\n---\n\n**Пример запроса:**\n\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---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "40ac9dac-095d-4765-870f-b675e23e08e5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fdde470a-6f50-4317-bebe-6845e954f88b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd482f72-abe1-4995-be65-21855887cf5e", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "87ee590e-38d2-4497-9212-a683ecfc33fe", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b9d7c0d-2f94-424a-8cec-a427de959d8a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "512f708e-808a-4d1b-9de2-d8be6592e94c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d483f2c3-7d81-4e58-adcc-f557e167f0b7", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "box_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"box\": [\n \"\",\n \"\"\n ],\n \"process_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f9d7316b-5265-4d45-9ca2-7014a71560a3", "name": "/fasttracks_group", "request": { "name": "/fasttracks_group", "description": { "content": "**Получение треков группы объектов**\n\n---\n\nСтроит треки для нескольких объектов или для групп объектов за период. Для каждого объекта возвращается отдельный трек со своим цветом.\n\nГрупповой трек — обзорный: он показывает только движение и прореживает точки тем сильнее, чем больше объектов в запросе. Подробный трек одного объекта со стоянками — `POST /fasttracks`.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Параметры:**\n- units: array - объекты, для которых строится трек. Обязательно, если не указан groups.\n - id: string (UUID) - ID объекта. Обязательно.\n- groups: array - группы объектов, трек строится по всем объектам групп. Обязательно, если не указан units.\n - id: string (UUID) - ID группы. Обязательно.\n- from: string - начало периода, формат `yyyy-mm-dd hh:mm:ss`, время компании. Обязательно.\n- to: string - конец периода, формат `yyyy-mm-dd hh:mm:ss`, время компании. Обязательно.\n- zoom: integer - масштаб карты, от 1 до 20. Обязательно. Используется для упрощения линии трека под масштаб.\n\nОграничения:\n- Учитываются только активные объекты, архивные исключаются.\n- Не больше 500 активных объектов. Если их больше, ответ 200, но все треки в нём пустые (см. «Ответ»).\n- На весь ответ отводится до 200 000 точек. Число точек на объект зависит от количества объектов N в запросе:\n\n| Объектов | 2–10 | 11–20 | 21–40 | 41–80 | 81–100 | 101–150 | 151–200 | 201–300 | 301–500 |\n|---|---|---|---|---|---|---|---|---|---|\n| Точек на объект, не больше | 20 000 | 10 000 | 5 000 | 2 500 | 2 000 | 1 333 | 1 000 | 666 | 500 |\n\n- В трек попадают только точки в движении, со скоростью от 3 км/ч. Стоянки не отображаются. Если объект весь период стоял, его трек пустой.\n- Если точек в движении больше лимита, они равномерно прореживаются по времени. Первая и последняя точки остаются всегда.\n- Готовый трек объекта хранится 5 минут. Повторный запрос с теми же параметрами в течение 5 минут вернёт сохранённый трек, новые точки за это время в нём не появятся.\n\n---\n\n**Пример запроса:**\nТрек группы объектов за сутки\n\n```\n{\n \"groups\": [{\"id\": \"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\"}],\n \"from\": \"2026-10-01 00:00:00\",\n \"to\": \"2026-10-01 23:59:59\",\n \"zoom\": 14\n}\n```\n\nТрек двух объектов\n\n```\n{\n \"units\": [\n {\"id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\"},\n {\"id\": \"c12345b2-6789-1ab2-3cd4-1ab234cd5e67\"}\n ],\n \"from\": \"2026-10-01 00:00:00\",\n \"to\": \"2026-10-01 23:59:59\",\n \"zoom\": 14\n}\n```\n\n---\n\n**Ответ:**\nКод 200. Массив треков, по одному на объект.\n\n- unit_id: string (UUID) - ID объекта.\n- unit_name: string - имя объекта.\n- color: string - цвет трека объекта, HEX.\n- process_id: string (UUID) - ID построения трека.\n- columns: array - названия полей точки. Индекс поля в columns совпадает с индексом значения в каждой точке.\n- values: array - отрезки трека. Трек делится на отрезки по градации скорости.\n - style: string - служебное поле, всегда `style_0`. Для цвета не использовать.\n - new_style_key: string - ключ стиля отрезка, цвет — в legenda.newStyles.\n - points: array - точки отрезка, каждая — массив: время (unix, время компании), широта, долгота, скорость (км/ч), угол (градусы), расстояние от предыдущей точки (м). Последняя точка отрезка повторяется первой в следующем.\n- legenda: object - легенда градации скорости.\n - title: string - заголовок легенды.\n - newStyles: array - стили: key — ключ из new_style_key, hex — цвет, min и max — границы скорости, км/ч (max у последнего стиля — null).\n- sum_distance: number - не заполняется в групповом треке, всегда 0.\n- has_more_points: boolean - служебное поле.\n\n```\n[\n {\n \"unit_id\": \"b12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"unit_name\": \"Объект 1\",\n \"color\": \"#641e16\",\n \"process_id\": \"d12345b2-6789-1ab2-3cd4-1ab234cd5e67\",\n \"columns\": [\n {\"key\": \"datepoint\", \"value\": \"Дата\"},\n {\"key\": \"latitude\", \"value\": \"Широта\"},\n {\"key\": \"longitude\", \"value\": \"Долгота\"},\n {\"key\": \"speed\", \"value\": \"Скорость\"},\n {\"key\": \"angle\", \"value\": \"Угол\"},\n {\"key\": \"distance\", \"value\": \"Дистанция\"}\n ],\n \"values\": [\n {\n \"style\": \"style_0\",\n \"new_style_key\": \"style_1\",\n \"points\": [\n [1759305600, 55.751244, 37.618423, 45, 101, 0.0],\n [1759305630, 55.752011, 37.620104, 52, 98, 128.4]\n ]\n }\n ],\n \"legenda\": {\n \"title\": \"Скорость (км/ч)\",\n \"newStyles\": [\n {\"key\": \"style_0\", \"hex\": \"#51AAEB\", \"min\": 0.0, \"max\": 40.0},\n {\"key\": \"style_1\", \"hex\": \"#623F73\", \"min\": 40.0, \"max\": 80.0},\n {\"key\": \"style_2\", \"hex\": \"#E37A3A\", \"min\": 80.0, \"max\": 120.0},\n {\"key\": \"style_3\", \"hex\": \"#DD1E1E\", \"min\": 120.0, \"max\": null}\n ]\n },\n \"sum_distance\": 0,\n \"has_more_points\": false\n }\n]\n```\n\nПустой трек: объект весь период стоял или по нему не удалось получить данные — `values: []`. Если в запросе больше 500 активных объектов, все элементы массива пустые и без unit_id и unit_name: `{\"columns\": [], \"values\": [], \"process_id\": null, \"color\": \"#641e16\", \"sum_distance\": 0, \"has_more_points\": false, \"legenda\": null}`.\n\nОшибки:\n- 400 — не указан from, to или zoom.\n- 422 — в запросе нет активных объектов; даты в неверном формате.", "type": "text/plain" }, "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5bfa75ba-3a42-4107-8dc5-4999afa5425c", "name": "Массив треков, по одному на объект. Пустой трек — `values: []`.", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"unit_id\": \"\",\n \"unit_name\": \"\",\n \"color\": \"\",\n \"process_id\": \"\",\n \"columns\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"values\": [\n {\n \"style\": \"\",\n \"new_style_key\": \"\",\n \"points\": [\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ]\n ]\n },\n {\n \"style\": \"\",\n \"new_style_key\": \"\",\n \"points\": [\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ]\n ]\n }\n ],\n \"legenda\": null,\n \"sum_distance\": \"\",\n \"has_more_points\": \"\"\n },\n {\n \"unit_id\": \"\",\n \"unit_name\": \"\",\n \"color\": \"\",\n \"process_id\": \"\",\n \"columns\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"values\": [\n {\n \"style\": \"\",\n \"new_style_key\": \"\",\n \"points\": [\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ]\n ]\n },\n {\n \"style\": \"\",\n \"new_style_key\": \"\",\n \"points\": [\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ]\n ]\n }\n ],\n \"legenda\": {\n \"title\": \"\",\n \"newStyles\": [\n {\n \"key\": \"\",\n \"hex\": \"\",\n \"min\": \"\",\n \"max\": \"\"\n },\n {\n \"key\": \"\",\n \"hex\": \"\",\n \"min\": \"\",\n \"max\": \"\"\n }\n ]\n },\n \"sum_distance\": \"\",\n \"has_more_points\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d15ee92-64b5-4bca-ab60-9f6caa7189d4", "name": "Не указан from, to или zoom", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f29da94a-3727-4e5c-be84-a66c4fb1d9a2", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac6c098c-0d53-4eb3-ba01-99cfaab93f74", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afc9d9fd-052e-4751-a5df-60cbb681e21f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1496f78b-a31c-434b-852e-6de2afc2c83b", "name": "В запросе нет активных объектов или даты в неверном формате", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab1ebccd-dcff-4924-9f75-e940504b3b29", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_group" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"zoom\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"groups\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e09d2617-1acb-453e-87e1-fc91188cbf8f", "name": "/datepoint", "request": { "name": "/datepoint", "description": { "content": "**Получение номера записи в журнале по искомой дате**\n\n---\n\nunits - объект. \nfrom - начало интервала журнала. \ndatepoint - искомая дата.\n\n---\n\n**Пример запроса:**\n\n```\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**Пример ответа:**\n\n```\n{\n \"index\": 2006\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7347eb73-899d-4a29-9906-fc7dc4962152", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e3fce571-9c11-43c9-80bb-afe597edd815", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ead780a2-90db-49ca-977f-bfdc48e164e8", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8c18662-889a-4359-922f-733ad6f7be05", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6976d409-697f-404d-a8a7-202c35017bad", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fccf2ff-7bd6-48dd-8e02-44d5d5d7f13b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d39ef868-26ff-459d-a4c3-9823433e9795", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "journal_index" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"datepoint\": \"\",\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "65b2df17-a4ae-4944-8238-80615b64f852", "name": "/fasttracks_to_geozone", "request": { "name": "/fasttracks_to_geozone", "description": { "content": "**Создание геозоны на основе трека объекта**\n\n---\n\nunits - id объекта, берется всегда ПЕРВЫЙ объект, передавать несколько объектов не имеет смысла.\n\nfrom - начало периода\n\nto - конец периода\n\ngeozone - все данные для создания геозоны, кроме точек (geometry). см. POST /geozones\n\nОтвет - Поля отправленные в geozone в запросе + geometry - координаты\n\n---\n\n**Пример запроса:**\n\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---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fca5f3ef-3ad7-4fd1-bce5-671dfad863ff", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "359b418d-f6b4-4c83-94aa-2646246e888c", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "227c589c-551d-4418-b545-eff1549a4912", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "877b0452-72ac-4b6a-ac00-80690a0f9536", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a5ca12c-e761-4895-a379-bad22ce79da9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd515fd6-ce8f-4c26-a5a1-0df74280a0e7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09c71633-81fd-43ab-b679-29fc1445ebfe", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "fasttracks_to_geozone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"geozone\": {\n \"color\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"icon\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"name\": \"\",\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"width\": \"\"\n },\n \"to\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4b31d175-2927-46e1-a1ae-d9a59b1e2af6", "name": "/tracks/get_tracks", "request": { "name": "/tracks/get_tracks", "description": { "content": "**Запрос для получения трека**\n\nТело запроса JSON\n\n---\n\nПоля запроса :\n\nunit_id - ID объекта\n\nfrom - начало периода, в формате yyyy-MM-dd HH:mm:ss, необходимо отправлять в UTC+0\n\nto - конеч периода, в формате yyyy-MM-dd HH:mm:ss, необходимо отправлять в UTC+0\n\nmin_lat - Минимальное значение широты, вещественное число\n\nmax_lat - Максимальное значение широты, вещественное число\n\nmin_lon - Минимальное значение долготы, вещественное число\n\nmax_lon - Максимальное значение долготы, вещественное число\n\nzoom - зум, целое число\n\nprocess_id - опциональное поле, для указания идентификатор запроса на клиенте\n\nНа странице локатора дополнительно отправить параметр locator_id - ID локатора\n\n---\n\n**Пример запроса:**\n\nGET [https://api.skif.pro/api_v1/tracks/get_tracks](https://api.skif.pro/api_v1/tracks/get_tracks?unit_id=93a62a79-a117-4b4e-b53a-568e1d06e603&from=2023-10-01)\n\n```\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\n**Ответ:**\n\nКаждый элемент массива points в таком формате: \\[datepoint_delta,latitude,longitude,speed\\]\n\ndatepoint_delta - разница datepoint от предыдущей записи в секундах. Для первого элемента это разница от from. datepoint в unix timestamp.\n\n---\n\n**Пример ответа:**\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8d156c4f-ce5e-472a-b51e-a5fc8da62519", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e139ecf6-b520-44ba-a917-61668f9a5e49", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "299d5e59-d4ac-4833-9774-ef66899e5fcf", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da924b7d-a7d1-4611-9169-f39c2972edde", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e15a56b-7397-4337-8a25-b7e3890f8579", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b90eaa05-66ed-431b-a0de-cdc6476bb3d7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52941afb-d4b8-4071-a930-6114b4ff58ed", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "tracks", "get_tracks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0c2983a3-4e2e-40d0-9b2d-807e1f3db768", "name": "/point/batch", "request": { "name": "/point/batch", "description": { "content": "

Получение краткой информации (аннотации) о конкретной/последней точке для нескольк объектов

\n
\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
\n

Ответ возвращает массив JSON, каждый элемент которого представляет собой аннотацию об объекте.

\n

Пример ответа:

\n
[\n    {\n        \"columns\": [\n            {\n                \"key\": \"unit_name\",\n                \"name\": \"Имя\",\n                \"value\": \"Урал АТЗ (А123АА777)\",\n                \"group\": \"main\"\n            }\n        ]\n    },\n    {\n        \"columns\": [\n            {\n                \"key\": \"unit_name\",\n                \"name\": \"Имя\",\n                \"value\": \"КамАЗ 5490\",\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\": \"862531040000020\",\n                \"group\": \"hidden\"\n            },\n            {\n                \"key\": \"_sim1\",\n                \"name\": \"sim1\",\n                \"value\": \"+79990000001\",\n                \"group\": \"hidden\"\n            },\n            {\n                \"key\": \"_sim2\",\n                \"name\": \"sim2\",\n                \"value\": \"+79990000002\",\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
", "type": "text/plain" }, "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ea3a40b0-5539-4eab-910b-141283ec40a9", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "91dc1e66-2856-4e23-8fd7-e8ab038e0a8c", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b567069c-600a-4bb2-be57-37d86447be0c", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "edb0ce52-c9a4-48a7-bdff-3e66ce796d14", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d3eed0de-d264-452b-b52a-076c5263984c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31768531-6b67-4a60-8998-93bf7ec0e073", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a36dbb3-a69f-4874-b0c4-450c0ce414f0", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "point", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Уведомления", "description": "", "item": [ { "id": "24f5bd4b-e5ac-42d7-a382-6d0effb1149a", "name": "/notifications?ids=:ids", "request": { "name": "/notifications?ids=:ids", "description": { "content": "**Получение шаблона уведомления**\n\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b937ae75-7ac1-451a-b953-5afe8dba1354", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "773d7470-2dcd-48ab-9aee-bdfe9a577353", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "952b4583-d36c-4cdc-8275-eb62e8663a8b", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b42191ab-1454-451d-96f0-5b1d1ffef925", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a275da1-cec9-4a45-9799-5c40f71e2517", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c193f65f-7612-4542-bf6e-e4278f11f0ec", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18685029-07cc-489d-be94-fd0fb09f3ea8", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c2952814-cca1-4c86-84b2-fefd6615a6a4", "name": "/notifications", "request": { "name": "/notifications", "description": { "content": "**Создание нового шаблона уведомлений**\n\n---\n\nМодель шаблона:\n\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 delivery_commands - массив настройки для отправки команды, каждый элемент\n состоит из полей terminal_type_key - ключ тип протокола, command - текст команды.\n List 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\n---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6951b443-370b-408a-b88a-ef5b2fe0cf28", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a9de4cfe-b59d-4b74-a3e1-2e21d5c78c99", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e0eeae8-7947-4df4-bb65-7a92e7af059d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "434469b9-d799-4e54-be06-edc2a2662504", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46148816-0b88-487d-86d6-84e747798549", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5bdc65e2-1a3c-4b4d-b959-0ef01065324b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3feb876-ae8b-4f34-8420-a5306060593b", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "458abb31-b3ba-4b7c-9b01-b477df7282ff", "name": "/notifications?ids=:ids", "request": { "name": "/notifications?ids=:ids", "description": { "content": "**Планирование удаления шаблона уведомления**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "01f3ffb1-72b5-48c2-8763-99e60c116d45", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "70aa6815-471a-4e84-82ff-0271a46165c3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9225083d-dae8-41f3-a5ec-309f0abeaf4f", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b59861c-5ca6-4a30-bcab-524cbff9ce55", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c332a9f-22da-4c1f-ba9c-661700e05c91", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "579c62ad-a548-413b-b4cd-5e14791c0a38", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfced6e9-25ea-458c-950e-5fd90050e10c", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "43dffdf2-1d4b-4019-9021-232241a4c705", "name": "/notifications/:notification_id", "request": { "name": "/notifications/:notification_id", "description": { "content": "---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "notification_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "635442fb-96bc-454c-8f4b-997b3b88b111", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9e9a39e2-647d-44ae-9c31-6bc9ea0e9902", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a382146-fb88-4827-8763-dd8c9cff37b3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c1acd6b-269f-4936-a3e4-304d036acef7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7bf05ea2-f10d-44c6-a48b-787d52ec37b3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "313ffc18-a093-48fd-a789-1bf9435b62ed", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4c94163-e382-4cf2-862e-67f5803aca07", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2497f6d7-f865-46b0-8206-821ec6499144", "name": "/notifications/:notification_id", "request": { "name": "/notifications/:notification_id", "description": { "content": "**Удаление шаблона уведомлений**\n\n---\n\nУдаление физическое.\n\n---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "notification_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "825032fa-3b4e-4c80-ba9b-4aa6419a01dc", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "71b94579-81cb-4e2e-9926-0bfdd3bdd79b", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39989a6f-9a06-4e83-acd4-9de89f881ea7", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ef06410-5248-4071-a4f4-e21b3e0ffa32", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3193bc3b-42f1-485a-ae86-4478d1a37907", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fbf4dcf-467e-4b42-bf88-0a0354d77c87", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8344746-0e36-4b84-9f84-561d0c11f7be", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4f9138f4-e1db-4607-8531-dfccc3cbc98b", "name": "/notifications/:notification_id", "request": { "name": "/notifications/:notification_id", "description": { "content": "**Изменение активности уведомлений**\n\n---\n\nПараметры: \nnotification_id - ID уведомления\n\nТело запроса: \nЧтобы сделать активным, необходимо отправить запрос с таким телом:\n\n```\n{\n \"is_active\": true\n}\nили\n{\n \"is_active\": \"true\"\n}\nили\n{\n \"is_active\": 1\n}\n\n ```\n\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 ```\n\nВ ответе возвращается обновленный объект notification , как в PUT /notifications/:notification_id\n\n---\n\n**Роль:** Оператор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "notification_id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c4a901bc-f99e-4963-adf3-7b76f269d0d2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "29b5dfae-7c50-4779-ba85-dc99af8feac8", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06921650-97f1-43db-b2a9-197802222b10", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea25548c-3ce2-42f8-b456-f1abdc541a69", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcae93b1-1757-417e-bca3-c7401ffcae3d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f987bb16-4059-49aa-98c7-8c10e17b3b2a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2324978b-a75d-4876-89e3-e5b6d4c02d7b", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", ":notification_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор правила уведомления (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "notification_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "65f1eea6-9bb8-4c2e-be13-e8a541b58724", "name": "/notifications/list", "request": { "name": "/notifications/list", "description": { "content": "---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "93a9fe1f-eba1-4252-8577-429c7b4c1750", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c453f612-3e48-443f-bbe2-f0518a9a22ab", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b84863b-0fd0-4f30-b7e7-e5bca0467406", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e531ad83-0d10-499b-a66e-717ac4892e5e", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08efd262-2623-4805-9747-2c06e727323b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03124812-9709-43e5-8ea2-319a293023c5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3201c90a-a778-4890-9bff-e3cace7325f0", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "notifications", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fbcd6843-50a5-4b10-bb89-145ba62ac76a", "name": "/messages", "request": { "name": "/messages", "description": { "content": "**Получение уведомлений**\n\n---\n\nИспользуется один вебсокет для получения следующих данных:\n\n1. последнего сообщения от объекта\n\n2. уведомлений за последние сутки\n\n3. новых уведомлений\n\n4. изменения справочников\n\n\nПосле открытия сокета сервер будет присылать уведомления вида:\n\n```\n[{\n \"id\": \"27379574-a367-4864-a2de-b236aa22dbd4\",\n \"template\": {},\n \"notificationtext\": \"Камаз А123АА777 в 2026-09-26 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 ```", "type": "text/plain" }, "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "478eed4a-c9df-4750-aa6c-b3240dd2b500", "name": "200", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4c734e6b-753f-4901-bb6b-4a551667620a", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e00d0ed0-c026-4236-8c7c-8d69c6deab95", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be813327-b3e7-4103-af0b-b4d99fa45b73", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "857d1c5a-c888-45b3-a8e2-0ebd5fd5ed49", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73366432-0649-4e53-a40f-8a55f80d5443", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6826f7bc-5968-44e3-9bc0-7513b96552da", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "notifications", "messages" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Рассылки", "description": "", "item": [ { "id": "4e8be10e-4c20-49b1-8854-e241e8ba61ab", "name": "/mailings?ids=:ids", "request": { "name": "/mailings?ids=:ids", "description": { "content": "**Получение рассылок по их ID (через запятую)**\n\n---\n\nВозвращает массив рассылок. \nЕсли параметр 'ids' пустой (т.е. запрос = 'GET /units_trailers', без параметра), то вернётся список всех связей всех компаний пользователя, из которого исключаются удаленные связей. Если ids не пустой (т.е. запрос = 'GET /mailings?ids=00215-54021..,25541-454754-4513..'), то вернётся список только из запрошенных связей.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная связь.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/mailings?ids=13b37095-f2eb-4c3f-804b-6f780281e398\n\n ```\n\n---\n\n**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5d9f45e8-e1ab-4beb-9c72-76d839f04b35", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "064e3dcd-08c8-448d-b00c-ce2319b76f45", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7bc35f1d-391b-4503-828a-4fa2b8f1e5eb", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df7f517c-f0b5-4eb4-a279-0692381cc6ee", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3aa8753-0ad3-4f3c-a5c3-d4f1b2fb9cfe", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3cac477-e95f-4403-a968-ef562ae6727d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c63f1597-90c4-4383-aad5-a5ab695ec47f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fb7bf191-d520-4983-8656-25679f3be732", "name": "/mailings", "request": { "name": "/mailings", "description": { "content": "**Создание новой рассылки**\n\n---\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\n**Роль:** Редактор и выше.\n\n---\n\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---\n\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---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f4fcaeef-8ed4-45e5-a8d9-c5ea5740a117", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bc589b52-c730-40aa-a51a-34db59264983", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "147670bb-0662-4ee1-8390-afe4db362010", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f73be44-9736-45d3-96d9-78701389813c", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b32e941a-b4e0-4b24-a5d2-23e85cfa6826", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0e43033-afe5-40ed-b30d-830a9f91bef2", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a48ad360-65d4-4253-8a11-f8a89e446b72", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"delivery_emails\": [\n \"\",\n \"\"\n ],\n \"is_active\": \"\",\n \"last_run\": \"\",\n \"msg\": \"\",\n \"periodic\": \"\",\n \"periodic_type\": {\n \"key\": \"\",\n \"type\": \"\"\n },\n \"report_template\": {\n \"id\": \"\"\n },\n \"units_group\": {\n \"id\": \"\"\n },\n \"weekdays\": [\n {\n \"key\": \"\",\n \"type\": \"\"\n },\n {\n \"key\": \"\",\n \"type\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1ce31d7c-4894-4995-b55b-ee97ef613124", "name": "/mailings?ids=:ids", "request": { "name": "/mailings?ids=:ids", "description": { "content": "**Планирование удаление рассылки**\n\n---\n\nсм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6ac4fdab-96a6-4618-9ef1-64369bfd8c7a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a9554a48-e9f7-4a46-b08a-304c52449bbb", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca32662d-8327-4180-8a50-31c57fee22e4", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e88ed46-defb-4962-9b4b-fa574a224bd1", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6e37d1d-cf48-437f-bae8-16d061a6bfcc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "817b4f81-e639-4c41-b4e0-c4e1cc55e290", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "411cf2b9-e8d4-4399-b623-3f8bf2674cf0", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cccc9465-0718-45df-9dc2-3f4226157cf0", "name": "/mailings/:id", "request": { "name": "/mailings/:id", "description": { "content": "**Удаление рассылки**\n\n---\n\nУдаление физическое.\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c59e1266-687b-497c-badb-a054d5f5e99d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "241e2739-6dea-46bd-b083-11bbce7dff40", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe0bb471-4a2e-457a-a294-83705457f312", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92de627e-366b-402e-a3aa-7653ea3ffdf5", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2fbe678-1b40-4ddf-bfd9-c741bf249435", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82bffb64-4b23-4fd0-8dc9-d4d5a06be330", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a00a7fe-1259-46e3-a764-4bbce45c6378", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4b9f3dad-7f3a-4de3-bdc9-fe7e297dea7e", "name": "/mailings/:id", "request": { "name": "/mailings/:id", "description": { "content": "**Изменение активности рассылки**\n\n---\n\nПараметры: \nid - ID рассылки\n\n\nЧтобы сделать активным, необходимо отправить запрос с таким телом:\n\n```\n{\n \"is_active\": true\n}\nили\n{\n \"is_active\": \"true\"\n}\nили\n{\n \"is_active\": 1\n}\n\n ```\n\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 ```\n\nВ ответе возвращается обновленный объект mailing как в PUT /mailings/:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "892454e9-e624-4f5f-a876-ce2326bdbc9b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2dc5e651-d14a-461d-ab60-11a2c823c625", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5602207-8ee8-4d8b-b5f7-be75e55eb145", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c997a2aa-3468-4509-9ba6-bc35fd1d2ec0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1d91d3b-cf40-4160-9af2-3bc28219dd56", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63ebc4a4-fbad-40d9-97bf-e4b177046882", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54e0bc59-41b9-419d-b8af-80f97e5f9fe6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_active\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "84aaf63d-9a64-4eba-afc7-169f423f1951", "name": "Обновление параметров рассылки", "request": { "name": "Обновление параметров рассылки", "description": { "content": "Обновление настроек автоматической рассылки отчетов (периодичность, получатели, шаблоны отчетов).", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "14fea714-3b10-4b58-b285-31f3bb1316f3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "78dd1df0-40bd-45a9-a488-f62b945694ba", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29c02f39-b680-4751-a2a2-d800bf844c1d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72939e1d-2cfe-4fd6-85be-761433760445", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e52e713-6809-43d8-80c6-caba7da78743", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "690f4c74-ca6c-4d88-bf1e-12510696b43c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "798a9a42-1354-4f60-89b8-e81d83bc9576", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e64fe43e-18f3-4e92-865d-bc221eee9a5b", "name": "/mailings/list", "request": { "name": "/mailings/list", "description": { "content": "**Получить рассылки по фильтру**\n\n---\n\nАналогичнао запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[\"periodic\", \"last_run\", created, is_delete\\]\n\nsortDesc - сортировка по убыванию, значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - \"units_group.id\", \"unit.id\", \"is_active\", \"msg\"\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 10 связей, отсортированные по возрастанию даты создания объект с ID равным b8b1f330-52cf-46c6-a41e-ab0f70a0cce5\n\n```\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---\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\nЕще один пример запроса:\n\nПолучить первые 10 связей, отсортированные по возрастанию даты окончания по убыванию, связаные с водителем (пользователем) с ID 22ae4a3c-f742-460c-9479-63f08c81b5c3\n\n```\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c2a835b4-07ef-4b06-a859-439ab23ae24d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9e52477a-8148-48b8-aa2d-ddd3dd400d28", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92a6f7c8-7db4-408c-af55-39db9bebddfc", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a65e534-a593-4dc7-81d9-0ad9b1ab1d09", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a4e2618-a03c-4120-bfc6-f51d11136734", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0bfd427-c791-45ff-8557-985134a4f67c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e55dd903-95e1-4eba-b3ce-dca06057cf02", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "mailings", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Биллинг", "description": "Методы для интеграции с сервисом биллинга", "item": [ { "id": "f472f60b-4074-4ec9-93f9-be0fe1233cea", "name": "Создание заказа на пополнение баланса", "request": { "name": "Создание заказа на пополнение баланса", "description": { "content": "**Запрос на получение данных для оплаты текущей компании на сумму, указанную в теле запроса**\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"amount\": 300,\n \"skip_init_payment\": true\n}\n\n ```\n\nЧтобы начать автоплатеж нужно указать start_recurrent=1\n\n```\n{\n \"amount\": 300,\n \"start_recurrent\": 1,\n \"skip_init_payment\": true\n}\n\n ```\n\nВ ответ приходят данные, которые необходимо преобразовать в формат _**www-form-urlencoded**_ и отправить запрос\n\n> POST\n\n\nв ответ на который вернется страница с формой для оплаты.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\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 ```\n\n---\n\nДля Paybox\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1b0e155b-5a71-42a1-8fb6-3c0ff9e0cf09", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f8a07a41-72ab-4f54-b493-e88ceda7cc56", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59f55ed6-2881-4197-bbeb-ecdcc2176c11", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6b8ead3-b3dc-490f-95e4-853fb80fd78b", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0aaba41a-8fd5-4fea-8aaa-d89f73b32697", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1014262-36d7-4dc4-b6b4-38788bb5cafa", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6a0ca50-ac09-4440-acb4-50384eecd31a", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_create_order" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"skip_init_payment\": \"\",\n \"start_recurrent\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b32c77f-ed04-4230-8462-f17601bf13d6", "name": "Webhook платежного шлюза (Callback об оплате)", "request": { "name": "Webhook платежного шлюза (Callback об оплате)", "description": { "content": "Обработка уведомлений (Webhook) от эквайринга банка (Тинькофф/Сбер/ЮKassa) о статусе транзакции.", "type": "text/plain" }, "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] }, "auth": null }, "response": [ { "id": "5b5e9900-cab7-4c28-8230-e912ccf7dd12", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f8472911-1423-4548-9a0a-2d495e5940ac", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85a7d61f-f433-4771-8e86-aa6657b46c19", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d848113-5ba3-4d68-ac05-327dfca7e6b3", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "517d89a6-0495-4450-bb46-784145f319da", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9b2e820-eb1f-4b64-bbae-eb0866ec78e9", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec9f279e-3dbc-4f9e-9074-8de4a6129d41", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "billing_success" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_code", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "auth_number", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_email", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "client_phone", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "created_datetime", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "currency", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "merchant", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "meta", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "order_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "original_amount", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "pan_mask", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "payment_method", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "rrn", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "salt", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "signature", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "testing", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "transaction_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "unix_timestamp", "value": "" } ] } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6a2f9319-33be-47bb-a559-c32c922a3764", "name": "Настройка параметров биллинга компании", "request": { "name": "Настройка параметров биллинга компании", "description": { "content": "---\n\n**Роль:** Редактор тарифа и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a0738e28-3843-415a-beae-148db0b23f3a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "94b16c44-3755-4336-b046-fd14922ae848", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ccda588-a697-4855-8a26-b791f79a2f36", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a172522-2971-45c3-802b-be3d2d4387d2", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f53c8a3a-e266-41e5-aa2f-0cbdf9447c9f", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a8a8cd6-1f64-4040-9db5-c5cef3214866", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8fd84f9-0b48-422f-b795-86929b6c5c6f", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_set_billing" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "text/plain" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "" } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "898e5ec0-beb1-4af9-93f7-5aad626a4617", "name": "Получение истории финансовых транзакций", "request": { "name": "Получение истории финансовых транзакций", "description": { "content": "**Получение списка транзакций в текущей компании**\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"max_rows\": 100,\n \"first_row\":100,\n}\n\n ```\n\n---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "105fb0e8-0f17-492e-8cb8-63418de6766c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fb65a2c1-13a4-4041-b848-caf6de744d17", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a742e0e4-18eb-451b-9cd3-c61f75a12894", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ade08932-f842-40ff-b8b6-d2478a30257e", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6c0d10b-00a3-46ea-a564-b8c65f01fd1e", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5b5ac17-be44-4004-81e6-1014293cf8ca", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a305dfb9-f3b0-4c99-8673-8e0fe77a9dcc", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b26e86d-2360-4a5a-8881-056b9249ab38", "name": "История изменения тарифов компании", "request": { "name": "История изменения тарифов компании", "description": { "content": "**Запрос для получения списка истории изменений тарифов текущей компании**\n\n---\n\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c2ffa485-519e-4741-83b4-bce689dfbf7e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3c6997bd-bed5-4541-b662-79dbe3fce61a", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9280198f-d703-4900-8b81-f4c3f5343d2c", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f708491c-1fbd-455d-8613-ceb52138b834", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34e0b9d1-37cf-4204-903a-30244fda8071", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b7425b7-f7c9-408a-b2c0-047305a11642", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "937f2bad-9964-48e5-a75c-d264281c2e9c", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "87d73c73-43ac-46c2-ab97-5f2fd75f8ebd", "name": "Смена или продление тарифного плана", "request": { "name": "Смена или продление тарифного плана", "description": { "content": "**Создает тариф для текущей компании**\n\n---\n\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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "dc83dd5c-2be8-4d05-ae9d-a4b0fa4296ed", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8d7c4aa9-53a1-490b-8b52-633dcbc0d38d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "327f2cec-7b34-47bb-9050-51e314b13ed3", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef85b41f-1305-415f-bcc9-385679d0a3ff", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "062e9700-9198-4148-8b3d-f40be90d22be", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03487504-ce6d-41df-ba8a-8e7c25abf00d", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea41a8ad-5ddf-4c41-ad10-6edb2c416734", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"tariff\": {\n \"units\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "188be0e4-8be0-409e-adf3-58370ed394a6", "name": "Корректировка или проведение транзакции", "request": { "name": "Корректировка или проведение транзакции", "description": { "content": "Добавляет дилером транзакцию в компанию со статусом оплаты CASH.\n\n---\n\nИспользуется для того, чтобы учитывать оплаты произведенные наличными.\n\n---\n\n**Роль:** Редактор тарифа и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n\"amount\": 2500,\n\"company_id\": \"0f90e21b-a5a9-4929-8d83-67951440df61\",\n\"custom_order_id\": \"12344\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "34232622-4946-40dc-8c27-697f2fa7a659", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8c420951-c517-4f06-bb70-67760876778d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a4c8953-4301-44ab-b1a2-091ed7e55700", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a525faa-d697-4d2c-a645-bbe63d9e848b", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abad1252-3264-491d-892d-e86d51429495", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63f7ab14-0b13-4c44-9129-a13701f8d976", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13db23ab-239a-4b4e-950c-9c050e800043", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transaction" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"company_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b6c6a73-bf88-4833-a416-347f9c4220cf", "name": "Редактирование тарифного плана в биллинге", "request": { "name": "Редактирование тарифного плана в биллинге", "description": { "content": "**Изменение тарифа для компании**\n\n---\n\n**Роль:** Редактор тарифа и выше.\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---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8bfe8722-3707-4243-8951-9fbd3f885283", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ecdf72a5-ecd0-46bc-b697-79ffe35c29bf", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4562ee33-69c4-4947-bdb8-3c2e18b5619c", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f2a7db5-72d4-4273-9832-2f0a630e52a2", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a7024b7-72fa-4e82-b2af-973a77db2a43", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61110ebf-71b7-47b1-8bd9-4898806a750b", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62b2edc7-0b9e-4b53-950b-7f958c75fddb", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b7ae2c95-51f1-4abe-ad96-0ec327add0b8", "name": "Создание тарифного плана в биллинге", "request": { "name": "Создание тарифного плана в биллинге", "description": { "content": "**Возвращает информацию о тарифе для списка компаний**\n\n---\n\nЗапрос без списка компаний возвращает транзакции по всем компаниям.\n\n---\n\n**Роль:** Редактор тарифа и выше.\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "89cda4be-4bd4-46cb-9b23-4cf15b556c33", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "316ebb99-cd44-44a3-aca4-3261cece168f", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba7eeaaa-cfd8-4d15-8095-16efbb543eac", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94e4f1c6-ddc9-4301-a063-f94db744f3ac", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8988d3e-18a8-4fa8-b139-41ec7663e3b0", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b475c3f3-4a42-4b4d-a462-39f21e51a7c6", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72952e1e-5dfd-4880-8e19-1f7718198fa7", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_tariff_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4b0fd474-9dee-495d-aa3b-4e74a8fdb5e0", "name": "Общий реестр финансовых транзакций (Админ)", "request": { "name": "Общий реестр финансовых транзакций (Админ)", "description": { "content": "**Получение списка всех транзакций для списка компаний с пагинацией**\n\n---\n\n**Роль:** Администратор и выше.\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 \"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---\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f91d41e1-60e8-489b-8fed-3690a29e0728", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "331f4a75-3c96-4ac9-a9cb-81f70d3dabd0", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc248e6b-a06e-44b9-92f7-0e10e99c82c7", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0db40b52-6aa8-4507-89a0-f3656b63e756", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b56ad79-b6fa-4294-92e5-60e6d877e412", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8f06fec-19cc-4de9-91da-ede207baf1fc", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45b19685-735d-46ac-b969-d1d32ab543a2", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f7883769-4285-40dc-ad00-4f485c3bc9d3", "name": "Экспорт реестра транзакций в Microsoft Excel", "request": { "name": "Экспорт реестра транзакций в Microsoft Excel", "description": { "content": "Экспорт транзакций для списка компаний с пагинацией\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST /bill_transactions_admin_excel?body={ \n\"companies\": \\[ \n{ \n\"id\": \"7bcba823-3aa4-455d-be8a-db04c39e9409\" \n}, \n{ \n\"id\": \"fe371bd9-bba3-4c4a-b54b-b05fb77690c9\" \n} \n\\], \n\"from\": \"2021-08-25 09:00:00\", \n\"to\": \"2021-08-26 19:00:00\" \n}\n\nВ теле запроса необходимо отправить следующие поля:\n\ncompanies - списко выбранных компаний, необязательное\n\nfrom - начала периода\n\nto - окончания периода\n\n---\n\nВ ответе возвращается эксель файл", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4c4ef66f-a6f3-465e-a306-2ee71906480d", "name": "Бинарный файл книги Microsoft Excel (.xlsx)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "24f61142-c1ab-42dc-8331-e250ad4343df", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bca4edf-d236-4812-b624-25069d7e5a65", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcf07e74-8242-49f3-999b-8aad3f22a61c", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71f4a705-51d9-423d-8a79-16771185edf5", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e86005e7-38f5-4524-84ad-1c3bb3bc4eea", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a36ad911-b094-4c97-89b3-bca0dd4831af", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_transactions_admin_excel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"key\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"dealer\": {\n \"id\": \"\"\n },\n \"first_row\": \"\",\n \"from\": \"\",\n \"max_rows\": \"\",\n \"timezone_key\": \"\",\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "462c2d6a-600c-4b43-bdfa-3c07b024265f", "name": "Отключение регулярного автоплатежа", "request": { "name": "Отключение регулярного автоплатежа", "description": { "content": "**Остановка автоплатежа для компании**\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Параметры ответа:**\n\nВ случае успешного отключения возвращается код 200 c пустым body.\n\nЕсли не добавлена карта или не включен автоплатеж, то возвращается ошибка.\n\nПример ошибки:\n\n```\n{\n \"code\": 4220,\n \"field\": \"\",\n \"message\": \"Карта не добавлена\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8f8b4fa4-16c1-4b4b-9976-bbfa34ae98da", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1b26ee30-bff6-425a-b785-470864e3b89b", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a5e5b1a-0738-4f78-a7c2-2579a66d420d", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84f4d2ad-8c46-4911-a7ff-698ea012996b", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22e271d1-8c0e-4c55-b9ed-cbc06fdcf91c", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f23eff7b-e4eb-4f04-b0a8-34ee9d9f691f", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c04c635-b564-4ee9-bccc-55292471dd2a", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_stop_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5522b0ee-201d-40b8-834f-2b5aa49be173", "name": "Включение регулярного автоплатежа", "request": { "name": "Включение регулярного автоплатежа", "description": { "content": "**Включение автоплатежа для компании**\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Параметры ответа:**\n\nВ случае успешного включения возвращается код 200 c пустым body.\n\nЕсли не добавлена карта или уже включен автоплатеж, то возвращантся ошибка.\n\nПример ошибки:\n\n```\n{\n \"code\": 4220,\n \"field\": \"\",\n \"message\": \"Карта не добавлена\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6abec49d-cddd-4ebd-a8e3-b97f9637b36e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c2a0e59f-e8af-4318-9289-c2c7441a85d5", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed3ff723-b0aa-4046-bd5c-227b925eafaa", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9680a0d-6c43-4855-8fb1-fb045539daa1", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "688f8d75-d3c4-4784-96a6-3f1e52da4bd0", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da8b7c70-51bc-4fb8-805a-9488eea3b652", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e6aa1e7-5c5a-4402-b907-6867ed0a1c62", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_start_auto_pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cf78b872-e38a-4740-ab69-d0f6b7eeccfb", "name": "Отвязка банковской карты компании", "request": { "name": "Отвязка банковской карты компании", "description": { "content": "**Удаление сохраненной карты**\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Параметры ответа:**\n\nВ случае успешного удаления возвращается код 200 c пустым body.\n\nЕсли не добавлена карта, возвращается ошибка.\n\nПример ошибки:\n\n```\n{\n\"code\": 4220,\n\"field\": \"\",\n\"message\": \"Карта не добавлена\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "34d5a534-4d2c-4638-8c60-c5cb42394098", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "233765bc-0856-4a3f-9ce6-70c27438bfd7", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52dbecb9-709d-4e81-a087-527dbd7d98a3", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea1117f4-2d4c-415c-9bc6-f77a4385bdad", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b5ae626-67dd-409c-9b1f-e100651597af", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5f92cfa-7a22-4610-9aff-91b4e840afbf", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "844cf25f-35ff-4c76-9420-26ce7e68e6d0", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "bill_remove_card" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Терминалы", "description": "API по работе с Терминалами", "item": [ { "id": "fb93390c-5121-4dc1-b6d5-65c1ade32867", "name": "Административный кросс-компанейский поиск сущностей", "request": { "name": "Административный кросс-компанейский поиск сущностей", "description": { "content": "Поиск и фильтрация сущностей платформы по всем доступным пользователю\nорганизациям с поддержкой сложных условий, сортировки и постраничного\nвывода. Это единая точка входа для всех таблиц админ-панели.\n\n---\n\n**Что выбрать поиском, задаётся полем `model`:**\n\n- `terminals` — терминалы;\n- `retranslators` — ретрансляции;\n- `retranslator_histories` — история ретрансляций;\n- `commands` — команды;\n- `commands_templates` — шаблоны команд;\n- `units` — объекты;\n- `delunits` — удалённые объекты;\n- `units_groups` — группы объектов;\n- `geozones` — геозоны;\n- `geozones_groups` — группы геозон;\n- `report_templates` — шаблоны отчётов;\n- `notifications` — уведомления;\n- `routes` — маршруты;\n- `trips` — рейсы;\n- `trailers` — прицепы;\n- `mailings` — рассылки.\n\nПервые пять моделей обслуживает сервис терминалов, остальные — сервис\nобъектов. Набор моделей у двух сервисов не пересекается, неизвестное\nзначение `model` вернёт ошибку.\n\n---\n\n**Параметры тела запроса:**\n\n- `model` — что ищем, обязательное поле, одно из значений списка выше;\n- `from` — с какого элемента выдавать результат, по умолчанию `0`;\n- `count` — сколько элементов вернуть, по умолчанию `100000`.\n Значение ограничивается сверху: у ретрансляций при выборке сразу по\n нескольким компаниям оно урезается до `10000`;\n- `value` — строка поиска. Смысл зависит от модели: например, у ретрансляций\n непустая строка ищется в `name`, `retrans_server` и `retrans_protocol`,\n а строка только из цифр — в IMEI;\n- `field` — уточнение для числового поиска, у ретрансляций при\n `field: \"imei\"` ищется точное совпадение IMEI, иначе — вхождение;\n- `sortField` — поле сортировки. У ретрансляций одно из значений\n \\[`imei`, `is_active`, `retrans_protocol`, `retrans_server`, `name`,\n `comment`], поле вне списка игнорируется;\n- `sortDesc` — сортировка по убыванию, `true` или `false`;\n- `conditions` — дополнительные условия отбора, массив объектов вида\n `{\"field\": \"поле\", \"value\": \"значение\"}`. У ретрансляций учитываются\n поля `imei` и `retrans_server`;\n- `companies` — компании, по которым ведётся выборка, массив объектов\n вида `{\"id\": \"идентификатор\"}`. Пересекается с уже доступными\n пользователю компаниями, а не заменяет их.\n\n---\n\n**Как получить список ретрансляций:**\n\n``` json\n{\n \"model\": \"retranslators\",\n \"from\": 0,\n \"count\": 100,\n \"value\": \"\",\n \"companies\": [],\n \"conditions\": [],\n \"sortField\": \"name\",\n \"sortDesc\": false\n}\n```\n\n---\n\n**Какие компании попадают в выборку ретрансляций:**\n\n- по умолчанию берутся все компании, доступные пользователю, а не только\n активная;\n- поле `companies` может только сузить этот набор;\n- ретрансляция на группу объектов (`company_id` пустой) попадает в выборку,\n если среди компаний группы есть хотя бы одна доступная.\n\n---\n\n**Состав ответа для ретрансляций:**\n\n- в ответе ретрансляции собраны по группам: одна ретрансляция — один\n элемент `list`, сколько бы терминалов за ней ни стояло;\n- в ответе ретрансляций по группам объектов видны их терминалы,\n сами группы не выводятся;\n- `max` — сколько ретрансляций подошло под фильтр всего, без учёта\n `from` и `count`. Нужен для постраничной навигации;\n- `activate_date` в списке не приходит: дату включения видно\n в `GET /retranslators`.\n\nДля остальных моделей контракт тот же: `{max, list}`, где состав полей\n`list` зависит от модели.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример ответа** (`model: \"retranslators\"`):\n\n``` json\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \"Комментарий диспетчера\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": null,\n \"member_name\": \"Иванов И.И.\",\n \"route_name\": \"Маршрут 15\",\n \"gps_category_type_key\": \"gps_category_type_s\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\",\n \"terminals\": [\n {\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\"\n }\n ]\n }\n ]\n}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — неизвестное значение `model`, у пользователя нет доступных\n компаний, либо после фильтрации по `companies` не осталось ни одной.", "type": "text/plain" }, "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e568ceab-fee6-484e-b126-ac1f54fab193", "name": "Страница результатов `{max, list}`. `max` — всего записей под фильтр\nбез учёта `from` и `count`, `list` — элементы текущей страницы", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"max\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a312b2f9-2389-4ff6-b1d7-0f5d0ad74c29", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9aafb683-c56a-4a17-91e0-8fa8b70ba489", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce908507-c801-4831-88f1-8cc98b2334f1", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "976229cb-1668-4756-b625-32c5e298f07e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89d60db4-ca70-4337-9c52-73a483f72a57", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "242013f2-dbd6-4376-84b8-13016706b29d", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b59cc9d6-311e-4f61-99ee-ebdc508ba0eb", "name": "/terminals?ids=:ids", "request": { "name": "/terminals?ids=:ids", "description": { "content": "**Поиск imei по ID**\n\n---\n\nВозвращает массив терминалов компании\n\nЕсли в параметре ids содержится только один id, то вернется не массив из 1 элемента, а конкретный терминал.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/terminals?ids=da47b5da-d030-44f0-acc4-a43107dbb090\n\n ```\n\n---\n\n**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d4f7766d-9b47-49b5-84a0-d096544a4775", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9c24af35-f5b9-4964-a47f-b87183b40974", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99e0cbeb-640f-48f3-9880-0b6535ad6102", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01151bbd-cd58-42b1-809b-2cedd251ea9c", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b76b5d11-216c-4d6b-92fb-109b3ab01144", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8707687c-3f59-48b4-ae18-1fdea7135a5a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "362874d6-d8ad-48ad-a71c-67543187912e", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "26707152-4830-49b1-a1ee-8053fa95c7cf", "name": "/terminals", "request": { "name": "/terminals", "description": { "content": "**Создание нового терминала в компании**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Параметры:**\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---\n\n**Пример запроса:**\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\n**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ec042c05-f58f-4621-9054-f7bc9ee4ca16", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b3b776c8-75f6-41e8-847d-44faaabf2302", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95799dac-e397-4d6f-a711-28d04fb997d6", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3668d0bf-91da-49c2-a509-562f8407bb69", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9feda20-0a7f-478e-9670-ca357c7a805d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "439c41bd-4be6-43af-8508-4c0f82492db2", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "052a364a-a535-4d51-865b-59377b8417b6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5e666d3b-9b2a-4469-a79f-77ba80ee8346", "name": "/terminals?ids=:ids", "request": { "name": "/terminals?ids=:ids", "description": { "content": "**Планирование удаления терминалов компании по их ID**\n\n---\n\nСм. DELETE /units?ids=:ids\n\n---\n\n**Роль:** Супервизор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "38cbd902-f29b-4f0f-8898-251bc1cdc33c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f786c09e-42ec-459d-8088-6e40867c7f06", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6054fd6-555d-4f5c-83ad-1ee7b644cf78", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec7d65eb-9e7b-4463-910e-6f5a36df99f5", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "828d2945-f870-48ba-9966-4c7b13936a49", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "731c67d7-6999-4592-b301-9da55ec2dd70", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75013d5a-5e46-410d-8934-d99c9355b433", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dd9c3768-7368-4379-93a0-88ff058ee29c", "name": "/terminals_bulk", "request": { "name": "/terminals_bulk", "description": { "content": "**Создание нескольких терминалов в компании**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Параметры:**\n\n```\n\"companies\": Список компании, обязательно\n\"imeis\": список Imei, текст, обязательно,\n\"password\": Пароль, тектс, необязательно\n\n ```\n\n---\n\n**Пример запроса:**\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**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f897e72c-6f91-4d4d-bf49-3f639b3145b8", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f3dbf576-c71f-4446-8efd-0f0f64f459ef", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82a59497-47ce-426e-80e9-9d721e8b338a", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3ba1ef08-eb41-432c-bf8a-75fbee48dcd0", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69bbcda0-352b-4e41-9922-149c818dc54a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fdea0c4-7142-42a4-b91b-ac271462f79d", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b5ae95f-10c1-40df-a0d4-2126cd6e1c9f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"imeis\": [\n \"\",\n \"\"\n ],\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3708918d-3a49-4feb-af5c-ff4f986d87bb", "name": "/terminals/:id", "request": { "name": "/terminals/:id", "description": { "content": "**Обновить данные терминала**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Параметры:**\n\nсм метод POST /terminals\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /terminals?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c025e78c-8e26-482d-9311-234b570b87c6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "94b2ff28-cae3-4f86-aa08-71e34fc36473", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9eebf84c-622e-40b8-94ab-356834272c29", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82fd583a-5806-47d3-abe7-c0f430ece944", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01915e3e-5944-42a3-b643-e040c403e1bd", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06073d01-79de-4f80-9940-2e0939254ac2", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e9dbb81-3b41-4d23-b143-c917db6120a6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"company_name\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"is_blocked\": \"\",\n \"password\": \"\",\n \"use_lbs_for_coords\": \"\",\n \"use_previous_param_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e0001473-a5b7-4160-83a0-2f59a9d879ec", "name": "/terminals/:id", "request": { "name": "/terminals/:id", "description": { "content": "**Удаление терминала компании по его ID**\n\n---\n\n**Параметры:**\n\nid записи\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Ответ:** 200\n\nЕсли терминал с таким id не найден, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1c14d05a-d8a7-4011-95b3-917af4644fdd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f9b671a7-8cb7-4342-8e2d-568f605e15f6", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6224328-e6a4-4b9e-ba1f-55e604329735", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "583afb6e-537b-4085-9206-b7f8604a47dc", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15f708e3-858e-485f-a527-0e0db1eee0d4", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd24ef96-7de6-47c5-ba0a-80510d1fc9a7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "426d1cd0-1d16-42be-9c3a-6943f1afa015", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6d916e61-990d-4e13-8f06-fbc82fb362f9", "name": "/terminals/batch", "request": { "name": "/terminals/batch", "description": { "content": "**Обновить данные терминала**\n\n---\n\nМассовое обновление некоторых полей выбранных терминалв\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Боди запроса:**\n\nterminals - Список терминалов\n\nis_blocked - true для блокировки, false для разблокировки\n\n---\n\n**Ответ:**\n\nВозвращаются обновленные терминалы\n\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4173a6fc-6102-4f93-8435-c5bebc9e40bf", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0119770d-9c50-4c92-b8bf-94fba3ece673", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7221be9-435f-4d87-b2c3-07a6eb8dd10e", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "971756dc-ed28-4e70-8453-fc4da993a546", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a48f25f-093f-46fc-9f3f-7941ca3e2696", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1932a0a8-bd0b-4646-b91d-697460d0f66b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5dd3ba3-ac00-4466-b540-6a2aadf8d1c6", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"is_blocked\": \"\",\n \"terminals\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b24164df-1f66-461a-a87c-b4177614f014", "name": "/terminals/list", "request": { "name": "/terminals/list", "description": { "content": "Поиск терминалов по фильтру\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nsortField - поле сортировки, значения \n\\[imei\\]\n\nsortDesc - сортировка по убыванию, значения \"true\", \"false\".\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - imei\n\ncompanies - список компаний в которых искать терминал\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 2 imei компании 36c52c2b-64a0-45dd-a75f-3c723fffee77 или 95f38fda-b8b5-4754-8fa2-07fadb72637d имеющие подстроку \"123\"\n\nЕсли у пользователя роль не супервизор, то возвращается только imei компании пользователя.\n\n```\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---\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\": \"862531040000017\",\n \"password\": \"123456\"\n },\n {\n \"id\": \"0ad9df34-ce6e-4665-a1f8-f6e2d93d5d1e\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000016\",\n \"is_blocked\": true\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ad4d7942-38b6-4f65-940e-b4ff6410779c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "58d53c84-c928-428b-a970-0e38126fc2e1", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3e9a8c5-b81e-4caf-bbcb-6d526126ecae", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b51b2270-5978-4ab9-b2ff-7d1843f127e3", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6acfc091-310a-489b-8a9e-022be7c7f8c5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "019b66ee-9bf3-4823-b68b-bc84a49fda2b", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6795779f-c10f-4023-8f03-8103ca4deb49", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\",\n \"sortField\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d135d807-61f3-4c2f-a13c-21b79d9f39fb", "name": "Журнал сырых данных и сообщений терминала", "request": { "name": "Журнал сырых данных и сообщений терминала", "description": { "content": "Возвращает пагинированный список телематических логов и сообщений, поступивших от терминала с указанным IMEI.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ac0abfa0-71e6-46be-9854-f24debc76951", "name": "Список телематических логов терминала", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"max\": \"\",\n \"list\": [\n {\n \"date\": \"\",\n \"message\": \"\"\n },\n {\n \"date\": \"\",\n \"message\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8289cbc-6f91-438f-8912-11f87869a314", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c93a304-4dba-4ae7-9061-7ab2965552ae", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9777c9b6-a90f-47aa-982f-24e1d0bd7291", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f718c73c-e84a-4cd3-b9ae-c1b77e4069b3", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "193d4e05-77dd-4e40-a5f0-1a1574749910", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a173af98-ccc6-49dd-9d9f-bb2b4549c120", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "terminals_logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "Начальное смещение списка логов (индекс с нуля)", "type": "text/plain" }, "key": "from", "value": "0" }, { "disabled": false, "description": { "content": "Максимальное количество возвращаемых записей", "type": "text/plain" }, "key": "max", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "29c1c7b4-a4e9-40c4-adb2-2b666443a197", "name": "Получение списка распознанных колонок и параметров терминала", "request": { "name": "Получение списка распознанных колонок и параметров терминала", "description": { "content": "Возвращает перечень доступных параметров телеметрии для связки типа терминала и IMEI объекта.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "terminal_type", "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" } }, { "type": "any", "value": "", "key": "imei", "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "cfe1e631-0ada-4d2f-9f78-e2b60c2a698f", "name": "Список параметров телеметрии терминала", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"key\": \"\",\n \"name\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "149f5cae-e1e0-40f1-97ca-fb3883f3c779", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ccdc98f3-c44c-4e03-8dc3-e8544cbc699f", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09af3afb-6f26-466e-9faf-002049cf18d0", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4d1dc2f-3123-4ae0-b2ff-88ed2b93ba28", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8cd49bdd-0498-4217-a9af-071609857a6e", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf284b06-2efd-4dcd-80c5-eb927acf1d82", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2bf31976-7d0b-4c71-b499-30e3f30579f4", "name": "Сохранение настроек колонок параметров терминала", "request": { "name": "Сохранение настроек колонок параметров терминала", "description": { "content": "Конфигурация соответствия телематических параметров и датчиков для указанного типа терминала и IMEI.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "terminal_type", "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" } }, { "type": "any", "value": "", "key": "imei", "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a411365e-1803-47af-bdda-d61ad2a469eb", "name": "Настройки успешно сохранены", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63e64809-ae32-4549-8114-f1bf402c1996", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b8d5fc1-9956-4e58-808a-574d55b6c835", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16bb8b30-bd05-4201-a59c-b66a574d9372", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f36106c-27db-4ddd-aae9-3262383de33a", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bba1ca14-ec25-43ff-833a-c2c9cba34feb", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bdbfa0a-5bb9-425c-aef2-41ba8212cdf3", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Ретрансляции", "description": "API по работе с Ретрансляциями", "item": [ { "id": "aef08e2b-8b0d-4930-8cba-8db4558be4a9", "name": "Административный кросс-компанейский поиск сущностей", "request": { "name": "Административный кросс-компанейский поиск сущностей", "description": { "content": "Поиск и фильтрация сущностей платформы по всем доступным пользователю\nорганизациям с поддержкой сложных условий, сортировки и постраничного\nвывода. Это единая точка входа для всех таблиц админ-панели.\n\n---\n\n**Что выбрать поиском, задаётся полем `model`:**\n\n- `terminals` — терминалы;\n- `retranslators` — ретрансляции;\n- `retranslator_histories` — история ретрансляций;\n- `commands` — команды;\n- `commands_templates` — шаблоны команд;\n- `units` — объекты;\n- `delunits` — удалённые объекты;\n- `units_groups` — группы объектов;\n- `geozones` — геозоны;\n- `geozones_groups` — группы геозон;\n- `report_templates` — шаблоны отчётов;\n- `notifications` — уведомления;\n- `routes` — маршруты;\n- `trips` — рейсы;\n- `trailers` — прицепы;\n- `mailings` — рассылки.\n\nПервые пять моделей обслуживает сервис терминалов, остальные — сервис\nобъектов. Набор моделей у двух сервисов не пересекается, неизвестное\nзначение `model` вернёт ошибку.\n\n---\n\n**Параметры тела запроса:**\n\n- `model` — что ищем, обязательное поле, одно из значений списка выше;\n- `from` — с какого элемента выдавать результат, по умолчанию `0`;\n- `count` — сколько элементов вернуть, по умолчанию `100000`.\n Значение ограничивается сверху: у ретрансляций при выборке сразу по\n нескольким компаниям оно урезается до `10000`;\n- `value` — строка поиска. Смысл зависит от модели: например, у ретрансляций\n непустая строка ищется в `name`, `retrans_server` и `retrans_protocol`,\n а строка только из цифр — в IMEI;\n- `field` — уточнение для числового поиска, у ретрансляций при\n `field: \"imei\"` ищется точное совпадение IMEI, иначе — вхождение;\n- `sortField` — поле сортировки. У ретрансляций одно из значений\n \\[`imei`, `is_active`, `retrans_protocol`, `retrans_server`, `name`,\n `comment`], поле вне списка игнорируется;\n- `sortDesc` — сортировка по убыванию, `true` или `false`;\n- `conditions` — дополнительные условия отбора, массив объектов вида\n `{\"field\": \"поле\", \"value\": \"значение\"}`. У ретрансляций учитываются\n поля `imei` и `retrans_server`;\n- `companies` — компании, по которым ведётся выборка, массив объектов\n вида `{\"id\": \"идентификатор\"}`. Пересекается с уже доступными\n пользователю компаниями, а не заменяет их.\n\n---\n\n**Как получить список ретрансляций:**\n\n``` json\n{\n \"model\": \"retranslators\",\n \"from\": 0,\n \"count\": 100,\n \"value\": \"\",\n \"companies\": [],\n \"conditions\": [],\n \"sortField\": \"name\",\n \"sortDesc\": false\n}\n```\n\n---\n\n**Какие компании попадают в выборку ретрансляций:**\n\n- по умолчанию берутся все компании, доступные пользователю, а не только\n активная;\n- поле `companies` может только сузить этот набор;\n- ретрансляция на группу объектов (`company_id` пустой) попадает в выборку,\n если среди компаний группы есть хотя бы одна доступная.\n\n---\n\n**Состав ответа для ретрансляций:**\n\n- в ответе ретрансляции собраны по группам: одна ретрансляция — один\n элемент `list`, сколько бы терминалов за ней ни стояло;\n- в ответе ретрансляций по группам объектов видны их терминалы,\n сами группы не выводятся;\n- `max` — сколько ретрансляций подошло под фильтр всего, без учёта\n `from` и `count`. Нужен для постраничной навигации;\n- `activate_date` в списке не приходит: дату включения видно\n в `GET /retranslators`.\n\nДля остальных моделей контракт тот же: `{max, list}`, где состав полей\n`list` зависит от модели.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример ответа** (`model: \"retranslators\"`):\n\n``` json\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \"Комментарий диспетчера\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": null,\n \"member_name\": \"Иванов И.И.\",\n \"route_name\": \"Маршрут 15\",\n \"gps_category_type_key\": \"gps_category_type_s\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\",\n \"terminals\": [\n {\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\"\n }\n ]\n }\n ]\n}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — неизвестное значение `model`, у пользователя нет доступных\n компаний, либо после фильтрации по `companies` не осталось ни одной.", "type": "text/plain" }, "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "63462427-31cc-4eac-b9d0-67acb20020e2", "name": "Страница результатов `{max, list}`. `max` — всего записей под фильтр\nбез учёта `from` и `count`, `list` — элементы текущей страницы", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"max\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94203c1a-5274-4ce1-b67c-319fcb619dbb", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e387ee0-418b-4d99-9886-14f0d99ecc07", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbb7f067-7729-4ff5-847c-f4bebd30a7b8", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6042de19-9ed6-414b-828b-dac986d3dba2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cb19a6b-9f7a-4961-8cd9-3e3491167a12", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b559736-63bb-4c28-afcc-dca13557da9f", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ccd53e09-8bed-4031-a94f-4223ceb09628", "name": "Получение ретрансляций по идентификаторам", "request": { "name": "Получение ретрансляций по идентификаторам", "description": { "content": "Возвращает ретрансляции по идентификаторам.\n\n---\n\nОтвет всегда собирается по всей ретрансляции целиком. Если запросить\nнесколько идентификаторов одной ретрансляции, в ответе будет один объект,\nпоэтому число объектов может быть меньше, чем число запрошенных `ids`.\n\nЕсли передан один идентификатор, возвращается один объект. Если несколько —\nмассив объектов.\n\n---\n\n**Параметры:**\n\n- `ids` — идентификаторы ретрансляций через запятую, обязательный параметр.\n\n---\n\nИдентификатором может быть любой терминал ретрансляции, не только\nидентификатор из поля `id`.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nОдна ретрансляция\n\n```\nGET /retranslators?ids=eeadc5d1-9a68-4083-bef6-51173d532cb0\n```\n\nНесколько ретрансляций\n\n```\nGET /retranslators?ids=eeadc5d1-9a68-4083-bef6-51173d532cb0,1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\n```\n\n---\n\n**Пример ответа** (один идентификатор):\n\n``` json\n{\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \"Комментарий диспетчера\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": \"2026-08-28 00:00:00\",\n \"member_name\": \"Иванов И.И.\",\n \"route_name\": \"Маршрут 15\",\n \"gps_category_type_key\": \"gps_category_type_s\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000001\",\n \"to_imei\": \"4324324234\",\n \"terminals\": [\n {\n \"imei\": \"862531040000001\",\n \"to_imei\": \"4324324234\"\n },\n {\n \"imei\": \"862531040000002\",\n \"to_imei\": \"3244324\"\n }\n ]\n}\n```\n\n---\n\n**Пример ответа** (несколько идентификаторов):\n\n``` json\n[\n {\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \"Комментарий диспетчера\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": \"2026-08-28 00:00:00\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000001\",\n \"to_imei\": \"4324324234\",\n \"terminals\": [\n {\n \"imei\": \"862531040000001\",\n \"to_imei\": \"4324324234\"\n }\n ]\n },\n {\n \"id\": \"1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\",\n \"name\": \"Ретрансляция на группу объектов\",\n \"comment\": \"\",\n \"retrans_protocol\": \"retranslator_egts\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9002,\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"activate_date\": \"2026-08-28 00:00:00\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000003\",\n \"to_imei\": \"862531040000003\",\n \"terminals\": [\n {\n \"imei\": \"862531040000003\",\n \"to_imei\": \"862531040000003\"\n },\n {\n \"imei\": \"862531040000004\",\n \"to_imei\": \"862531040000004\"\n }\n ]\n }\n]\n```\n\n---\n\n**Ошибки:**\n\n- `422` — не передан `ids`, либо по переданным идентификаторам\n не нашлось ни одной ретрансляции;\n- `422` — в `ids` попал некорректный идентификатор;\n- `422` — нет доступа хотя бы к одной из запрошенных ретрансляций.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9b78562a-8b21-4041-ab8b-e053ad26133e", "name": "Ретрансляция или массив ретрансляций", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"comment\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"activate_date\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"imei\": \"\",\n \"to_imei\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b6ca141-a0f9-40ed-b9fd-d3b79d6c499a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "905624c2-35a8-45f3-ac56-3f770059bc23", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e62fcac-7fc6-4e8d-9f61-9abccbb76b67", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2308f4d8-327a-4c2d-8a14-5691910674eb", "name": "Создание ретрансляции", "request": { "name": "Создание ретрансляции", "description": { "content": "Создаёт ретрансляцию и возвращает её в готовом виде — вместе с\nтерминалами, которые за ней закреплены. Создание атомарно: терминалы\nматериализуются сразу в момент создания.\n\n---\n\nТело запроса описано в общей схеме: обязательны `retrans_server`,\n`retrans_port`, `retrans_protocol` и хотя бы один из источников —\n`terminals` или `units_groups_ids` (допускается их одновременное указание\nв смешанном режиме).\n\n---\n\n**Режим `terminals` (ручной выбор):**\n\n- каждый `imei` должен существовать и быть доступен текущему пользователю;\n- `to_imei` обязателен и должен отличаться от `imei`, если сервер\n принадлежит SKIF;\n- один `imei` нельзя указать дважды в списке;\n- один и тот же терминал нельзя ретранслировать на тот же `retrans_server`\n и `retrans_port` дважды;\n- проверяется отсутствие зацикленной ретрансляции через серверы SKIF;\n- компания каждой строки всегда берётся у самого терминала. Значение\n `company_id` из тела задаёт компанию самого канала — мастер-записи,\n которая появляется только при работе с группами, — и компании ручных\n терминалов не переопределяет.\n\n---\n\n**Режим `units_groups_ids` (динамические группы):**\n\n- группы проверяются сервисом объектов: группа должна существовать,\nбыть доступна пользователю, и все указанные группы должны принадлежать\n одной компании;\n- ответ — всегда один объект ретрансляции, а в `terminals` попадают только\n терминалы с непустым `imei`: отдельной записи без `imei` в ответе нет;\n- терминалы этих групп подтягиваются и материализуются сразу же при\n создании и возвращаются в массиве `terminals` ответа;\n- у каждого терминала, пришедшего из группы объектов, `to_imei` по\n умолчанию совпадает с `imei`;\n- ретрансляция подписывается на каждую группу. Дальше состав\n поддерживается автоматически: при добавлении, изменении или удалении\n машин в группе сервис объектов сам присылает актуальный список\n терминалов;\n- если группы принадлежат одной компании, `company_id` передавать в теле\n не обязательно — он определится автоматически. Если передать, будет\n использовано переданное значение.\n\n---\n\n**Смешанный режим (`terminals` + `units_groups_ids`):**\n\n- допускается одновременное указание и ручных терминалов, и групп объектов;\n- в массиве `terminals` ответа возвращается объединённый список всех\n терминалов без дубликатов;\n- если терминал указан в `terminals` вручную и одновременно входит в одну\n из групп, он получает статус ручного (`MANUAL`): при последующем\n удалении автомобиля из группы его ретрансляция не прервётся.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса** — смешанный режим (группа + ручной терминал):\n\n``` json\n{\n \"name\": \"Ретрансляция Карьер и Резерв\",\n \"comment\": \"Самосвалы по группе + дежурная Газель\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"secret123\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"is_active\": true,\n \"units_groups_ids\": [\n \"1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\"\n ],\n \"terminals\": [\n {\n \"imei\": \"862531040000099\",\n \"to_imei\": \"862531040000099\"\n }\n ]\n}\n```\n\n---\n\n**Пример ответа:**\n\n``` json\n{\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция Карьер и Резерв\",\n \"comment\": \"Самосвалы по группе + дежурная Газель\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"secret123\",\n \"is_active\": true,\n \"activate_date\": \"2026-10-02 00:00:00\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000099\",\n \"to_imei\": \"862531040000099\",\n \"terminals\": [\n {\n \"imei\": \"862531040000099\",\n \"to_imei\": \"862531040000099\"\n },\n {\n \"imei\": \"862531040000001\",\n \"to_imei\": \"862531040000001\"\n },\n {\n \"imei\": \"862531040000002\",\n \"to_imei\": \"862531040000002\"\n }\n ]\n}\n```\n\nПервый терминал в `terminals` — ручной, из тела запроса, поэтому именно он\nдублируется в полях `imei` и `to_imei`. Терминалы, пришедшие из группы\nобъектов, идут следом в том порядке, в каком их вернул сервис объектов;\nсами группы объектов в ответе не выводятся.\n\n---\n\n**Ошибки:**\n\n- `422` — не передан `retrans_server`, либо в адресе нет точки;\n- `422` — не передан `retrans_port`, либо значение не число или вне\n диапазона 0–65535;\n- `422` — не передан `retrans_protocol` или значение не из списка допустимых;\n- `422` — не передан ни `terminals`, ни `units_groups_ids`;\n- `422` — терминал не найден или нет доступа к нему;\n- `422` — для сервера SKIF не задан `to_imei` либо он совпадает с `imei`;\n- `422` — `imei` повторяется в списке терминалов;\n- `422` — такой терминал уже ретранслируется на этот же сервер и порт;\n- `422` — ретрансляция зациклена: цепочка терминалов возвращается в себя;\n- `422` — указана недопустимая категория GPS или тип транспорта\n (значения сверяются со справочником всегда, если переданы);\n- `422` — в `units_groups_ids` попал некорректный идентификатор группы;\n- `422` — группа объектов не найдена или нет доступа к ней;\n- `422` — группы объектов принадлежат разным компаниям;\n- `422` — в режиме `units_groups_ids` не удалось определить компанию\n и `company_id` не передан в теле запроса.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "356b88f7-e302-498a-8bd6-9d60f9fb4aec", "name": "Созданная ретрансляция", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"comment\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"activate_date\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"imei\": \"\",\n \"to_imei\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c4b4704-5824-4096-9196-f6147ec6a1dd", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b75ba030-62d2-47f7-b880-833a0c1ba181", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c959b880-4861-403f-a24e-8fd0af1d0c6d", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "79ac6ac5-a3b7-4df2-be8e-28f019c94bbd", "name": "Массовое удаление ретрансляций", "request": { "name": "Массовое удаление ретрансляций", "description": { "content": "Ставит в очередь на удаление сразу несколько ретрансляций.\n\n---\n\nУдаление отложенное: идентификаторы возвращаются сразу, а сами записи\nудаляются планировщиком позже. Это защищает от случайного удаления большого\nобъёма данных по одному клику.\n\n---\n\nРетрансляция отписывается от своих групп объектов, и её терминалы\nперестают ретранслироваться.\n\n---\n\n**Параметры:**\n\n- `ids` — идентификаторы ретрансляций через запятую, обязательный параметр.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n```\nDELETE /retranslators?ids=eeadc5d1-9a68-4083-bef6-51173d532cb0,1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\n```\n\n---\n\n**Пример ответа:**\n\n``` json\n{\n \"id\": \"3d4f7a1c-8b2e-4c6d-9f1a-5e7b8c9d0a1f\"\n}\n```\n\nИдентификатор из ответа — задача удаления, а не ретрансляция.\n\n---\n\n**Ошибки:**\n\n- `422` — не передан `ids`;\n- `422` — нет доступа хотя бы к одной из указанных ретрансляций.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e6d64f3d-71ae-4ddf-82a3-a06b9b29402f", "name": "Идентификатор задачи удаления", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30812ab0-87f1-4c9f-ad71-3395e7b9a69e", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2954853b-c642-4021-81bf-e208b2a7a19c", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d4c01f5-5d60-4e6d-8a32-b5940f49dfbb", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Идентификаторы ретрансляций через запятую", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "06e65f00-1a11-45c7-a64f-d3b0ea40fe09", "name": "Обновление ретрансляции", "request": { "name": "Обновление ретрансляции", "description": { "content": "Обновляет ретрансляцию целиком и возвращает её в готовом виде.\n\n---\n\nТело запроса то же, что и при создании: обязательны `retrans_server`,\n`retrans_port`, `retrans_protocol` и один из режимов — `terminals`\nили `units_groups_ids`.\n\n---\n\nВ `units_groups_ids` передаётся полный новый состав групп, а не только\nизменения: группа, которой нет в списке, будет отписана.\n\n---\n\n**Что происходит при обновлении:**\n\n- `{id}` может быть идентификатором ретрансляции или любого её терминала.\n Обновляется вся ретрансляция вместе с терминалами;\n- проверки `retrans_server`, `retrans_port`, `retrans_protocol` и перечисленных\n терминалов такие же, как при создании;\n- состав терминалов заменяется на переданный;\n- добавленные группы объектов сразу же подтягивают своих терминалов,\n а удалённые группы отписываются и их терминалы уходят из ретрансляции;\n- при выключении (`is_active: false`) ретрансляция отписывается от всех групп,\n при включении — подписывается заново;\n- компания берётся у терминала, а в режиме `units_groups_ids` — по группам.\n Если `company_id` не передан, сохраняется компания, которая была до этого.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n``` json\n{\n \"name\": \"Ретрансляция на группу объектов\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9003,\n \"retrans_protocol\": \"retranslator_egts\",\n \"is_active\": true,\n \"units_groups_ids\": [\n \"1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\"\n ]\n}\n```\n\n---\n\n**Пример ответа:**\n\n``` json\n{\n \"id\": \"1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\",\n \"name\": \"Ретрансляция на группу объектов\",\n \"comment\": \"\",\n \"retrans_protocol\": \"retranslator_egts\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9003,\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"activate_date\": \"2026-08-28 00:00:00\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000003\",\n \"to_imei\": \"862531040000003\",\n \"terminals\": [\n {\n \"imei\": \"862531040000003\",\n \"to_imei\": \"862531040000003\"\n }\n ]\n}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — ретрансляция с таким `{id}` не найдена;\n- `422` — не передан `retrans_server`, либо в адресе нет точки;\n- `422` — не передан `retrans_port`, либо значение не число или вне\n диапазона 0–65535;\n- `422` — не передан `retrans_protocol` или значение не из списка допустимых;\n- `422` — не передан ни `terminals`, ни `units_groups_ids`;\n- `422` — терминал не найден или нет доступа к нему;\n- `422` — для сервера SKIF не задан `to_imei` либо он совпадает с `imei`;\n- `422` — `imei` повторяется в списке терминалов;\n- `422` — терминал уже ретранслируется на этот же сервер и порт\n в другой ретрансляции;\n- `422` — ретрансляция зациклена: цепочка терминалов возвращается в себя;\n- `422` — указана недопустимая категория GPS или тип транспорта;\n- `422` — в `units_groups_ids` попал некорректный идентификатор группы;\n- `422` — группа объектов не найдена или нет доступа к ней;\n- `422` — группы объектов принадлежат разным компаниям;\n- `422` — в режиме `units_groups_ids` не удалось определить компанию,\n `company_id` не передан и прежняя компания неизвестна.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "81fb3de3-c2a1-4159-93b9-80129f4263d9", "name": "Обновлённая ретрансляция", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"comment\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"activate_date\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"imei\": \"\",\n \"to_imei\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9beb871f-3062-402c-a6fd-c53a969375eb", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "707ab541-a5a7-4d86-9713-98cf8552f246", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38ddd58b-ddf7-40e5-a180-80eed7ddc3b9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c38393f9-2e9f-4ac0-a5d3-b9e4f3135147", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": true,\n \"name\": \"\",\n \"comment\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"units_groups_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "77540b15-af16-45a8-a0c1-ffc484717c7c", "name": "Удаление ретрансляции", "request": { "name": "Удаление ретрансляции", "description": { "content": "Удаляет ретрансляцию вместе со всеми её терминалами.\n\n---\n\nВ отличие от массового удаления, здесь удаление происходит сразу.\n\n---\n\nРетрансляция отписывается от своих групп объектов, и её терминалы\nперестают ретранслироваться.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n```\nDELETE /retranslators/eeadc5d1-9a68-4083-bef6-51173d532cb0\n```\n\n---\n\n**Пример ответа:**\n\n``` json\n{}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — ретрансляция с таким `{id}` не найдена;\n- `422` — нет доступа к ретрансляции.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "034ac44b-3dc1-45ba-9edc-c90ed5ccabf6", "name": "Ретрансляция удалена", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12a45cb6-3bb4-44ff-bd53-4b105af9e4e6", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "933a4561-66f2-4b01-af31-3c96d888bd9b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e21e4aa2-22e2-4fd7-96a8-99a19add8452", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5317187b-38d9-4f3e-a35e-d5dd134d1fb4", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f501e559-86e9-4762-8d61-5074a4a29e62", "name": "Реестр ретрансляций", "request": { "name": "Реестр ретрансляций", "description": { "content": "Возвращает ретрансляции по фильтру. Нужен для таблицы ретрансляций\nс поиском, сортировкой и постраничным выводом.\n\n---\n\n**Параметры тела запроса:**\n\n- `from` — с какого элемента выдавать результат, по умолчанию `0`;\n- `count` — сколько элементов вернуть, по умолчанию `100000`.\n Если в выборке участвует несколько компаний, значение ограничивается\n числом `10000`;\n- `value` — строка поиска. Если она не состоит только из цифр, ищется\n вхождение в `name`, `retrans_server`, `retrans_protocol` и в IMEI;\n если состоит из цифр — ищется в IMEI;\n- `field` — уточнение для числового поиска. При `field: \"imei\"` ищется\n точное совпадение IMEI, иначе — вхождение;\n- `sortField` — поле сортировки, одно из значений\n \\[`imei`, `is_active`, `retrans_protocol`, `retrans_server`, `name`, `comment`].\n Если поле не из списка, сортировка не применяется;\n- `sortDesc` — сортировка по убыванию, `true` или `false`;\n- `conditions` — дополнительные условия отбора, массив объектов вида\n `{\"field\": \"значение\", \"value\": \"значение\"}`. Учитываются поля\n `imei` и `retrans_server`;\n- `companies` — компании, по которым ведётся выборка, массив объектов\n вида `{\"id\": \"идентификатор\"}`. Пересекается с уже разрешённым набором,\n а не заменяет его.\n\n---\n\n**Какие компании попадают в выборку:**\n\nреестр работает в рамках активной компании пользователя. Поле `companies`\nможет только сузить выборку внутри неё, вывести ретрансляции других\nдоступных компаний этим методом нельзя. Для выборки сразу по нескольким\nдоступным компаниям используется админский запрос с `model: \"retranslators\"`,\nкоторый отдаёт тот же состав `{max, list}`.\n\n---\n\n**Состав ответа:**\n\n- в ответе ретрансляции собраны по группам: одна ретрансляция — один\n элемент `list`, сколько бы терминалов за ней ни стояло;\n- в ответе ретрансляций по группам объектов видны их терминалы,\n сами группы не выводятся;\n- `max` — сколько ретрансляций подошло под фильтр всего, без учёта\n `from` и `count`. Нужен для постраничной навигации;\n- `activate_date` в реестре не приходит: дату включения видно\n в `GET /retranslators`.\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Пример запроса:**\n\nНайти ретрансляции, у которых IMEI содержит подстроку \"123\",\nи отсортировать по имени\n\n``` json\n{\n \"from\": 0,\n \"count\": 20,\n \"value\": \"123\",\n \"field\": \"imei\",\n \"sortField\": \"name\",\n \"sortDesc\": false\n}\n```\n\n---\n\n**Пример ответа:**\n\n``` json\n{\n \"max\": 2,\n \"list\": [\n {\n \"id\": \"eeadc5d1-9a68-4083-bef6-51173d532cb0\",\n \"name\": \"Ретрансляция в Эрнис1\",\n \"comment\": \"Комментарий диспетчера\",\n \"retrans_protocol\": \"retranslator_wilaon_ips\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9001,\n \"retrans_pw\": \"1234\",\n \"is_active\": true,\n \"activate_date\": null,\n \"member_name\": \"Иванов И.И.\",\n \"route_name\": \"Маршрут 15\",\n \"gps_category_type_key\": \"gps_category_type_s\",\n \"public_vehicle_type_key\": \"\",\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\",\n \"terminals\": [\n {\n \"imei\": \"862531040000123\",\n \"to_imei\": \"4324324234\"\n }\n ]\n },\n {\n \"id\": \"1c0b5a44-0f1a-4f7b-9a51-2b7c6f0d1e33\",\n \"name\": \"Ретрансляция на группу объектов\",\n \"comment\": \"\",\n \"retrans_protocol\": \"retranslator_egts\",\n \"retrans_server\": \"195.208.1.1\",\n \"retrans_port\": 9002,\n \"retrans_pw\": \"\",\n \"is_active\": false,\n \"activate_date\": null,\n \"company_id\": \"6c1a0092-9f99-4fb0-a2f3-37eb8db08b31\",\n \"imei\": \"862531040000123\",\n \"to_imei\": \"862531040000123\",\n \"terminals\": [\n {\n \"imei\": \"862531040000123\",\n \"to_imei\": \"862531040000123\"\n }\n ]\n }\n ]\n}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — у пользователя нет доступных компаний, либо после фильтрации\n по `companies` не осталось ни одной.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d58c3e4a-5134-49da-a0d3-3aba1ba3e5f8", "name": "Реестр ретрансляций", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"max\": \"\",\n \"list\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"comment\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"activate_date\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"comment\": \"\",\n \"retrans_protocol\": \"\",\n \"retrans_server\": \"\",\n \"retrans_port\": \"\",\n \"retrans_pw\": \"\",\n \"is_active\": \"\",\n \"company_id\": \"\",\n \"terminals\": [\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n },\n {\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ],\n \"activate_date\": \"\",\n \"member_name\": \"\",\n \"route_name\": \"\",\n \"gps_category_type_key\": \"\",\n \"public_vehicle_type_key\": \"\",\n \"imei\": \"\",\n \"to_imei\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4451e3da-ae1a-4e7b-a74c-a2aa529ce719", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c26c4b3f-d115-449c-b2f1-0f787487576f", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f7ec935-36ee-4287-a7a5-d8690abfbcba", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": 0,\n \"count\": 100000,\n \"value\": \"\",\n \"field\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": false,\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e290bf91-85f9-4832-9762-6a776d6fdb3e", "name": "Журнал ретрансляции", "request": { "name": "Журнал ретрансляции", "description": { "content": "Возвращает журнал передачи данных ретрансляции за выбранный период:\nчто уходило на сервер, с каким статусом и в каком тексте.\n\n---\n\n**Параметры тела запроса:**\n\n- `from` — начало периода, обязательный параметр,\n формат `yyyy-MM-dd HH:mm:ss`;\n- `to` — конец периода, обязательный параметр,\n формат `yyyy-MM-dd HH:mm:ss`;\n- `max` — сколько записей вернуть, по умолчанию `100`, максимум `500`;\n- `offset` — с какой записи начинать выдачу, по умолчанию `0`;\n- `timezone_key` — часовой пояс, в котором трактуются `from` и `to`.\n Формат `UTC+3`. По умолчанию берётся часовой пояс текущей компании.\n Время в ответе возвращается уже в этом поясе;\n- `imeis` — список IMEI, по которым нужен журнал, например при разборе\n одного терминала из ретрансляции. Если не передан, берётся первый\n терминал самой ретрансляции.\n\n---\n\nТерминалы ретрансляции сопоставляются по правилам ретрансляции: если у\nтерминала задан `to_imei`, в журнале ищется именно он, а не исходный IMEI.\n\n---\n\nВыборка идёт по данным, которые ретрансляция отправила на свой сервер, плюс\nзаписи без указания сервера.\n\n---\n\n**Состав ответа:**\n\n- `columns` — описание колонок таблицы, чтобы интерфейсу не держать\n заголовки у себя: массив объектов `{key, name}`;\n- `rows` — сами записи, от свежих к старым. В каждой записи\n `datetime`, `imei`, `is_error`, `text` и `server`;\n- `max_rows` — сколько записей попало в период всего, без учёта\n `max` и `offset`. Нужен для постраничной навигации.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nЖурнал всей ретрансляции за сутки\n\n``` json\n{\n \"from\": \"2026-08-27 00:00:00\",\n \"to\": \"2026-08-28 00:00:00\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"UTC+3\"\n}\n```\n\nЖурнал одного терминала ретрансляции\n\n``` json\n{\n \"from\": \"2026-08-27 00:00:00\",\n \"to\": \"2026-08-28 00:00:00\",\n \"imeis\": [\n \"862531040000001\"\n ]\n}\n```\n\n---\n\n**Пример ответа:**\n\n``` json\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\": \"2026-08-27 21:45:12\",\n \"imei\": \"4324324234\",\n \"is_error\": false,\n \"text\": \"Отправлено точек: 1\",\n \"server\": \"195.208.1.1\"\n },\n {\n \"datetime\": \"2026-08-27 21:40:03\",\n \"imei\": \"4324324234\",\n \"is_error\": true,\n \"text\": \"Соединение отклонено сервером\",\n \"server\": \"195.208.1.1\"\n }\n ],\n \"max_rows\": 2\n}\n```\n\n---\n\n**Ошибки:**\n\n- `422` — ретрансляция с таким `{id}` не найдена;\n- `422` — нет доступа к ретрансляции;\n- `422` — не передан `from` или `to`;\n- `422` — дата указана в неверном формате;\n- `422` — `max` больше 500;\n- `422` — ретрансляция без терминалов, журнал брать нечего;\n- `422` — ни один из переданных в `imeis` не принадлежит этой ретрансляции.", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4f4c17d2-e3b6-4e2f-9f67-225b45f8f9d8", "name": "Журнал ретрансляции", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"columns\": [\n {\n \"key\": \"\",\n \"name\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\"\n }\n ],\n \"rows\": [\n {\n \"datetime\": \"\",\n \"imei\": \"\",\n \"is_error\": \"\",\n \"text\": \"\",\n \"server\": \"\"\n },\n {\n \"datetime\": \"\",\n \"imei\": \"\",\n \"is_error\": \"\",\n \"text\": \"\",\n \"server\": \"\"\n }\n ],\n \"max_rows\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58dc918d-8b4d-499d-89ca-100d5ba6382a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e60e5b7-b951-4fdb-aa2c-b7016cd4179e", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30daf025-e445-4441-8d18-9f12e3a22d0c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a5f7458-a2cd-4cdf-9b26-51bf888e44ef", "name": "Ошибка бизнес-логики", "originalRequest": { "url": { "path": [ "api_v1", "retranslators", ":id", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Идентификатор ретрансляции или любого её терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"to\": \"\",\n \"max\": 100,\n \"offset\": 0,\n \"timezone_key\": \"\",\n \"imeis\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Ретрансляция исторических данных", "description": "Ретрансляция исторических данных", "item": [ { "id": "1029703b-6430-4f0d-b10c-8b8611277735", "name": "Запуск исторической ретрансляции данных", "request": { "name": "Запуск исторической ретрансляции данных", "description": { "content": "**Добавление ретрансляции исторических данных**\n\n---\n\nПоля в JSON:\n\nimei - IMEI объекта\n\nterminal_type - ключ типа протокола объекта.\n\nname - имя объекта.\n\ncomment - комментарий.\n\nretrans_from - период ретрансляции от в формате yyyy-MM-dd HH:mm:ss\n\nretrans_to - период ретрансляции до.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\nPOST [https://api.skif.pro/api_v1/retranslator_histories](https://api.skif.pro/api_v1/retranslator_histories)\n\n``` json\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\n**Пример ответа:**\n\nЕсли запрос успешен, тогда возвращается соозданная запись, иначе ошибка.\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "fdc5f324-8c07-4067-9e56-6ed185e8b860", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "869ee407-b4ef-40f8-bcd4-d3037c4db3a0", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ea912a1-fd9e-4944-aaee-baa1a6ff2674", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f03416c5-6325-4f40-b5f9-c5e9301e248a", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "741847bc-c5c2-4d9f-80d8-3bfa0e65aaca", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16ab6f4c-022e-469f-8d84-509fe3a33c20", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44d99646-65e0-4464-badc-44cce83da8f0", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"comment\": \"\",\n \"imei\": \"\",\n \"name\": \"\",\n \"retrans_from\": \"\",\n \"retrans_to\": \"\",\n \"terminal_type\": \"\",\n \"unit_name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ddc73f66-8a81-4ad1-9640-cb6336950e12", "name": "Пакетный запуск исторической ретрансляции", "request": { "name": "Пакетный запуск исторической ретрансляции", "description": { "content": "

Массовое добавление ретрансляции исторических данных

\n
\n

Поля в JSON:

\n

imei - IMEI объекта

\n

terminal_type - ключ типа протокола объекта.

\n

name - имя объекта.

\n

comment - комментарий.

\n

retrans_from - период ретрансляции от в формате yyyy-MM-dd HH:mm:ss

\n

retrans_to - период ретрансляции до.

\n
\n

Роль: Супервизор и выше.

\n
\n

Пример запроса:

\n

POST https://app.skif.pro/api_v1/retranslator_histories_bulk

\n
[\n{\n    \"imei\": \"12346789\",\n    \"terminal_type\": \"navtelecom\",\n    \"name\": \"Ретранслятор 1\",\n    \"unit_name\": \"Объект\",\n    \"comment\": \"Комментарий 1\",\n    \"retrans_from\": \"2023-01-01 00:00:00\",\n    \"retrans_to\": \"2023-01-02 00:00:30\"\n},\n{\n    \"imei\": \"12346789\",\n    \"terminal_type\": \"navtelecom\",\n    \"name\": \"Ретранслятор 2\",\n    \"unit_name\": \"Объект\",\n    \"comment\": \"Комментарий 2\",\n    \"retrans_from\": \"2025-01-01 00:00:00\",\n    \"retrans_to\": \"2025-01-02 00:00:30\"\n}\n]\n\n
\n
\n

Пример ответа:

\n

Если запрос успешен, тогда возвращается соозданная запись, иначе ошибка.

\n
[\n{\n    \"id\": \"435aa261-d06a-422b-b64c-1ee94b447c9e\",\n    \"imei\": \"12346789\",\n    \"terminal_type\": \"navtelecom\",\n    \"name\": \"Ретранслятор 1\",\n    \"unit_name\": \"Объект\",\n    \"comment\": \"Комментарий 1\",\n    \"retrans_from\": \"2023-01-01 00:00:00\",\n    \"retrans_to\": \"2023-01-02 00:00:30\"\n    \"status\": \"WAITING\"\n},\n{\n    \"imei\": \"12346789\",\n    \"terminal_type\": \"navtelecom\",\n    \"name\": \"Ретранслятор 2\",\n    \"unit_name\": \"Объект\",\n    \"comment\": \"Комментарий 2\",\n    \"retrans_from\": \"2025-01-01 00:00:00\",\n    \"retrans_to\": \"2025-01-02 00:00:30\"\n    \"status\": \"WAITING\"\n}\n]\n\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "279dece0-fdd4-40d0-88c7-6ef6fb593449", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4232d5ad-37da-4ec9-9335-817d8e7853f1", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53855cee-3cd0-44db-9caa-75fddfa1086b", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2455682-5c2f-4be8-be87-9e3d36cca648", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3ccbf1e9-39a3-4d9d-b643-4d745b6ac6c0", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6df847b-7dd9-4935-af52-25a23ad0b43c", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf279fa5-036c-4201-be1c-c605861c89d0", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "retranslator_histories_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Команды терминалов", "description": "API по работе с команд терминалов", "item": [ { "id": "462111bb-6fec-4b36-b632-f4ed67c0ed51", "name": "/commands?ids=:ids", "request": { "name": "/commands?ids=:ids", "description": { "content": "**Поиск команд по ID**\n\n---\n\nВозвращает массив команд по ID.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретная команда.\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/commands?ids=8d174fc8-57c8-4a35-9347-0dba76c04957\n\n ```\n\nПример ответа:\n\n```\n{\n \"id\": \"8d174fc8-57c8-4a35-9347-0dba76c04957\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531040000003\",\n \"command\": \"command three\",\n \"status\": \"WAITING\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "38282e1d-7e8c-4890-a268-0203700432fd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "62b3a2d8-b7f3-45bc-897f-0fdff7bf6d11", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93f8e257-067f-4920-99dc-c766bcdcb836", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d0cc920-8b60-456e-993a-e61f9619010a", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0d36198-9ed6-4bd5-94ac-cd721655467c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "385b1336-c6c9-473a-b99b-63f623cbfeb4", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b16b5091-dd2e-42fe-a136-78e2a9e3cb5d", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "15d7e314-0ea2-4925-b213-96d4d35aacf4", "name": "/commands", "request": { "name": "/commands", "description": { "content": "**Добавление новой команды**\n\n---\n\n**Параметры:**\n\n\"company_id\": ID компании, обязательно для дилера. Для компании необязательно - получается активная компания. \n\"imei\": Imei, текст, обязательно. \n\"command\": Команда, обязательно для дилера, для компании нет. \n\"template\": шаблон команды, обязательно для компании.\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Пример запроса:**\n\n1) Создание команды дилером\n\n---\n\n```\n{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"862531040000013\",\n \"commnad\": \"*?V\"\n}\n\n ```\n\nВозвращается созданная запись\n\nstatus - статус отправки команды. Возможные значения: WAITING - в ожидании, OK - отправлена, FAIL - не удалось отправить. \nПример ответа:\n\n```\n{\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"862531040000013\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n}\n\n ```\n\n---\n\n2) Создание команды в компании\n\n```\n{\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531040000013\",\n \"template\": {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\", // ID шаблонов команд\n \"params_values\": [ // значения параметров\n {\"key\": \"Номер выхода\", \"value\": \"2\"}\n ]\n }\n}\n\n ```\n\nОтвет:\n\n```\n{\n \"id\": \"cc584df9-791b-4074-af7e-6bc319be6173\",\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imei\": \"862531040000013\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "39f850b0-9c89-4335-aa99-b2bdd33a30c3", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a0f50ed1-14ec-45a1-9593-fb2d61e02ddf", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90d239e0-3d21-42ae-9f85-bc007922e72d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27a4bbf0-f8e0-44be-bc55-378f27c3d9d1", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9cd11aa-25fd-41d4-9ca2-b0728dccc5e9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f97ee2b-d82c-49ba-9c50-34b39de6d3f2", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d03dac16-d337-4610-b83a-36aeb718371d", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"imei\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d0b726b-8369-4718-acb1-490261ac5e0d", "name": "/commands_bulk", "request": { "name": "/commands_bulk", "description": { "content": "**Добавить новую команду для нескольких терминалов**\n\n---\n\n**Параметры:**\n\n\"imeis\": Список Imei, текст массив. \n\"command\": Команда, обязательно для дилера, для компании нет. \n\"template\": Шаблон команды, обязательно для компании.\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Пример запроса:**\n\n**1) Создание команды дилером**\n\n---\n\n```\n{\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imeis\": [\"862531040000013\", \"862531040000014\"],\n \"commnad\": \"*?V\"\n}\n\n ```\n\nВозвращается созданные записи\n\nstatus - статус отправки команды. Возможные значения: WAITING - в ожидании, OK - отправлена, FAIL - не удалось отправить \nПример ответа:\n\n```\n[\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"862531040000013\",\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\": \"862531040000013\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n }\n]\n\n ```\n\n---\n\n**2) Создание команды в компании**\n\n```\n{\n \"company_id\": \"3aafd100-c44d-4b04-ae93-06978b908ea9\",\n \"imeis\": [\"862531040000013\", \"862531040000014\"],\n \"template\": {\n \"id\": \"eede4765-273c-45da-b2c6-8b331d532402\",\n \"params_values\": [\n {\"key\": \"Номер выхода\", \"value\": \"2\"}\n ]\n }\n}\n\n ```\n\nОтвет:\n\n```\n[\n {\n \"id\": \"7d7bb072-9daf-4142-9b03-3efea7265a73\",\n \"company_id\": \"a786d1e0-5cc2-4e3d-a1f6-2c8ae06f9a39\",\n \"imei\": \"862531040000013\",\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\": \"862531040000013\",\n \"commnad\": \"*?V\",\n \"status\": \"WAITING\"\n }\n]\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "018aecab-7fbe-4474-b823-7eedd14646cb", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "05b8e3c1-1c00-441f-bd62-cdff7453afa5", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92c789e6-8522-47bc-b9b2-6bbbfc0c9058", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f750ac3-82d4-4696-b3d6-8732be2a7801", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d77f9500-71c0-4cd1-946c-326503c133bf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "311c8278-1025-4f2b-82bb-397c4a0946d3", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "559d2a48-b420-4f9f-81b1-a4d6ee1ae9b4", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"company_id\": \"\",\n \"imei\": \"\",\n \"template\": {\n \"id\": \"\",\n \"params_values\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e8f42507-eeb4-40e1-9ec0-868eb84a33b9", "name": "/commands/:id", "request": { "name": "/commands/:id", "description": { "content": "**Обновить данные команды**\n\n---\n\nОбновляет переданные параметры\n\n---\n\n**Параметры:**\n\nсм метод POST /commands\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /commands?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "45c2e8f6-936f-4122-b6c8-b9faa820cfa8", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7902c5b2-a2bc-4be0-9ed4-7a523151efb6", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8738a171-d941-4ae1-a200-2af21c45ec02", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6bb47554-8e5e-44a8-af43-5c8f00d725d9", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1caa9d4b-b10b-451b-bbc3-f7081d639df1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ebcace7-5e74-4595-8273-46dd4e8ee1d7", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0067cbd-cad8-4c58-925b-d81c0a56a753", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f3426de1-c725-4ae9-9108-76e3a86973d7", "name": "/commands/:id", "request": { "name": "/commands/:id", "description": { "content": "**Удаление команды по ее id**\n\n---\n\nУдаляет команду\n\n---\n\n**Параметры:**\n\nid записи\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Ответ:** 200\n\nЕсли команда с таким id не найдена, то возвращается ошибка 422\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b2edfc55-6783-40ea-af2f-0bb12fa00d94", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "916df471-042a-4407-8b99-8025ece30aa6", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57398383-096f-4647-b42e-ca4cc2fc9b76", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8aec96eb-d336-4bb2-bf37-45dcca8b4ef2", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22581bbc-c435-40b0-9194-7bd4bcbfde7c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "823fb27f-8f4d-4ad5-8337-8a87cf59d422", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2231c6dd-8332-4892-b74f-6732400bda3b", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d9ce5236-cbfa-40e1-88a0-6545346e360e", "name": "/commands/list", "request": { "name": "/commands/list", "description": { "content": "**Поиск команды по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nзначения для field - imei\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Пример запроса:**\n\nПолучить первые 2 команды для imei\n\n```\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"imei\",\n \"value\": \"862531040000015\"\n }\n ]\n}\n\n ```\n\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\": \"862531040000015\",\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\": \"862531040000015\",\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\": \"862531040000015\",\n \"command\": \"command abc\",\n \"status\": \"WAITING\"\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "77895e98-0952-465f-9f4b-3737388aea93", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "50d4da5f-d518-41eb-800a-33c91dff5f54", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53934cbf-a39f-4ebd-b5d5-23588676a2f3", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf6880d8-f9ea-4ca9-a516-247b2c7d028e", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6968cca8-7c9e-44d2-a3be-bc224e5ed911", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1c349b0-b894-428c-8ade-853aa540f3ab", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1dc3c0d9-0f5e-4a61-acb7-9cb6a20a3711", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Шаблоны команд терминалов", "description": "API по работе с шаблонами команд терминалов", "item": [ { "id": "1642c5f3-e907-4459-bf0a-8492c6a6673a", "name": "/commands_templates?ids=:ids", "request": { "name": "/commands_templates?ids=:ids", "description": { "content": "**Получение шаблонов команд по ID**\n\n---\n\nВозвращает шаблоны команд.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный шаблон команды.\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/commands_templates?ids=edfd0b85-b056-4726-9762-fa63dc61efd2\n\n ```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c688a64b-e413-4f40-b049-7499b835d050", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "17ebcce4-5900-4f0f-83bb-6530966e10ac", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b79cba8-7097-47f3-ab25-5501e3ab2ad1", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfae32c1-1096-43ae-a749-aebb75f59d72", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e59cac52-f3c4-402a-a9ef-2a1e217ddc8c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b58dc150-8ebe-4aa2-b3be-4f5ac7e8709c", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d5baf23-817d-4bdd-ad9b-33b40aeafd93", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "35210650-653f-4795-8d6d-04c2e07b58c5", "name": "/commands_templates", "request": { "name": "/commands_templates", "description": { "content": "**Добавление нового шаблона команды**\n\n---\n\n**Параметры:** \n\"name\": Название шаблона команды. \n\"terminal_type\": Тип терминала. \n\"command_template\": Шаблон команды.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"name\": \"Команда произвольной звуковой индикации зуммером\",\n \"terminal_type\": \"navtelecom\",\n \"command_template\": \"*!BEEP {Кол-во импульсов в каждом такте},{Кол-во тактов в звуковой индикации},{Длительность каждого такта в 1/128 долях секунды.},{Частота звуковой индикации (Гц)}\"\n}\n\n ```\n\n---\n\n**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d4d1a876-2ba4-4f87-a0f8-cce636c60e72", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7600f322-25bf-4802-9e3b-9a9a2899ceb3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc454009-70a4-400b-8635-214a73128614", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2ab05b1-d3b4-44eb-ae2b-e77ca5b24f25", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62d48374-ec56-40b5-b55c-0197cc9fd809", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf535507-6228-466a-9e59-f72264f1cb93", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0415773b-2c12-40ee-ba98-d57e1f1b076c", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"command_template\": \"\",\n \"name\": \"\",\n \"terminal_type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "53899f0a-6d3e-4085-ad77-ad411719355d", "name": "/commands_templates/:id", "request": { "name": "/commands_templates/:id", "description": { "content": "**Обновить данные шаблона команды**\n\n---\n\n**Параметры:**\n\nid - ID шаблона команды \nсм метод POST /commands_templates\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен GET /commands_templates?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1b45ca4d-d87a-4b78-b9c9-ee39fdddeeb6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "38b87038-4159-4575-b96c-b8ef7aaea29c", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f5f07f1-0a5e-4159-9227-6a4189313e1d", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71a9354e-43c7-4794-b7f0-357c255ea78e", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d1ece98-45e0-4043-8c57-69a230d76668", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "970620c0-68d7-4f42-9e1e-dbb7214dca83", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8fe56a5-9d18-4b69-9e0c-0f43695e8758", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"command\": \"\",\n \"company_id\": \"\",\n \"id\": \"\",\n \"imei\": \"\",\n \"sent_time\": \"\",\n \"status\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4e4b599b-04fe-4264-bbd5-0864b3764bc9", "name": "/commands_templates/:id", "request": { "name": "/commands_templates/:id", "description": { "content": "**Удаление шаблона команды по его id**\n\n---\n\n**Параметры:**\n\nid записи\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Ответ: 200**\n\nЕсли команда с таким id не найдена, то возвращается ошибка 422.\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2133f03b-3faf-4961-9190-9b1c096466d7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f34b998d-9e4b-414f-9172-d3b912ebc369", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "990ba4f2-6c0f-4a36-b61f-3842f6a80e43", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bf50516-04ae-4b54-b09b-f289967fb9c7", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e455d809-3f0c-4219-baa7-767e41b53a2a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92f8bb0f-949f-4dc2-9ecd-e1a5d6bb8ce5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7cc69db3-3aab-4da3-ad6a-3b4b1951ff93", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Уникальный идентификатор сущности (UUID)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6a6bf9e9-8f0d-4b7c-8eb6-4d92dbc08eba", "name": "/commands_templates/list", "request": { "name": "/commands_templates/list", "description": { "content": "**Поиск шаблонов комманд по фильтру**\n\n---\n\nАналогично запросу POST /users/list\n\n---\n\n**Параметры:**\n\nfrom - с какого найденного элемента выдавать результат.\n\ncount - максимальное число элементов.\n\nconditions - условие отбора в виде массива \\[ {\"field\":\"значение\", \"value\":\"значение\"}, {... и т.д. ...} \\]. \nВозможные значения для field - terminal_type, name\n\n---\n\n**Роль:** Оператор и выше.\n\n---\n\nПримеры:\n\n**1) Получение всех шаблонов команд дилера**\n\n```\n{}\n\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 \"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\n ```\n\n**2) Получение первых 2 шаблонов команд для navtelecom.**\n\n```\n{\n \"from\": 0,\n \"count\": 2,\n \"conditions\": [\n {\n \"field\": \"terminal_type\",\n \"value\": \"navtelecom\"\n }\n ]\n}\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b9e0e94c-199e-4795-bbbc-8458ff08da55", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b869c48d-abe3-45ae-a4fe-9fda94cdd763", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a121dedd-f173-4c4e-8b2b-3a95abe9ea98", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "538cd430-a6e5-4ca6-a1be-c55a7e7495da", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7ade848-232e-4da2-a550-c9e21bf579aa", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a98d3050-62d4-4c48-84c7-5040b80175d5", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "98f89677-5b87-4a78-9a5a-f582e9eb7707", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "commands_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Интеграторы", "description": "API по работе с Интеграторами", "item": [ { "id": "f7e1f9ca-754a-49b9-ad97-3d42c565a69b", "name": "/dealers?ids=:ids", "request": { "name": "/dealers?ids=:ids", "description": { "content": "**Поиск дилера по ID**\n\n---\n\nВозвращает массив дилеров по ID.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный интергатор.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n/dealers?ids=8ce34b65-49da-4bac-bbce-379da83e9638\n\n ```\n\n**Пример ответа:**\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\": \"7701234567\",\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "08eadcf7-64d6-40c5-ada5-46cf94cd5ffd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d6baf95a-52e0-4279-b101-4f9b8f6921ac", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3aea615b-5cc4-412e-8c89-544d77b6d461", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "954113e8-e051-476f-9867-3593d9884bec", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0abd98a-7db5-417f-b173-ee9c5603bd1f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7ea9bc2-8418-4d17-b3e0-5a5d2d7f6eb8", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8912162b-0329-4e2b-b184-a29fd052169d", "name": "/dealers", "request": { "name": "/dealers", "description": { "content": "**Создание нового дилера**\n\n---\n\n**Параметры:**\n\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\n---\n\n**Пример запроса:**\n\n```\n{\ntype': {'key': 'legal_entity'}\n\"name\": \"ООО \"ТехноЛогистика\",\n\"email\": \"support@example.com\",\n\"inn\": \"7701234567\",\n\"phone\": \"+79990000001\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"address\": \"г. Москва, ул. Складская, д. 10\",\n\"services\": \"Мониторинг транспорта\",\n\"tariff_description\": \"от 200 руб/мес за 1 объект\",\n\"telegram_bot_token\": \"6734990111:RTF6Tik\"\n}\n\n ```\n\n---\n\n**Пример ответа:**\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\": \"7701234567\",\n\"phone\": \"+79990000001\",\n\"email\": \"support@example.com\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"address\": \"Лининский проспект, 116к1, Москва, 119415\",\n\"services\": \"Мониторинг транспорта\",\n\"tariff_description\": \"от 200 руб/мес за 1 объект\",\n\"telegram_bot_token\": \"6734990111:RTF6Tik5\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b9efec68-9618-4a74-9b3e-90787488bab9", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d972833e-ddd5-49fa-b1b2-c01cf3c07e14", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13be930f-5c61-4c52-9280-9686ba508b5e", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbed17e9-a736-4a71-93cb-d82b7ddce833", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed3c4a84-0df1-4398-a79e-aed5b80e3908", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c9f8864-4ea4-46d3-a602-8aef24e0b381", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"services\": \"\",\n \"tariff_description\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fd7797d6-a8b5-4d81-b437-f457648c0bf9", "name": "/dealers/invite", "request": { "name": "/dealers/invite", "description": { "content": "**Приглашение к дилеру**\n\n---\n\n**Параметры:**\n\n'email' - приглашаемая электронная почта\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n\"email\": \"abc@mail.com\"\n}\n\n ```\n\nВозвращается OK если такоq email не зарегистрован в системе и правильный email, иначе ошибка со статусом 422& \nСсылка в писmме на почту направляет на стрaницу /register?invite_id=&email=", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d1b980bd-5e09-46d0-a0c0-c9d371c5c4ce", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e04849e4-7ca3-4cc9-ae75-81a1e95437a0", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eea227ce-4ee0-47a1-ba0e-7623e69215d2", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "440c9418-665c-4bc0-89ac-d85e0cbc33d2", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c963510a-859c-436a-b243-cbbdb7012bd5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b983a60-e024-430d-a9df-831935e32341", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "invite" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "65bca847-e8f5-4002-8c18-f667bc6b3781", "name": "/registrate_dealer", "request": { "name": "/registrate_dealer", "description": { "content": "**Регистрация дилера**\n\n---\n\n**Параметры:**\n\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---\n\n**Пример запроса:**\n\n```\n{\n\"type\": {\"key\": \"legal_entity\"}\n\"name\": \"ООО \"ТехноЛогистика\",\n\"email\": \"support@example.com\",\n\"inn\": \"7701234567\",\n\"phone\": \"+79990000001\",\n\"contact_person\": \"Иванов Иван Иванович\",\n\"capcha\": \"atxgs\"\n}\n\n ```\n\n---\n\n**Пример ответа:** \nКод 200 и пустой body в случае успеха. \nЕсли уже есть аккаунт (см. /approve) с таким email возращается код 422 и body c ошибкой session.errors.emailAlreadyRegistered \nВ случае частого вызова метода, а именно чаще чем раз в 30 секунд возвращаем код 400 и body validation.errors.often_request", "type": "text/plain" }, "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d50b8754-cc84-4c65-bd21-ecbf02b03d2f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "36169791-0966-4d49-b964-6327e6c46580", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0718a261-ee3b-4ae9-995d-9f06be1882db", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d7e83ed-4357-48b2-8b59-cc5905245267", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e16770a-4060-4dae-ae0b-83ea6007c45e", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79d028c4-d93d-4fcd-9355-eb8f7a17382a", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "registrate_dealer" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contact_person\": \"\",\n \"email\": \"\",\n \"inn\": \"\",\n \"name\": \"\",\n \"password\": \"\",\n \"phone\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd7d30be-ad73-42e0-a8bb-7e9277480e3f", "name": "/dealer/:inn", "request": { "name": "/dealer/:inn", "description": { "content": "**Получение общедоступной информации дилера по ИНН**\n\n---\n\nВозвращает объект дилера по ИНН.\n\nЕсли такой дилер не найден, то приходит ошибка с кодом 422, а в теле ответа:\n\n```\n{\"code\":4220,\"field\":\"\",\"message\":\"Не найден такой дилер\"}\n\n ```\n\n---\n\n**Пример запроса:**\n\n```\nGET /api_v1/dealer/364322233444512\n\n ```\n\n---\n\n**Пример ответа:**\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\": \"7701234567\", // ИНН\n \"address\": \"г. Москва, ул. Складская, д. 10\",//Адрес\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://api.skif.pro/api_v1//files/dealer_offer/1397418377_526c18df-d7d2-4de5-b50a-263515a374e2.pdf\" // Ссылка для загрузки оферту\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "inn", "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "849eaca6-5e77-4a33-9540-200fdfb43572", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "737f31ea-642c-4dd8-8b2a-4b954d5370a1", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd3245cb-be3b-4c85-8135-3841117eea5a", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb88685b-3350-41fe-ab5e-63a4cb341be0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e0b9f81-6e4f-44a9-bb3a-62ad63f5005b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1352a03e-67b1-4b1b-a915-e4812578cfaf", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", ":inn" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ИНН интегратора или дилера", "type": "text/plain" }, "type": "any", "value": "", "key": "inn" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c2c3281d-1943-429a-a102-404de05cb544", "name": "/dealers/:id", "request": { "name": "/dealers/:id", "description": { "content": "**Обновить данные дилера**\n\n---\n\n**Роль:** Редактор тарифа и выше.\n\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\": \"7701234567\", //ИНН\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 ```\n\nсм метод POST /dealers\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из возврата метода GET /dealers?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "506f76ae-0609-4a7d-b93c-c79f96ea0a9f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b3584a18-b1d7-4345-a9e8-e1cf21879e7e", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "380e710b-5231-4076-9b35-56f80dd4c3a4", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "920d346b-b372-4d0b-836c-3659efb078a7", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "503ac295-a8fb-42ab-9051-7f460177b538", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7926b4d8-9796-4849-9ae3-8e036c43b8b4", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"_delete\": \"\",\n \"contact_person\": \"\",\n \"email\": \"\",\n \"id\": \"\",\n \"inn\": \"\",\n \"is_default\": \"\",\n \"name\": \"\",\n \"phone\": \"\",\n \"server\": \"\",\n \"sms_tokens\": [\n \"\",\n \"\"\n ],\n \"type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9127270b-9b8a-406a-9981-1004a2e57384", "name": "/dealers/:id", "request": { "name": "/dealers/:id", "description": { "content": "**Удаление дилера по его id**\n\n---\n\nУдаляет дилера\n\n---\n\n**Параметры:**\n\nid записи\n\n---\n\n**Ответ:** 200\n\nЕсли дилер с таким id не найден возвращается ошибка 422.\n\n```\n{\n \"code\": 422,\n \"field\": \"id\",\n \"message\": \"Параметр не найден в базе\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "97fed4c7-da42-43ec-9ebc-4664440beed2", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c05e2e16-2b20-49ea-b490-780d591b2730", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "052a0c08-042e-44fc-b598-4759868a72bd", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df184a6b-d860-4219-a2e6-f85a1728589a", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "079d12ad-e0f3-4c8f-afd8-a996ac44a0c5", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0d36067-ea11-441a-a423-942f3ee803cb", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера/интегратора", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b3b21101-056d-4ca8-b574-5ae7ed350871", "name": "/dealers/:id/block_unblock", "request": { "name": "/dealers/:id/block_unblock", "description": { "content": "**Блокировка / разблокировка интегратора**\n\n---\n\nБлокирует / разблокирует интегратора.\n\n---\n\n**Параметры:**\n\nid - ID интегратора\n\nВ теле запроса отправить \"block\": true для блокировки, \"block\": false для разблокировки\n\n---\n\n``` json\n{\n \"block\": true\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b87ce1db-30b5-4634-8fa6-c3dec24b65ae", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8a68be69-19bd-4c6c-9b4e-bc72e011fc36", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc60a089-48d8-434f-8d5d-75ebd6650128", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2929b671-bd76-4e2f-926f-2e3abe952656", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "698234bc-328e-474d-9e7e-91728f70be8a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ed74f6b-c0e6-45ba-866f-ecce9aa31c5c", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", ":id", "block_unblock" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID дилера для блокировки/разблокировки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"block\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ef4c8484-d544-49df-9e83-d519466288f1", "name": "/dealers_admin_query", "request": { "name": "/dealers_admin_query", "description": { "content": "**Поиск интеграторов в админке**\n\n---\n\nПоиск выполняется по полей name, email, phone\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nНайти по названию \"Новый Скиф\"\n\n```\n{\n \"value\": \"Новый Скиф\",\n \"from\": 0,\n \"count\": 100\n}\n\n ```\n\n---\n\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\": \"7701234567\",\n \"phone\": \"+79990000001\",\n \"email\": \"support@example.com\",\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\": \"7701234567\",\n \"phone\": \"+79990000001\",\n \"email\": \"support@example.com\",\n \"contact_person\": \"Иванов Иван Иванович\",\n \"regions\": [\n \"Узбекистан\",\n \"Туркменистан\"\n ],\n \"_default\": false\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3af3736f-cfdb-4981-ab41-7389b47599ed", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b45ecffd-ffd7-4448-9eb1-d1b06a3702f2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8360fb2-d039-4ee7-a9b5-69a55b4c36af", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8695e29-bbe5-4018-9cbe-cf562958b30a", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbb979f4-2f76-4b38-956a-52c30e92c35c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8514ea5e-9bc5-44f9-8552-ffaeff31cd54", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f053f1db-3362-4472-a08f-1c5e62a2969a", "name": "/dealers/send_email/static", "request": { "name": "/dealers/send_email/static", "description": { "content": "dealer_key:\n\nlegal_entity\n\nindividual_entrepreneur", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5d469ea1-aaff-4062-a7e1-64f9e1fae195", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6f34085b-9291-4796-af14-644dbc274e9d", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08d40ba1-b171-4068-9e25-ffc3f67a204c", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64b03bdc-9bd3-482b-a0f1-1e032f2b5a4d", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f411bdd9-3a82-4c88-a1ec-28429d35bada", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ccbcc92-8c16-4d22-9dd4-c9a9e37298f6", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealers", "send_email", "static" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"captcha\": \"\",\n \"company_name\": \"\",\n \"dealer_key\": \"\",\n \"inn\": \"\",\n \"phone\": \"\",\n \"user_email\": \"\",\n \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Коробочное решение", "description": "API по работе с коробочным решением", "item": [ { "id": "dcfc5b7b-cd29-42ff-9fc2-8b8ce06a0412", "name": "Генерация партии активационных кодов", "request": { "name": "Генерация партии активационных кодов", "description": { "content": "**Создание нового кода для коробочного решения**\n\n---\n\n**Параметры:**\n\nunits: список объектов (пока обрабатывается только один объект)\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"units\": [\n {\"id\": \"c031563b-31df-43ab-b60d-7c79cd4ae500\"}\n ]\n}\n\n ```\n\n---\n\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 ```\n\nИмеет значение code - Шестизначный код и link - cсылка для QR кода. \nЕсли уже был создан код для данного объекта тогда возвращается созданная запись.", "type": "text/plain" }, "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b9cfbfe5-5196-4dbe-b491-60b25e4a681b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "42309433-5a08-41e3-9526-52c3a12145f7", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21c47da4-e9cd-4d10-bc50-4bdb5e822c87", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c075a64-0672-4547-9a84-026d03164fed", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa14f85e-b75c-4f0c-ac66-4d104e98db56", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "935297f1-cede-4f84-ab33-57fdc343f55a", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3eef817-3d09-4d87-a86c-a88b8a276642", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "80416834-5eb6-4045-ba3b-389c1a62a5f8", "name": "Активация коробки и привязка объекта к компании", "request": { "name": "Активация коробки и привязка объекта к компании", "description": { "content": "**Создание объекта по коду из коробочного решения**\n\n---\n\n**Параметры:**\n\n1) Если выбран \"Я новый пользователь SKIF.PRO\" то выполняется регистрация, при этом указать new_user=true и данные для регистрация.\n\nПример запроса:\n\n```\n{\n \"new_user\": true,\n \"code\": \"A6P29V\", // код\n \"userProviderId\": \"demo_user@skif.pro\", // 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 ```\n\n---\n\nСоздается новая компания, пользователь с указанном email, паролем и объектом. Возвращает новую сессию со статусом OK, если всё ok, иначе ошибка со статусом 422.\n\n2) Если выбран \"У меня есть учетная запись SKIF.PRO\" тогда указать код, компанию и данные объекта\n\n```\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\n---\n\n**Роль:** Читатель и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "83cd84e2-16b5-47a5-803b-672e7d04ca0a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f00a77f4-6277-4f5c-bcb2-934ad1eec1ac", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32c8db35-7d8f-4ffc-a58d-a64864bf7eaa", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8378e90-9558-4e87-a1d6-547431ac5beb", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71255422-b207-41f4-b822-af39f91a09a3", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dec276a5-7a0a-492c-9998-7268ff03198c", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fa0f4f8-0425-4038-b968-aa2ebfa918a8", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", "create_unit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"\",\n \"company\": {\n \"id\": \"\"\n },\n \"new_user\": \"\",\n \"unit_name\": \"\",\n \"unit_type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ef0cfa1d-3322-4d04-89a3-fc395e6e41e8", "name": "Обновление статуса или параметров коробки", "request": { "name": "Обновление статуса или параметров коробки", "description": { "content": "**Обновление данных кода по ID**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Параметры:** \nmessage - информационный текст\n\n```\n{\n \"message\": \"some message\"\n}\n\n ```\n\n---\n\nВозвращает обновленную запись", "type": "text/plain" }, "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "409fb10d-cfef-4247-be28-df5a8545a7d1", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "60a69c8a-f065-4188-949c-552f5a8ce811", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "188885b5-f887-48eb-8372-c59df98deb27", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a9f9758-ddb3-475c-b261-deea967659a3", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96ba6e1f-56e3-4275-8f87-7cc521b8a413", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11d187a9-979f-4b92-82ab-152584abe36b", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab282948-5e06-4a19-8d5e-3f8c8fed3998", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "boxes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID коробки", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"message\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b30825c3-c477-4ffc-85e4-20ef1443a538", "name": "Проверка кода активации коробочного решения", "request": { "name": "Проверка кода активации коробочного решения", "description": { "content": "**Получение информации о коде**\n\n---\n\n**Параметры:** \ncode - шестизначный код в коробке\n\n---\n\n**Роль:** Читатель и выше.\n\n---\n\n**Ответ:** \nused - true если уже использовался\n\n```\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "66dc7954-78bd-45be-b58b-931b402a416c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a890de9e-a900-4baa-af70-774ffa3449c6", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9164256c-df48-46dd-a2f8-70791502ea32", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db8a6fee-9875-4db9-9802-118bcd15354d", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3084683-d438-42a2-b287-a6d294fe6f31", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6293b50b-1a29-4120-86eb-8d74b7912a4d", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aedd4eec-2dab-4cc5-9808-2de96a4359d4", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "boxes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Активационный код коробки", "type": "text/plain" }, "key": "code", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Эмулятор трека", "description": "", "item": [ { "id": "280f9417-2279-4e30-aa77-1d083bdeb9b8", "name": "Запуск генерации эмуляции трека", "request": { "name": "Запуск генерации эмуляции трека", "description": { "content": "**Начать эмуляцию**\n\n---\n\n**Параметры:**\n\nterminal_type - ключ типа терминала, протокол реального и фейкого объекта должен быть таким же.\n\nimei - реальный imei, с которого нужно начинать эмуляцию. \nfake_imei - imei созданного объекта для теста. \ndate_from - Дата и время начала, в формате yyy-MM-dd HH:mm:ss в UTC \ndate_to - Дата и время окончания, в формате yyy-MM-dd HH:mm:ss в UTC\n\n---\n\n**Пример запроса:** \nGET [https://dev.skif.pro/api_v1/emulators/start?imei=862531040000003&fake_imei=33344455566777&from=2021-11-11](https://dev.skif.pro/api_v1/emulators/start?imei=862531040000003&fake_imei=33344455566777&from=2021-11-11) 10:10:00&to=2021-11-11 10:15:00", "type": "text/plain" }, "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ee28375b-eaa0-4a5c-b07a-282b14dcc5c9", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "32ced7d4-a9b1-473d-8d1c-aa9b470ea105", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67f39535-508e-4b5c-b57c-038e29461a15", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b5e624e-e81d-4ed1-90e1-fa1ba007bea3", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36f3c1a8-df9a-43ec-9d6f-74306410e74a", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67f70b19-e6b5-445b-8be7-78245b9cc072", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0849b4b5-2618-4463-bd08-d4ab422546a7", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "start" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "terminal_type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a6594a26-a2e4-4564-a6a9-6bd999f29fe6", "name": "Остановка генерации эмуляции трека", "request": { "name": "Остановка генерации эмуляции трека", "description": { "content": "**Остановить эмуляцию**\n\n---\n\nНапример: \nGET [https://dev.skif.pro/api_v1/emulators/stop?fake_imei=33344455566777](https://dev.skif.pro/api_v1/emulators/stop?fake_imei=33344455566777)", "type": "text/plain" }, "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b5fbfa3a-3b03-4c45-997e-69e3e9a84205", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "039af086-a683-45a4-89e8-fb15d295fbad", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a598ee14-5720-4d12-bc1e-e851c400224a", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca0db1ad-cb63-49db-b72a-28280c8dcdb0", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c909ef6-8b50-436e-8a0b-a47f032f31b0", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d01ab221-1311-4a7d-b4e8-1322178510db", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d681cb96-d45e-44f8-82a1-11b17788d0f1", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "stop" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "fake_imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9516b499-a76a-4731-a447-b2acd000598f", "name": "Просмотр статуса активных эмуляторов треков", "request": { "name": "Просмотр статуса активных эмуляторов треков", "description": { "content": "**Получение списка фейковых imei для которых запущен эмулятор**", "type": "text/plain" }, "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "444c75b3-c2b6-4718-8677-054b28db4b7f", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bc17180a-4e6e-46cb-a411-bbe09dd55400", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a14be5ee-0aa3-4c08-9322-8f3994ccbf88", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4acc2c3-9457-4f92-87b6-08f4451fe168", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27722667-6c06-4fdc-ad79-12895615ba0d", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ab589ec-8390-400b-ad1f-81303597f229", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f60569b0-0568-47cf-a3d6-f497b8ccaf25", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "emulators", "show" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Интеграция с ЕФИС", "description": "", "item": [ { "id": "47159585-78b4-45a6-ae64-6fa19d547e32", "name": "Получение списка объектов мониторинга для ЕФИС ЗСН", "request": { "name": "Получение списка объектов мониторинга для ЕФИС ЗСН", "description": { "content": "Возвращает перечень техники компании, зарегистрированной для интеграции с Минсельхоз РФ (ЕФИС ЗСН).", "type": "text/plain" }, "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "49f7380c-bc14-47c1-8cc1-43c9560aa244", "name": "Список объектов для интеграции с ЕФИС", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "765fd5e2-4215-4c59-b15f-4dda06e98cc3", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96453988-2872-432e-9684-ba743f835c8a", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50db5fe7-518d-497c-9414-e125f5296b75", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3863d1a8-fc0f-4816-b1a1-d5a9fd87d0bb", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d003d28-f927-41af-8a1a-48906bdfcd09", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73f429c7-a179-4c0b-ab89-55a0c543f72d", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3ac72af0-dbe7-4564-a32c-5ca10be1bc56", "name": "Получение телематических сообщений конкретного объекта для ЕФИС ЗСН", "request": { "name": "Получение телематических сообщений конкретного объекта для ЕФИС ЗСН", "description": { "content": "Экспорт телеметрии по заданному объекту за интервал времени в стандарте ЕФИС ЗСН.", "type": "text/plain" }, "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" } }, { "type": "any", "value": "", "key": "time_from", "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" } }, { "type": "any", "value": "", "key": "time_to", "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6a4ce62e-78c0-444d-a9ac-0d1f352ce6e4", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "144340ec-c585-4bab-bd4f-da0f8ad85f6c", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40d8c029-8e2f-4536-a376-8c09181a82a8", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5eee6ca-204a-41d1-9e68-65eca85ffcb9", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c47deda1-d534-49d4-b580-b1c2e9a1ccde", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "204a43c0-0f34-4fe2-b839-dd64f8691ce2", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "607c0f6d-c05b-4021-a644-f54bb418ee91", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", ":id", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (до 1000 сообщений)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID объекта мониторинга", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Начало интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала (Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4a0c5ac9-98cf-44ca-aa19-6811de51570a", "name": "Получение телематических сообщений всех объектов для ЕФИС ЗСН", "request": { "name": "Получение телематических сообщений всех объектов для ЕФИС ЗСН", "description": { "content": "Экспорт телеметрии по всем зарегистрированным машинам за интервал времени в стандарте протокола ЕФИС ЗСН.", "type": "text/plain" }, "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "type": "any", "value": "", "key": "time_from", "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" } }, { "type": "any", "value": "", "key": "time_to", "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "10c86aae-63d9-4551-9d49-725658eab0b8", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7b69e87d-cfcc-45c7-8bfe-b994b6bfa571", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56fc01bc-f95e-48a7-9630-2c2f87a31ace", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "298e6196-5cbe-438a-953a-63b1b2cd2102", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96af50a7-7307-4c73-84b2-78079aeeb7bc", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd310aa4-be1c-40c8-9048-6bc8394e4512", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2884be6c-5c41-48b3-90ca-96a9cfc0ad6f", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "efis", "units", "messages", ":time_from", ":time_to" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Индекс первого сообщения (начиная с 0)", "type": "text/plain" }, "key": "index_from", "value": "0" }, { "disabled": false, "description": { "content": "Индекс последнего сообщения (не включительно, лимит не более 1000 сообщений за запрос)", "type": "text/plain" }, "key": "index_to", "value": "1000" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Начало интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_from" }, { "disabled": false, "description": { "content": "(Required) Окончание интервала выборки (время UTC, Unix timestamp в секундах)", "type": "text/plain" }, "type": "any", "value": "", "key": "time_to" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Отзывы", "description": "", "item": [ { "id": "8859ecb7-0b50-43e6-b98b-ebf167f9983c", "name": "/feedback?ids=ids", "request": { "name": "/feedback?ids=ids", "description": { "content": "**Поиск отзыва по ID**\n\n---\n\nВозвращает массив отзывов по ID.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный отзыв.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\nGET /feedback?ids=78516162-cf8a-4056-bdaa-73ca6311a1d5\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\": \"support@example.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d3ff7d02-364a-4f1e-b4a8-b36c4ecad7f7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "48686dfa-f40f-4aac-b1d5-9602e6985892", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb6617c6-29fe-48b5-afa6-7bc0c7e31cd4", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ddde6a66-3065-40d5-ae8a-39a6a562b004", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2064e258-e387-40a5-9751-6d5d5389d1c8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b241470-fb41-433b-b2c6-d65bd1f49441", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2577cce7-a286-4f7f-a217-87bdbae1897f", "name": "/feedback", "request": { "name": "/feedback", "description": { "content": "**Создание нового отзыва**\n\n---\n\nПоля запроса JSON: \nrating - число от 1 до 5, обязательное \nmessage - текст отзыва, обязательное \ntype - тип отзыва, выбрать из GET /properties где type=feedback_type, обязательное\n\nПример запроса:\n\n```\n{\n \"rating\": 5,\n \"type\": {\"key\": \"proposal\"},\n \"message\": \"Все супер!!!\"\n}\n\n ```\n\n---\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\": \"support@example.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8b8d93fc-9186-4e26-9973-1fe95af07649", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9e0a5a1b-f144-4ac4-8c64-aee7567bd8c8", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f03b899-2c67-4d53-b445-8b3979b43a03", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8703d09d-ceba-4e53-a587-df70bf2df3c0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fdb68c4-a492-4dad-aadb-cb431bb9ec61", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89f1bd89-62a1-4b66-a482-3ca363a9a164", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "feedback" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "75abdac7-e307-4cc6-a56d-19235387ecf8", "name": "/feedback/:id", "request": { "name": "/feedback/:id", "description": { "content": "**Удаление отзыва по ID**\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса**\n\n```\nhttps://dev.skif.pro/api_v1/feedback/03d5be4f-4adb-4bd7-99b2-ab0edaaa414a\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4d4b89e3-d00c-4f30-9feb-a818de8dc39c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0154dd4f-b7f8-4e16-a329-b6417703fdb2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad9c3856-9511-4eb6-bd41-cfe4eb73f456", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f81b0420-f32c-48e5-8946-cf61ea2c5d20", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18608462-5aad-4128-a764-ca0511781965", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f676dfd-f846-4a51-8cd9-6dc0e23318bf", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID отзыва", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"message\": \"\",\n \"rating\": \"\",\n \"type\": {\n \"key\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5c8d06fb-3811-4a33-8d84-84dbd808045c", "name": "/feedback_admin_query", "request": { "name": "/feedback_admin_query", "description": { "content": "Быстрый поиск отзывов в админ панеле\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n```\n{\n \"from\": 0,\n \"count\": 10,\n \"value\": 5\n}\n\n ```\n\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\": \"support@example.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "731039b4-7a12-4eba-88be-fd1c86af7984", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "85d4864b-53c3-4f4c-845d-02bc833ebede", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97965188-baf3-46fe-9b7f-7b70d995930c", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2edee73-9220-4aa0-b123-b82bdf4b0737", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3239019-c059-49a0-8f85-8e0a012e9592", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41bb179c-5e52-40bb-bd0e-366691c3402b", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "feedback_admin_query" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6e62ccf5-9b80-420a-8d6c-73b10138de71", "name": "/feedback/list", "request": { "name": "/feedback/list", "description": { "content": "**Поиск отзывов**\n\n---\n\nfrom - начальный индекс. \ncount - количество записей. \nconditions - условия. \nfield - название поля, возможные значения: rating, type.key. \nvalue - значение.\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\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\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\": \"support@example.com\"\n },\n \"type\": {\n \"key\": \"proposal\",\n \"type\": \"feedback_type\",\n \"value\": \"Предложение\"\n },\n \"rating\": 5,\n \"message\": \"Все супер!!!\"\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3d748736-f5e4-4807-9803-5ca7f8a6196e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "da8ba4b7-6609-4c89-92d7-6beea4fe134d", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34fc28ed-eee8-4927-a5ca-de44911bd6f4", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e8f0835-7464-49b2-acf8-c0b063a6d92e", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b80c319-1d99-48cd-8902-01c97c885b1f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "129ca770-4031-481e-828b-a17e4bf2a582", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "feedback", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Ссылки доступа (Локатор)", "description": "", "item": [ { "id": "bf4216b8-9aea-46d9-be36-fdf17233f68f", "name": "Получение телеметрии объекта по ссылке Локатора (Locator)", "request": { "name": "Получение телеметрии объекта по ссылке Локатора (Locator)", "description": { "content": "Публичный интерфейс опроса состояния и координат объекта, расшаренного через временную ссылку Локатора. Авторизация по UUID ссылки.", "type": "text/plain" }, "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8fe7aa35-8088-4a8a-8857-65e538c6cfda", "name": "Текущие координаты и параметры объекта", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"unit_name\": \"\",\n \"datepoint\": \"\",\n \"address\": \"\",\n \"latitude\": \"\",\n \"longitude\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ee36e9c-3c45-4ade-895b-e6a43f6cbc75", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83114d40-70de-4cbf-a6be-c64b3fa83516", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0576a0c3-7ab8-4d66-97b0-3c357cc1e4bd", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4419b4c-effc-44c3-9203-e500e390f09d", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51fbc761-3a7d-4314-a2a9-91b255b1a45f", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a38464ec-3e02-4c33-b9ed-4a538a0cabbf", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "locator_msg" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки локатора", "type": "text/plain" }, "key": "id", "value": "" }, { "disabled": false, "description": { "content": "Начальный Unix timestamp в миллисекундах для инкрементального получения точек", "type": "text/plain" }, "key": "from_time", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fca56abe-fb1c-49ed-96af-beb273e71bab", "name": "/locators?ids=ids", "request": { "name": "/locators?ids=ids", "description": { "content": "**Поиск локаторов по ID**\n\n---\n\nВозвращает массив локаторов по ID.\n\nЕсли в параметре ids содержится только один id, то вернется НЕ массив из 1 элемента, а конкретный локатор.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\nGET /locators?ids=5bf87787-9592-41c7-a25e-500cc1234402\n\n---\n\n**Пример ответа:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "310734a1-c674-422d-80d6-880293097153", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c320ac1b-8e8d-47fc-aa6e-372da6471d56", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff7d2e63-c6de-4144-b109-0fa5903ed6a2", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "865beb55-1dc8-42dc-9bd3-dc24d8f356b0", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fdedb0ef-9129-4616-9e06-b1c9d5602e7b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b961d0d1-81ec-4363-be02-92dedb4592d2", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d7499c71-e56a-43be-9ed3-47f7340f2b47", "name": "/locators", "request": { "name": "/locators", "description": { "content": "**Cоздание ссылки для объекта, по которой пользователь без доступа к SKIF.PRO может следить за объектом на карте**\n\n---\n\nСсылка на объект формируется следующим образом: {{base_url}}/locator?id=:locator_id\n\n---\n\nПоля запроса JSON:\n\nname - Название \nunits - объекты или units_groups - группы объектов \ndate_from - время начала \ndate_to - время окончания \ndescription - Сопроводительное письмо\n\n---\n\n**Роль:** Администратор и выше.\n\n---\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\n---\n\n**Пример ответа:**\n\nstatus - определяется автоматически: запланировано, запущено или завершено \nactive - true, если отключено\n\n```\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**Для группы объектов:**\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "552a7a0e-2155-42a6-b52d-0533fb649af7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a03838dc-85b1-4312-8987-1e809eef8a54", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed764604-07f7-4770-9621-229e472c2335", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "445eabb5-42be-4f2f-9458-eac5eb2b06de", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7829248-eb0a-4022-bfa6-5d49eeeab3a8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c909a1f7-0f07-40e0-96e4-42f0f9422412", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locators" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"description\": \"\",\n \"units_group\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "61415c8f-87c1-4278-b77e-bb580c871e27", "name": "/locator?id=:id", "request": { "name": "/locator?id=:id", "description": { "content": "**Получение информации о локаторе по ID**\n\n---\n\n**Пример запроса:**\n\nGET /locator?id=ee07b417-a85f-4fc5-a37a-416f98295ab7\n\n---\n\n**Пример ответа:**\n\nВозвращаются следующие поля:\n\n- unit - информация об объекта: id, name, icon.\n- icon - ключ иконки объекта.\n- is_active - активность.\n- description - описание.\n- date_from - дата и время начала.\n\n\n``` json\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\nВозвращает запись локатора, если он найден, иначе ошибка с кодом 422:\n\n```\n{\n\"code\": 4220,\n\"message\": \"Неверная ссылка доступа\"\n}\n\n ```\n\n---\n\n**Для группы объектов:**\n\nВместо unit приходит units_group. В нем units - информация об объектах.\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "73e2e60f-0111-4115-827d-ef79f3316d77", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b4a0e7e9-4e7f-4dec-8026-0b5f311c0b7e", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "73015c10-5c73-470c-8b37-2388f133aba4", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4fbbcb5-6a54-4a79-be73-9664c370f806", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30c3c683-9639-48a3-a507-a414305985a6", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "582aef17-2b87-4ba0-af73-bfff86eaafd3", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locator" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fc8c7e7f-6b4f-475b-903a-19e84df2c4a0", "name": "/locators/:id", "request": { "name": "/locators/:id", "description": { "content": "**Обновление данных локатора**\n\n---\n\n**Параметры:**\n\nсм метод POST /locators\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:**\n\nАналогичен одному объекту из ответа метода GET /locators?ids=:id", "type": "text/plain" }, "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "8954ab09-2f68-4426-8fb3-08dbdb32867d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9b6ab61d-31ad-4ef8-a2c6-c306c4888b4e", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d7186d0-893b-407f-bf15-bad2038f01b6", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09876651-1c9d-4bf7-b8a2-dabaef47c7ce", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50b896cd-4e07-446e-a855-0470607a1a50", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1bf018d-00d4-461a-87ef-1217887d6619", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_active\": \"\",\n \"company_id\": \"\",\n \"date_from\": \"\",\n \"date_to\": \"\",\n \"id\": \"\",\n \"is_active\": \"\",\n \"status\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"units\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d3cd630b-7974-4083-a943-63b646122c42", "name": "/locators/:id", "request": { "name": "/locators/:id", "description": { "content": "**Удаление локатора по ID**\n\n---\n\n**Роль:** Администратор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "79276108-0f15-4c99-afe5-d965b2f80a4b", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1a8d8fd8-aba6-4eaa-8c05-7babd95fa9be", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30930d2b-da20-41d1-b26f-f62a33d44a46", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b6b167b-2f6c-45b4-897c-9db74d121269", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a47832a-6a9b-4d40-a05a-3fa9e5de2b55", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "168063b2-4d1c-443a-a853-a747d38517b8", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locators", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID ссылки доступа (локатора)", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"count\": \"\",\n \"from\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd973c9c-b7f0-41d5-b992-f1c5ac21705f", "name": "/locators/list", "request": { "name": "/locators/list", "description": { "content": "**Поиск локаторов**\n\n---\n\nfrom - начальный индекс. \ncount - количество записей. \nconditions - условия \nfield - название поля, возвожные значения: unit.id, date_from, date_to. \nvalue - значение\n\n---\n\n**Роль:** Читатель и выше.\n\n---\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bb0a06bf-0580-47ed-9a09-515a255cae9c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "58f8516f-48cb-40c3-99fa-9246ec1e30c0", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a32ae7c9-f07f-462b-a7b4-d203f5f25000", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc926fbd-44fa-4dfd-8f8d-1414194816ea", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36a25f90-79b7-4ac5-8bf8-aecaf25c72c8", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b711531f-c6c7-45db-a130-5f74ba066b20", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "locators", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ],\n \"count\": \"\",\n \"from\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Импорт из Wialon", "description": "", "item": [ { "id": "7c9b4632-0c4b-432d-b4d0-e72ecd67209c", "name": "Анализ терминалов и протоколов из файлов Wialon", "request": { "name": "Анализ терминалов и протоколов из файлов Wialon", "description": { "content": "Предварительный анализ экспортированных из Wialon объектов для определения типов терминалов и портов подключения.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a99df5b6-1dc4-4b9c-8b30-475074b78c72", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "29a2cc50-6a68-49b5-b979-5699579b7045", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed769288-6ec9-4cd5-87e3-88e9d7cbc776", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02e3fbd6-f016-4599-b2fd-9269922cd8cb", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8e368dc-d5bf-4a1b-8747-cb3b84239c06", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c70aed2-6120-4a33-ad62-b5d89a3ad587", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b24e5762-c9f7-4a2c-b96a-dfd3d07c4e46", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_terminals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8a8627c2-7990-46d9-b078-43c3f201e8a1", "name": "Анализ параметров и датчиков объектов Wialon", "request": { "name": "Анализ параметров и датчиков объектов Wialon", "description": { "content": "Парсинг и сопоставление датчиков и тарировочных таблиц топлива перед импортом в систему SKIF.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f629e5fe-52f8-48a8-9937-86a00e3fb25d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6d9f5c19-7978-4265-98de-5660959bef7a", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a455e9ce-0de9-4597-8bfa-eb81957f3b36", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37626a20-c0be-4efa-95d6-82e9b6baf913", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14cd045f-46ec-4528-b8cf-0083abbc9a98", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25b91d1d-0dd0-4990-b28a-aac8c6d05d4f", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4df58ace-e282-40f4-b5d4-9797d2d70d7d", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "analyze_params" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals\": [\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "edf70fbe-b34c-4d56-aec5-813f39342b4a", "name": "Пакетное создание объектов мониторинга из данных Wialon", "request": { "name": "Пакетное создание объектов мониторинга из данных Wialon", "description": { "content": "Создание ТС, терминалов и датчиков на основе разобранного пакета Wialon.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f5a5c24d-d31b-45de-a006-cfc2449072ae", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0c775f97-cfad-49b2-878b-4afcfab065b5", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2edb24a6-a1c1-4a99-9881-eaec6a936d1c", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffcd78ea-0fea-4a20-8ff1-b256d119b610", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "382bbfec-d9cb-4773-9929-3e54d96cafa5", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b0ea37c-d5d3-4d89-a2c6-8d18a628b810", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "091b49c2-6f95-4070-87af-7e32d144a04e", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"terminals_params\": [\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n },\n {\n \"params\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"terminal_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1efb226b-319e-41c1-89a0-60806d4e8007", "name": "Импорт сервисных интервалов и техобслуживания из Wialon", "request": { "name": "Импорт сервисных интервалов и техобслуживания из Wialon", "description": { "content": "Перенос интервалов ТО, моточасов и пробегов из Wialon в сервисные регламенты SKIF.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "aa5a8c5f-ce2d-4eef-bc63-d7d784c931f6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e122440c-2480-4fab-821c-38b6b62fe97f", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36930184-dec6-4618-b39f-ee2c5d6dc0ea", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7479f36b-6b7c-4550-907d-6fa8a292fefd", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cf3ae1a-aa8c-474b-bae2-45abe9db3f15", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61598883-2a63-4e37-bf52-40ad41fc5b0b", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfc8e720-fa75-4241-87b5-2749829c9abe", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "units", "add_services" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a2513b45-42b5-44d4-a13a-4607aed64638", "name": "Импорт геозон из файла Wialon/KML в активную компанию", "request": { "name": "Импорт геозон из файла Wialon/KML в активную компанию", "description": { "content": "Загрузка и пакетный импорт геозон в контексте текущей активной компании пользователя.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "72a24f18-3625-4294-8b61-fe8b84c947f0", "name": "Результат импорта геозон", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": \"\",\n \"count\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6190a264-cb89-432b-b91b-e84227933d14", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e6dfb5b-ac60-40fa-8644-af33b26c954d", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d193249-d9b6-4918-916d-1b4c25d6812e", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0658e2b4-a956-40d2-9e13-212880f68840", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95dde5e8-85da-4281-b0ed-5f5249a40d9c", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "822fa9de-bcc8-4830-ae0a-0764b7eb64fe", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "companies_ids", "value": "", "type": "text" }, { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1aba6085-85c3-4b06-a77a-528457bf52d0", "name": "Импорт геозон компании из файла Wialon/KML", "request": { "name": "Импорт геозон компании из файла Wialon/KML", "description": { "content": "Загрузка и парсинг файла геозон формата Wialon (WLP/KML) с созданием геозон в указанной компании.", "type": "text/plain" }, "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "add9cebe-e764-4e3a-b8ed-f918e0e2663e", "name": "Результат импорта геозон", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": \"\",\n \"count\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0eb209eb-721b-4e91-8e09-fc3acfe446f3", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c052126c-e4b5-4cbe-ba6d-e67c08f2d377", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c1bdd95-a479-4878-b8ee-7aba38e24fd5", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4d7dd29-fcd7-4289-bb96-409f96626c52", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55cc34b8-7f90-4d67-a1c6-6594101f4b45", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5029c45-cbe6-45a8-a198-0b6eec8763b2", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "loadwln", ":company_id", "geozones", "create" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID целевой компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Удаление данных", "description": "", "item": [ { "id": "7f511478-a912-4f3c-90c9-3c701231df2c", "name": "Создание задачи удаления интервала телеметрии", "request": { "name": "Создание задачи удаления интервала телеметрии", "description": { "content": "**Удаление данных для объекта в диапазоне дат**\n\n---\n\n**Параметры:**\n\n\"start_date\": Начала интервала, в формате yyyy-MM-dd HH:mm:ss \n\"finish_date\": Конец интервала, в формате yyyy-MM-dd HH:mm:ss \n\"unit\": Объект, достаточно указать ID.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e05c11c3-8c93-4c67-8ccb-8bfaf0c73401", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c31003a4-af51-4206-af9b-8d182c0bf047", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc68f67f-3ee6-4b3c-8172-8ba75a38f179", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0973d655-7e2e-44b4-88c5-8e40e3142951", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53e95646-96ac-41e6-80fd-3dd0a9fe40a8", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcc57a1a-ab2b-4419-a0f2-7587037d17b3", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c211c902-2905-4701-b3bd-6893fe74599e", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"finish_date\": \"\",\n \"start_date\": \"\",\n \"unit\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "62728716-f41d-482a-b118-27ae9b3fd7a2", "name": "Отмена и удаление задачи очистки данных", "request": { "name": "Отмена и удаление задачи очистки данных", "description": { "content": "**Отмена удаления данных для объекта в диапазоне дат**\n\n---\n\n**Параметры:** \nid - ID записи\n\n---\n\n**Пример запроса:** \nDELETE /data_deletions/62cc8ce7-da3d-4e1e-8086-4a8e165fcd1f", "type": "text/plain" }, "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2c7eaea7-73fc-458b-ab83-d67c294d33cd", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e8820235-0037-4348-ab33-1768b907ad5b", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1a9a703-0d88-4160-b81d-fe4d270b294f", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5cc6dca2-4cb9-47be-89ca-02f66beac17c", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cfeb439-87ae-478d-9657-9c6b4e3aaad2", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17709190-dd67-4976-8b1d-635e55a3de70", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1dceceaf-611a-4079-b54b-cee701288fd5", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID задачи удаления", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d203b874-9795-4d7c-b4d7-37b590562e0f", "name": "Реестр задач удаления телеметрических данных", "request": { "name": "Реестр задач удаления телеметрических данных", "description": { "content": "**Получение списка удаленных интервалов**\n\n---\n\nВ conditions можно указать фильтры:\n\n- unit.id - ID объекта\n\n- start_date - Дата, от\n\n- finish_date - Дата, до\n\n\n---\n\n**Роль:** Читатель и выше.\n\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\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\": \"862531040000003\",\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\": \"862531040000003\",\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\": \"862531040000003\",\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\": \"862531040000003\",\n \"start_date\": \"2022-08-23 02:00:00\",\n \"finish_date\": \"2022-08-24 22:00:00\"\n }\n ]\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6b71ee8d-205d-4efb-b1bf-979a5fd0de9a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1dc368ac-3d42-4da3-8012-0bbe60924c55", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00c89d28-02d7-4327-a4ca-7f1c2f3cc16c", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e0b2af0-387a-460d-8c28-8b2eb5f0de36", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "613c0a7d-ccfa-43f8-a637-9c56a4d4e826", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "185fac00-3cd7-436d-9f65-484c6a42dba5", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8683ddf5-432c-4e94-af6d-389d113adac1", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "data_deletions", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"conditions\": [\n {\n \"field\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Видео", "description": "", "item": [ { "id": "9997c0d5-16f0-4317-b8b7-eb1b4e0123a8", "name": "Запрос видеопотока с видеорегистратора ТС", "request": { "name": "Запрос видеопотока с видеорегистратора ТС", "description": { "content": "**Запрос на получение видео-потоков для регистратора, связанного с объектом**\n\n---\n\n**Параметры:**\n\nid объекта.\n\nСейчас обрабатывается только первый объект в списке.\n\n```\n{\n \"units\": [\n {\n \"id\": \"d0dd6178-fd10-4f49-8627-a386ac35b8c3\"\n }\n ]\n}\n\n ```\n\nВ доп полях передаваемых объектов должны быть прописаны поля со соледующими ключами:\n\n1\\. Видео устройство - video_device_name \n2\\. ID-видео устройства - video_device_id \n3\\. Камеры (потоки) - video_cameras (числа через запятую)\n\n---\n\n**Ответ:**\n\nstream - код потока\n\nurl - url потока\n\n```\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Возможные виды ошибок:\n\n```\n{\n \"code\": 5000,\n \"message\": \"Внутренняя ошибка сервера\"\n}\n\n ```\n\nгде code - внутренний код ошибки.\n\nmessage - текст, который можно отобразить пользователю.", "type": "text/plain" }, "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f74cb06c-1093-4b09-aa78-3bd4b31dff56", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e2925960-c2d0-422a-956b-d253c068130b", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1abfebe-1f83-498e-81a8-cad7095428a5", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ccf8d9e7-5fef-4456-b4c8-37a1a35fdc61", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fabe7713-d097-4506-a84d-c5ec54848cf5", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b04aa4f-6519-4f73-875e-713a73473a27", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "712a89da-7ebc-4413-a49d-3f99157db589", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "videos" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Группы доступа", "description": "", "item": [ { "id": "26768866-1316-435b-88cd-4ee636953c17", "name": "/units_groups_access?units_group_id=units_group_id", "request": { "name": "/units_groups_access?units_group_id=units_group_id", "description": { "content": "**Получение списка пользователей, имеющих доступ к группе объектов**\n\n---\n\n**Параметры запроса:**\n\nunits_group_id - ID группы\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:**\n\nПриходит JSON массив. Каждый элемент имеет:\n\n- id - ID действия\n\n- key - ключ действия\n\n- name - название действия\n\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e7de9175-c8a7-46e9-81ca-363856115e8d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1da9d304-f9fc-4bc8-a1b1-8d328989404b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea725305-d798-4bfe-887f-940574b2a196", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10c51a59-6d43-41a4-b70f-b036c7c4a9e5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41c96086-6185-42b6-9d33-b7eab37136cf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5245bcc-03ae-4c49-b7bb-097a117c9f78", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3840af33-79a3-4b6c-ade1-8062b4da8506", "name": "/units_groups_access", "request": { "name": "/units_groups_access", "description": { "content": "**Создание новой группы с доступом**\n\n---\n\nname - имя группы\n\nunits - объекты\n\nusers - пользователи\n\n---\n\n**Роль:** Администратор и выше.\n\n---\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\nВозвращает созданную группу. Указанные пользователи будут иметь доступ к этой группе", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bb475cb1-93a7-4b76-a1a2-9c8ebd0bbe61", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "637a49b1-28db-488f-bdc9-ec938942e6c9", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1cfb4dc-ea81-4447-bc5e-d279eecccfe6", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae15331c-9bc3-4320-a416-ff70d56940ef", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7862368b-0fc3-48e8-bb5f-1477dc66a014", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bb092c5-9ae8-4f84-a339-6e3157b5d5e7", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "cookie", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"users\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7533f7c1-4a96-4c2a-ad5f-ffcd6a6636a0", "name": "/units_groups_access/:company_id?units_group_id=units_group_id", "request": { "name": "/units_groups_access/:company_id?units_group_id=units_group_id", "description": { "content": "**Получение списка пользователей, имеющих доступ к группе объектов**\n\n---\n\n**Параметры запроса:**\n\ncompany_id - ID компании\n\nunits_group_id - ID группы\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:**\n\nПриходит JSON массив. Каждый элемент имеет:\n\n- id - ID действия\n\n- key - ключ действия\n\n- name - название действия\n\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "83b5035a-e2bd-44cc-8bd4-60e71119a970", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "464bf263-5f34-45ef-aaa1-cf925ed55c25", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e70557d5-5d1f-44ea-9a27-e7e091c32f9b", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49c4c42f-0e61-4d1c-9f9e-0b314cdaef8e", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44c9eb9a-5605-4b0b-b200-d4e8287c692d", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15aa7592-40c3-4bdb-8ffb-026ed891a829", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "ID группы", "type": "text/plain" }, "key": "units_group_id", "value": "" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c220db08-b431-4e46-9a6c-207b3700c3a0", "name": "/units_groups_access/:units_group_id", "request": { "name": "/units_groups_access/:units_group_id", "description": { "content": "**Обновление списка пользователей, имеющих доступ к группе объектов**\n\n---\n\n**Параметры запроса:**\n\nunits_group_id - ID группы\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:**\n\nПриходит JSON массив. Каждый элемент имеет: actions и user.\n\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 ```\n\nЗапрос и ответ имеет структура такой же как GET /units_groups_access?units_group_id=units_group_id", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "units_group_id", "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "89e88483-83f5-4688-b649-5406eb02e089", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1f757743-c454-422f-bf71-4b48ab4f747b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d67c985-82be-4ff0-92bb-462a8d049d46", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc3a847a-156d-4884-8e6b-8da851c924b7", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9105616b-0943-4f0a-8a3c-eb7bc1bd0cdf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf330e9c-5e2d-479f-b580-ec47821a007a", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ac262b36-5f7a-4364-9685-2977be871556", "name": "/units_groups_access/:company_id/:units_group_id", "request": { "name": "/units_groups_access/:company_id/:units_group_id", "description": { "content": "**Обновление списка пользователей, имеющих доступ к группе объектов**\n\n---\n\n**Параметры запроса:**\n\ncompany_id - ID компании\n\nunits_group_id - ID группы\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Ответ:**\n\nПриходит JSON массив. Каждый элемент имеет: actions и user\n\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 ```\n\nЗапрос и ответ имеют такую же структуру, как GET /units_groups_access?units_group_id=units_group_id", "type": "text/plain" }, "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "company_id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } }, { "type": "any", "value": "", "key": "units_group_id", "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c713244e-a82f-4606-ba81-b68cfd6fe284", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e5b600c2-31cd-4855-8738-28e001654423", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21f05d3f-821b-4b60-a382-cf05f882273f", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dae08b8e-c4c3-4422-a08b-e31b7577dd24", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03b6c695-7372-41ac-b261-c1e41ad88dd4", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed2c0671-759c-4e9e-bf25-bbc53066bc63", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "units_groups_access", ":company_id", ":units_group_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID группы объектов", "type": "text/plain" }, "type": "any", "value": "", "key": "units_group_id" }, { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "company_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n },\n {\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"available_actions_keys\": [\n \"\",\n \"\"\n ],\n \"user\": {\n \"id\": \"\",\n \"name\": \"\",\n \"role\": {\n \"id\": \"\",\n \"key\": \"\",\n \"value\": \"\"\n }\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Другое", "description": "", "item": [ { "id": "97d66f78-870e-4919-9c86-45376f7803a6", "name": "Отправка мобильного Push-уведомления (FCM)", "request": { "name": "Отправка мобильного Push-уведомления (FCM)", "description": { "content": "**Отправка push-уведомлений пользователям компаний дилера**\n\n---\n\n**Параметры:**\n\ntitle - тема\n\nbody - текст уведомления\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n1. Отправка всем пользователям компаний дилера\n\n\n``` json\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\"\n}\n\n ```\n\n2\\. Отправка всем пользователям конкретной компании, в поле company_id указать ID компании\n\n``` json\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\",\n \"company_id\": \"5fb53281-23b1-42ac-a336-315edcd0a30e\"\n}\n\n ```\n\n3\\. Отправка конкретному пользователю, указать в поле user_id ID пользователя\n\n``` json\n{\n \"title\": \"Тест\",\n \"body\": \"Проверка пуш\",\n \"user_id\": \"1c74912a-ebcd-47e0-8828-8bcfcc7ef59d\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5bc2b742-ed0e-4566-861f-22a89f7d129c", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e60c1d3f-c529-483f-9636-e1aca78e31e8", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68e16d39-38d0-4808-b481-ac1f6b9dc189", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "536b9aae-d801-42ca-8eac-ecd9b6fe2030", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fd1f78b-b385-4028-a0bf-15ee2bfe822f", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9121c265-eb5c-4df9-bd25-f90c54e5d87f", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99024aef-951c-438f-b4be-4d2df7cab33a", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "send_push" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"body\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "39ecd934-f975-4367-8ff3-8066c7cd233c", "name": "Получение настроек брендирования (White-label)", "request": { "name": "Получение настроек брендирования (White-label)", "description": { "content": "**Получение брендинга по текущему домену**\n\n---\n\nПоля, необходимые для фронта:\n\n1. Название \\[Текст\\]: Название компании интегратора. Это название будет заменять название “SKIF.PRO” в системе. - title\n\n2. Логотип \\[Изображение\\]: Логотип компании интегратора, данный логотип будет отображаться в интерфейсе системы. - logo\n\n3. Ссылка на сайт интегратора \\[Текст\\]: Гиперссылка (интегратор может дать ссылку на свой сайт). Ссылка срабатывает при клике на Логотип или Название (в email письмах). Необязательные данные. - site\n\n4. Обложка для страницы входа \\[Изображение\\]: Изображение которое отображается на странице входа (логина). Необязательные данные. Если изображение от интегратора нет, то используется стандартное обложка (важно: не обложка SKIF.PRO, а стандартная обложка).- background\n\n5. Контакты \\[Текст\\]: Любая текстовая информация от интегратора, предполагается что это будет контактная информация техподдержки (не более 320 символов) - contacts\n\n\nДля получение файлов логотипа и Обложки для страницы входа вызывать /api_v1/<значение поля logo> и /api_v1/<значение поля background>", "type": "text/plain" }, "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "06f65596-1185-4623-9cfa-90cc442bda24", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "62e65f90-fb44-4a84-a2a3-cb7c7486abe7", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8936a465-89a8-4e3f-b2a3-f32c0de651da", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55320568-b027-4368-b202-1f7ff10b3d60", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e80d2830-19ee-4aa4-bb02-10d08260f3dd", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99b86ffd-6eef-410e-9a77-24d56fb77fc2", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2170f3fb-7cc0-41d9-92fb-e8a3ff7537c9", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "branding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "198f4b7a-f113-4b1b-99c5-21ed6987d4e4", "name": "Получение списка распознанных колонок и параметров терминала", "request": { "name": "Получение списка распознанных колонок и параметров терминала", "description": { "content": "Возвращает перечень доступных параметров телеметрии для связки типа терминала и IMEI объекта.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "terminal_type", "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" } }, { "type": "any", "value": "", "key": "imei", "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "319b6072-935a-478a-8dd3-88f38e970fe3", "name": "Список параметров телеметрии терминала", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"key\": \"\",\n \"name\": \"\"\n },\n {\n \"key\": \"\",\n \"name\": \"\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5f9253a-5b27-434c-9dcb-d35225768e1a", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "552dc56e-1e1e-49ef-97c1-8b3037db2cb0", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4d3640c-3b3a-4285-aca7-583b400c66e7", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e6462f1-20ba-4551-84a5-0484c882afe8", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5fe9bbe-1402-494a-934e-73f999316e62", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7faf17ed-7bfe-4a69-83b2-04357fddaf25", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ протокола терминала (navtelecom, arnavi, teltonika и др.)", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала (15 цифр)", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1a76b12a-9179-490b-a14a-f593f4d4eea4", "name": "Сохранение настроек колонок параметров терминала", "request": { "name": "Сохранение настроек колонок параметров терминала", "description": { "content": "Конфигурация соответствия телематических параметров и датчиков для указанного типа терминала и IMEI.", "type": "text/plain" }, "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "terminal_type", "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" } }, { "type": "any", "value": "", "key": "imei", "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "493e1716-980c-4e9e-8583-24b96d49d4a7", "name": "Настройки успешно сохранены", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a984072-7dc0-48ee-9ea5-1d067504d42d", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91522ce2-7f35-4736-8065-93bdf8993750", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "584caf8f-8142-4235-9e51-cece3b13ed9c", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24162acf-30ee-4a09-a754-6792ffe44978", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6d197d7-5c04-4689-88b0-33f525a8241b", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "98007d96-38da-4a44-a716-5e98b1d8e180", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "terminals", "columns", ":terminal_type", ":imei" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Ключ типа терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "terminal_type" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "type": "any", "value": "", "key": "imei" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Роли", "description": "Работа с ролями", "item": [ { "id": "843782d9-dc83-4e67-a33d-07338e27983e", "name": "/roles", "request": { "name": "/roles", "description": { "content": "**Получение всех ролей**\n\n---\n\nСтруктура роли :\n\n- id - uuid, идентификатор роли.\n\n- key - string, ключ роли.\n\n- value - string, название роли\n\n- is_default - boolean, true, если роль по умолчанию для всех компаний, иначе только для текущий компании.\n\n- actions - массив действий.\n\n\nЭлементы действий имеют такую структуру:\n\n- id - uuid, идентификатор действия.\n\n- key - string, ключ действия.\n\n- name - string, название действия.\n\n\n---\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "aaa938d1-bb36-4aaf-83a2-c4d02dd5c142", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "748af49f-8b50-455b-929e-de9e103ae6be", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79be489a-c246-47ed-bbad-32b84a05d42b", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "492955b5-2852-48d7-bb97-f7d4488b35e5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80e02fc0-7105-460a-b949-cd21f8fe9475", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c60cf2e8-ef4a-4ae8-9249-a6e86bde5e32", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "ids", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "58125005-15ae-4beb-a915-3b496861edb0", "name": "/roles", "request": { "name": "/roles", "description": { "content": "**Создание новой роли в компании**\n\n---\n\n**Структура запроса:**\n\n- value - string, название новой роли.\n\n- actions - массив действий, выбранный из списка действий базовой роли.\n\n\nДля создания в админ панеле, необходимо указать ID компании в поле company_id\n\n---\n\n**Роль:** Администратор и выше.\n\n---\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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "60ecc8b5-d1ad-43f9-bd43-862b88d1cdfa", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fcc461ac-7f08-43ec-a82c-ab09a1158973", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13463339-5f2d-4878-9247-f120671b6517", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd79c4f7-cd7b-4ad8-998c-e1c2076e6493", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c241bfa0-c86c-4b26-9228-7b4af54c277a", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ff9b6e0-13ff-4abf-9680-60fc4914cc83", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"key\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b173b68-4e39-41cd-a351-90d8653b776f", "name": "/actions", "request": { "name": "/actions", "description": { "content": "**Получение всех действий**\n\n---\n\nВозвращается массив действий.\n\nЭлементы действий имеют такую структуру:\n\n- id - uuid, идентификатор действия.\n\n- key - string, ключ действия.\n\n- name - string, название действия.\n\n\n---\n\n**Роль:** Администратор и выше.\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "5856356f-ee87-43d2-b28a-61a7271da76a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8f144b58-4ff2-4fb4-87f6-5e0284893daf", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30e0c25b-cce7-496d-8cf9-b8b2910cd1ab", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cdde09b-1157-4e99-9df8-bc0ec4bd9699", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f90f760e-e84c-4e30-8abd-03bca320152c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0597ef93-087a-4f31-b923-4d4433c16828", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "actions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dc54e166-903f-415e-8833-611052b81ce0", "name": "/roles/:id", "request": { "name": "/roles/:id", "description": { "content": "**Обновление роли в компании**\n\n---\n\n**Параметр запроса:**\n\nID роли\n\nСтруктура тела запроса JSON, как при создании POST /roles\n\n---\n\n**Роль:** Администратор и выше.\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 \"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\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "c37f7e0a-2de8-45fb-845c-4b920dcc2200", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "af4f5974-d7b2-47fa-8a22-51137faa47db", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54bd5fe6-9b12-4d75-b9a9-a32acaa87617", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d46b4223-2282-4777-8438-bd7c25b37ab8", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a16f5c21-0205-47a1-a1a7-554cd029d85c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5cc29936-52f8-49e1-95f7-fa52a68175fb", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"_default\": \"\",\n \"actions\": [\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n },\n {\n \"_delete\": \"\",\n \"_unit_action\": \"\",\n \"id\": \"\",\n \"is_unit_action\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"role_key\": \"\"\n }\n ],\n \"company_id\": \"\",\n \"id\": \"\",\n \"is_default\": \"\",\n \"key\": \"\",\n \"users_count\": \"\",\n \"value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8aca1fc2-5440-4bf9-9a0a-dd84c076b24c", "name": "/roles/:id", "request": { "name": "/roles/:id", "description": { "content": "**Обновление роли в компании**\n\n---\n\nПараметр запроса - ID роли\n\nВ теле запроса необходимо указать роль для замены ролей пользователей в поле replace_role, если есть пользователи для этой роли. Достаточно указать ID роли.\n\n---\n\n**Роль:** Администратор и выше.\n\n---\n\n**Пример запроса:**\n\n[https://api.skif.pro/api_v1/roles/1f21bbe2-797f-4d16-9667-70211ab3412c](https://api.skif.pro/api_v1/roles/1f21bbe2-797f-4d16-9667-70211ab3412c)\n\n```\n{\n \"replace_role\": {\n \"id\": \"3476edf5-d2c9-405c-9dfb-29618c47c807\"\n }\n}\n\n ```\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 \"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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f6bfb23c-15c9-4aa8-9045-4995b7bf829e", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6f83a837-516f-488f-9b53-a6625592f3ac", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebe894da-df54-4867-a63d-d809baac0c96", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c060be9d-dfc6-44fc-9b9b-7f86c81190db", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69501663-3f2f-439c-814a-ab9e9be10755", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d1cd2f7-612e-4465-86c9-cbb3f77a7bb0", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "roles", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID роли", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"replace_role\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Новости", "description": "", "item": [ { "id": "34de25ed-84ef-440b-9bb9-673f4bf14adc", "name": "/news", "request": { "name": "/news", "description": { "content": "Добавление новостей интегратором для своих компаний\n\n---\n\nПоля:\n\ntitle - загаловок новости, текстовое.\n\nmessage - текст новости, текстовое.\n\ncompanies - массив выбранных компаний, достаточно указать id.\n\nroles - массив выбранных ролей, достаточно указать key.\n\nsend_types - массив выбранных способов доставки, достаточно указать key. Выбираются из properties, где type=send_types\n\n---\n\n**Роль:** Супервизор и выше.\n\n---\n\n**Пример запроса:**\n\n``` json\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**Ответ:**\n\n``` json\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**Пример ошибки:**\n\n``` json\n{\n \"code\": 4220,\n \"field\": \"valid_to\",\n \"message\": \"Актуально до должно быть позже текущего времени\"\n}\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "41da1ce0-1138-43ed-8fd3-508fbe55f8b7", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0e98ff66-5fd1-4903-83bc-5b500944667c", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "065e877f-4f06-460f-a93b-21f29c118044", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa53d713-f56f-4be7-bffa-972db8dbb7b3", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2f84b95-d643-47ea-9881-a3995d89b6cc", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00980c12-f92d-44af-9492-bea7c58df329", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "news" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"message\": \"\",\n \"roles\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"send_types\": [\n {\n \"key\": \"\"\n },\n {\n \"key\": \"\"\n }\n ],\n \"title\": \"\",\n \"valid_to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ac6fe6c0-48fc-45db-88fa-c5c77860e96e", "name": "/news/list", "request": { "name": "/news/list", "description": { "content": "**Получение новостей по страницам**\n\n---\n\nФильтр отправляется в теле запроса:\n\noffset - номер первой строки, начинается с нуля.\n\nmax - максимальные количество строк на странице.\n\nsortField - поле, по которoму нужно делать сортировку (используются следующие поля - created, valid_to, title).\n\nsortDesc - тип сортировки поля, если true, тогда по убыванию.\n\n---\n\n**Пример запроса:**\n\n``` json\n{\n \"offset\": 0,\n \"max\": 100,\n \"sortField\": \"created\",\n \"sortDesc\": true\n}\n\n ```\n\n---\n\n**Пример ответа:**\n\nВозвращаются новости на указанной странице запроса.\n\nmax_rows - количество всех записей.\n\nlist - сами записи. Cтруктура записей, как в ответе на запрос POST /news, дополнительно приходит поле is_read - признак прочитанности и created - дата и время создания.\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9f377563-595e-46e4-a508-265f18a3079b", "name": "Список системных новостей компании", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c735d17-83fb-4159-9f19-f9fa309b3b8e", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "732b6ff5-9d4c-4399-9ff8-85c42aa77e56", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce63d08c-1641-4324-8f91-83891b20caeb", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf1b4eb5-f7c1-4722-98f2-9407b8bb2be2", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bf23941-7bd9-4049-92b0-1c6d62e3c627", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "news", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"offset\": \"\",\n \"max\": \"\",\n \"sortField\": \"\",\n \"sortDesc\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b3b9c8f-1f8d-4651-ab3b-4333474b7adb", "name": "/news/:id/mark_as_read", "request": { "name": "/news/:id/mark_as_read", "description": { "content": "**Отметить новость, как прочитанную**\n\n---\n\n**Параметры запроса:**\n\nid - идентификатор новости.\n\n---\n\n**Пример запроса:**\n\n``` json\nPUT https://api.skif.pro/api_v1/news/6a742db8-4c06-44bf-9f69-43a8f0f0071d/mark_as_read\n\n ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "6bcb4a56-f5ac-4764-b02d-98d87bc2128d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "33a89673-e680-42ae-9de5-c78476cb9733", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "444dc851-9e35-4875-81bf-5477b851e557", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4434e07-5c57-45e4-be71-c810a8448a4b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e68b645d-4a04-44e7-9261-867d831858d7", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcad19f5-30e2-419b-abc4-31c4127f83fc", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "news", ":id", "mark_as_read" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID новости для отметки о прочтении", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Датчики", "description": "", "item": [ { "id": "b60b1ca3-be69-43ec-b79c-229953a6eaba", "name": "/units/sensors/add_to_units", "request": { "name": "/units/sensors/add_to_units", "description": { "content": "**Импортирование датчиков**\n\n---\n\nПоля:\n\nunits - выбранные объекты.\n\nsensors - выбранные датчики.\n\nsensor_copy_type - тип импортирования датчиков. Можно получить возможные типы импортирования датчиков из dictionary, где type = sensor_copy_type.\n\n---\n\n**Роль:** Редактор и выше.", "type": "text/plain" }, "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1748dd01-39c5-4a64-8d6e-12123b4079f5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ea6849c5-8353-451d-b08e-637d217787c8", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17681546-255a-408f-8204-145dc6794afa", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04480567-26c8-4d3e-806b-b131c3c01001", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b66f03b0-102c-4a58-b942-b3b7d4eda565", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ea4ad52-1abe-4f60-baa9-6c5b455dff4a", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a99d4da-7906-4204-b636-26f1f8dabb52", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "units", "sensors", "add_to_units" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"sensor_copy_type\": {\n \"key\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n \"sensors\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"units\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Счета", "description": "", "item": [ { "id": "0b034fed-a125-456a-a727-7c3ae4447e3c", "name": "Получение списка выставленных счетов", "request": { "name": "Получение списка выставленных счетов", "description": { "content": "**Запрос для получения счетов**\n\n---\n\nДля интеграторов для сотрудников с ролью Редактор тарифа, по которому выдаются все счета, выставленные ранее с колонками Интегратор, Дата, Сумма и ссылка на файл pdf.\n\nДля сотрудника с ролью Контролер доступны для получения все счета, по всем Интеграторам.\n\nДля фильтрации по дате в запросе можно указать from и to. Пример запроса:\n\n> GET /invoices?from=2024-01-01&to=2024-12-31\n\n\n---\n\n**Роль:** Редактор тарифа и выше.\n\n---\n\nПоля в ответе:\n\ndealer - интегратор.\n\ndate - дата в формате yyyy-MM-dd\n\nsum - сумма.\n\nfile_path - ссылка на файл, можно получить файл через ссылку /api_v1/\n\nПример ответа:\n\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1ccadb8a-4aa1-4683-bd38-e9bb52f1cb2d", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7a5890af-3d85-4317-8867-0dc1802505f2", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e519d990-0cd6-419c-8263-8b871db64ce7", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc6c6a5f-89eb-497f-bbbd-674cc922d29e", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af35b4da-7f8e-4f1f-8978-3310729aaac7", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc386b7c-bac4-4a98-add5-b62cdaa90884", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0b5cf76-1c7d-4681-bcbc-ce41ad050eaf", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Начальная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "Конечная дата периода (формат YYYY-MM-DD)", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Инструменты", "description": "", "item": [ { "id": "42188ee7-00d7-4bfe-86bd-f12c56f10319", "name": "Служебная утилита парсинга таблиц Wialon по IMEI", "request": { "name": "Служебная утилита парсинга таблиц Wialon по IMEI", "description": { "content": "**Загрузка истории по объектам**\n\n---\n\nПараметры запроса:\n\ntable - ключ протокола передачи данных объекта (terminal_type_key)\n\nimei - IMEI объекта.\n\n---\n\n**Пример запроса:**\n\nPOST [https://api.skif.pro/api_v1/tools/loadwln?table=navtelecom&imei=85433234354343](https://api.skif.pro/api_v1/tools/loadwln?table=navtelecom&imei=85433234354343)\n\nВ теле запроса для загрузки принимаются только один файл архива в формате zip, в котором находится файл выгрузки истории из Wialon в формате wln.\n\nВ ответе возвращается 200, если загружено успешно или статус для ошибки.\n\nТело ответа содержит текст в формате text/plain.", "type": "text/plain" }, "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "f5c13774-a8fe-47e1-89b6-f3c46aadb79a", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1888fb6c-b4ef-43a4-bf7e-0906dc018727", "name": "Некорректный запрос или ошибка валидации параметров", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f76ea1c-06fa-4a73-880b-89dbe0964e75", "name": "Пользователь не авторизован или сессия завершена", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e2ce96e-3203-418c-9eaa-b21df7d7ea98", "name": "Недостаточно прав доступа (требуется повышенная роль)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfab42f6-cb9f-4558-8f30-20b851b4361d", "name": "Запрашиваемый ресурс (вложение, код, задача удаления или ретранслятор) не найден", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c8bb9bd-b0f9-4cd5-a65a-424d2bff3444", "name": "Необрабатываемая сущность (ошибка формата или данных)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a262c6e1-f2c8-469f-93c2-ebbba319916c", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "loadwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Название таблицы", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "(Required) IMEI терминала", "type": "text/plain" }, "key": "imei", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Выгрузка данных", "description": "", "item": [ { "id": "e90cac2a-1717-4b23-a66b-07dc4958fa6d", "name": "/tools/exportwln_multiple", "request": { "name": "/tools/exportwln_multiple", "description": { "content": "**Экспортирование множества объектов**\n\n---\n\n**Пример запроса:**\n\nPOST [https://admin-dev.skif.pro/api_v1/tools/exportwln_multiple](https://admin-dev.skif.pro/api_v1/tools/exportwln_multiple)\n\nВозвращает zip файл с необходимыми объектами в формате .wln", "type": "text/plain" }, "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0307955d-a044-4abb-a189-72f04e7e8350", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "490914d4-6213-453c-be01-45d95d9eb9d3", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa2f0281-5c93-48cf-8525-4de8d56f8a84", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9c98705-e2ae-44f8-9262-77880fd7dcae", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd58d6e5-af78-4be8-8c77-3a742e833cdf", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad79ecb8-e4cd-4541-a296-e72694bfdc3e", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b05379bd-e3ea-4d98-b622-268e8d58c0e2", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln_multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"objects\": [\n {\n \"imei\": \"\",\n \"table\": \"\"\n },\n {\n \"imei\": \"\",\n \"table\": \"\"\n }\n ],\n \"to\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9039fd47-ea57-40a9-949e-26dc8996abc0", "name": "/tools/exportwln", "request": { "name": "/tools/exportwln", "description": { "content": "**Метод для экспортирования объекта**\n\n---\n\nПример:\n\nPOST [https://admin-dev.skif.pro/api_v1/tools/exportwln?table=novacom&imei=123&from=2024-10-24&to=2024-10-25](https://admin-dev.skif.pro/api_v1/tools/exportwln?table=novacom&imei=123&from=2024-10-24&to=2024-10-25)\n\nВозвращает .wln файл с необходимым объектом", "type": "text/plain" }, "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "81922d9b-deed-44e2-af3a-f481e1f08ce5", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2c5b9391-5a49-4619-b708-e267f973f124", "name": "Ошибка валидации параметров запроса", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bceea36c-6d69-49d4-a49f-b0dd107eb569", "name": "Пользователь не аутентифицирован (сессия отсутствует или недействительна)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd2d424d-3d23-427f-9273-7f4212dc8b62", "name": "Доступ запрещен (недостаточно прав)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fa601d2-c7f8-4b28-b61f-dcc41c22fd5b", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aaac75d6-a5b2-4bab-aa70-1b9a90311769", "name": "Ошибка обработки сущности (бизнес-валидация)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34c17195-a37c-4918-9ff1-1dcad0f458dc", "name": "Превышен лимит запросов (Rate Limit)", "originalRequest": { "url": { "path": [ "api_v1", "tools", "exportwln" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "table", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "imei", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Support", "description": "", "item": [ { "id": "891d3967-8a44-4dfb-9011-ad3d47426c54", "name": "/support_key", "request": { "name": "/support_key", "description": { "content": "Запрос на получение API-ключа для HelpDeskEddy.\n\nВозвращает ответ JSON со статусом 200 или ошибкой в случае ошибки.\n\nПоля ответа:\n\nuser_id - ID пользователя в SKIF.PRO, uuid\n\nhelpdesk_user_id - ID пользователя в HelpDeskEddy\n\nhelpdesk_api_key - API key для HelpDeskEddy\n\nПример ответа:\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "00ea2b19-d32a-4587-8775-1d7ecd2b1e45", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a746dc8e-deee-4e6f-9bb4-f421b9721552", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d173e09-e90b-4a6a-bec6-f0bbd0373ede", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f314eb5-0b97-418e-a374-0937f9caeab5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d16b0999-11b7-4c10-88e4-653e1c4cb6c1", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "389c4e2c-414f-4bfe-8423-87f9cf75b509", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "support_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "295af928-16d5-419e-a469-edf0226321ef", "name": "[Webhook] Обработчик входящих событий HelpDeskEddy", "request": { "name": "[Webhook] Обработчик входящих событий HelpDeskEddy", "description": { "content": "для получения webhook запросов от helpdesckeddy. Требуется API key отправить в хедере\n\nПоля JSON запроса:\n\n```\n{\n \"ticket_id\": \"27\",\n \"user_id\": \"5\", //id клиента в helpdesck\n \"ticket_name\": \"Тема обращения\",\n \"answer\": \"текст ответа\"\n}\n\n ```\n\nПо результату активному пользователю (подключен к нам по websocket) отправляется websocket-сообщение и всегда отправлять push уведомление в следующем формате:\n\n``` json\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 ```", "type": "text/plain" }, "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0e052161-6505-42bd-8d4b-eb1f3e8871a6", "name": "200", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a191ac76-49f2-4767-8786-89ab56bae5e2", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a5d1239-f53b-4092-953d-42fe08f97078", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e6c058e-c78b-4c2a-abbf-937abe5bd1a5", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "542f9055-b041-4e80-ba96-48c8f4e142a9", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1e1b9f4-eab6-4266-a0e6-47141a458711", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "support_hook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Ресурсы компаний", "description": "", "item": [ { "id": "6ec81aea-72d2-4104-ac4a-7f3ee3c23a11", "name": "/map_layers", "request": { "name": "/map_layers", "description": { "content": "

Получение списка всех слоев компании

\n

Возвращает список всех слоев, для текущей активной компании

\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
", "type": "text/plain" }, "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e61e73c5-60f3-4df2-b60c-eef2d1b480b7", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "43982824-d315-4228-8237-4769620d59ee", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d13461c-a030-4d71-a3cc-a7b9770b5792", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e3043f2-2772-4c4b-a086-a22ef9730e5d", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24e4f8b6-eca9-49a8-99d1-66dba0293854", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1a0732a-48bc-400e-96ec-6889580b271a", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0f8a8218-436c-4a03-8380-27437af84f4f", "name": "/map_layers", "request": { "name": "/map_layers", "description": { "content": "

Создание или редактирование слоя в библиотеке дилера

\n

Универсальный метод, который выполняет сразу три функции:

\n
    \n

  1. Создание нового слоя (если не передан id).

    \n
    2. \n

  2. Редактирование параметров существующего слоя (если передан id).

    \n
    3. \n

  3. Управление видимостью слоя: массовая привязка к компаниям и отвязка от них.

    \n
    4. \n
\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\n
\n
    \n

  • dealer_id (обязательно): UUID интегратора, в список которого добавляется слой.

    \n
    • \n

  • companyIdsToAdd (опционально): Массив UUID компаний, которым этот слой станет доступен сразу после
    создания (по умолчанию он добавится к ним в выключенном состоянии — is_active: false)

    \n
    • \n
\n

Редактирование слоя

\n

При редактировании принадлежность к интегратору изменить нельзя.

\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\n
\n
    \n

  • id (обязательно): UUID слоя, который нужно изменить. (Если передан, поле dealer_id игнорируется).

    \n
    • \n

  • companyIdsToRemove (опционально): Массив UUID компаний, у которых этот слой нужно забрать.

    \n
    • \n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7953b969-1d4e-4dc7-8e76-55c70a27d79a", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0bedab3c-3286-4537-9992-7818eb7a513b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3c12b96-6184-42d5-93b4-40f7116f6821", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b40a00a7-17ca-447e-ab7c-71b8279f761f", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "234d986f-4ed5-4ccb-b24c-03582bc47177", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e88641dc-65bf-46dc-b3b9-18d7ffac9c3f", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3d2851f5-c54d-4337-b36d-96f406d7510d", "name": "/dealer/map_layers", "request": { "name": "/dealer/map_layers", "description": { "content": "

Получение списка всех слоев интегратора

\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
\n

Включает стандартные поля слоя + usage_count (сколько компаний используют слой)

", "type": "text/plain" }, "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "73681670-60f2-4a46-b1d1-0792b8fc8d5e", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7d690199-4918-49f2-9b75-8c6a872f481b", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fddb18c-52fc-44d9-b510-2bf74dd7753e", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e0fbad6-bc79-415f-a525-b1567ae0b985", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "774e7d2c-f0c9-4563-ada9-df7d2dd528e0", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a493c02e-5209-4a4a-8086-29d3965bb30c", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "dealer", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "91034ed5-466c-4b2b-b25c-2207de2cfbb2", "name": "map_layers/:id", "request": { "name": "map_layers/:id", "description": { "content": "

Выполняет удаление слоя и все связи этого слоя с компаниями.

", "type": "text/plain" }, "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "374a40f8-6491-4632-8595-b4091a1d9d1a", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "90f3771b-95f4-4e53-ae98-2fce86903554", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6254c90-6dfa-454a-ae1f-1f503809f6c2", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ede63f18-2851-4ecf-b2d1-632f0aaa196d", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "423d6480-957b-4bcf-a17f-2431da083e6f", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c247909-accc-4e11-801b-a805d6f2be3a", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "map_layers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID слоя карты", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c97c84b2-d6cb-4f36-9ae4-af5341b290cc", "name": "/company/:id/map_layers", "request": { "name": "/company/:id/map_layers", "description": { "content": "

Получение слоев конкретной компании

\n

Возвращает список слоев, которые были привязаны к указанной компании, с учетом их статуса (активен/неактивен) и порядка сортировки.

\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

Сортировка: сначала активные (is_active), затем по sort_order.

", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e1a2e901-215e-4e4a-97ac-a0a2990715bd", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b8302136-193c-4880-be3f-f6f6f9f74ec6", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "709f23cf-9690-43f8-ada8-46985979e730", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e8d8434-9ed3-4958-9319-6a93ab423dd3", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2321c997-e8a0-4943-8b90-0c718651185c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "510fdede-9d2a-4eef-99ae-dfa60fc8bc58", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c7252091-ca2b-414c-9913-46c4504e4c6e", "name": "/company/:id/map_layers", "request": { "name": "/company/:id/map_layers", "description": { "content": "

Обновление настроек слоев компании

\n

Позволяет изменить порядок отображения слоев и включить/выключить их для конкретной компании.

\n

Пример запроса:

\n
[\n  {\n    \"id\": \"uuid\",         // ID слоя\n    \"is_active\": true     // Статус активности\n  },\n  {\n    \"id\": \"uuid\",\n    \"is_active\": false\n  }\n]\n\n
\n

Важно: Порядок объектов в массиве определяет sort_order

", "type": "text/plain" }, "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "3b6f4eaa-1046-4a50-9e23-6b0cf62023d2", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ed8e709a-0be5-4f37-b9b5-9293e389efe4", "name": "Некорректный запрос или ошибка валидации полей", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "532ac270-a947-45f2-99b4-a4ef6b03abd5", "name": "Требуется аутентификация (сессия отсутствует или истекла)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a27aa2d-2a9c-4da1-8ab5-2f464e3f458b", "name": "Недостаточно прав доступа для выполнения операции (ролевая модель)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9657321e-6f45-4023-9a57-9e0a84d9147c", "name": "Запрашиваемый ресурс не найден", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "671b42a8-3073-44b3-aef1-f902991aa0e1", "name": "Ошибка бизнес-логики (например, email уже зарегистрирован, неверный код)", "originalRequest": { "url": { "path": [ "api_v1", "company", ":id", "map_layers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID компании", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Agro", "description": "", "item": [ { "id": "3d5f92c7-d656-4d2c-b8cb-71d64555b647", "name": "Создание шаблона экспорта полей и геозон агромодуля", "request": { "name": "Создание шаблона экспорта полей и геозон агромодуля", "description": { "content": "Настройка структуры полей и слоев геометрии для выгрузки контуров полей в сторонние агросистемы.", "type": "text/plain" }, "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "34407838-fd52-44fd-aebb-64b0d914ec10", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bf119984-88e8-4c32-90c5-3d9ee8ef7ea3", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f88373f-9e48-4bb5-bfd7-6484f4a54145", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0294d2be-68a5-498e-b98e-786097ef3a60", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "213e3b17-a2fb-4831-8167-48c40cb17cd4", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eab897ea-02b9-49c7-80f8-fc6b0e1e8ce9", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "958cd2d6-91af-46c0-93c1-35a80eecd50b", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "57c5815a-6fdd-4cd2-902f-ce63b29c0cb7", "name": "Обновление шаблона экспорта агромодуля", "request": { "name": "Обновление шаблона экспорта агромодуля", "description": { "content": "Редактирование полей и правил форматирования выгрузки агро-данных.", "type": "text/plain" }, "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9598d360-a9d7-4392-8e47-7c3f10ffc19a", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e7ee929b-c588-4f14-bb0f-7d5ec8a05a06", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c1ff841-9120-4990-b2ac-e638c9e2d738", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "819af862-2ce6-4061-91c5-8babc9765ea4", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f9178bf-a555-412a-b12e-592e64f5b5f7", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a52300a-5578-4bdb-8c96-4991ce10aab1", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22c8a869-2827-4f18-9775-d5fed3d13fb1", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "PUT", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "05fec2ad-f04c-49cc-9b5e-666e83c2f420", "name": "Удаление шаблона экспорта агромодуля", "request": { "name": "Удаление шаблона экспорта агромодуля", "description": { "content": "Удаление конфигурации шаблона выгрузки.", "type": "text/plain" }, "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "651e61ce-32cd-4c68-a231-a44105509d12", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "34bfa280-b877-45dc-b6cc-12ce33f4873b", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ccdc6ec-4473-4ebc-9d1c-69d4f73175d2", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10c63600-3ffe-4dbb-a1e3-c896d627f091", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f95838e5-4e80-4aa1-bf36-c16a206b700a", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff4dfb3b-a685-49c7-b57a-573acd4238f6", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a74912e7-7f6b-4c9a-9a4f-2ecc0ea8d8dc", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID шаблона экспорта", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f0f6d546-c28b-45ea-9e5a-47289fa06059", "name": "Получение списка шаблонов экспорта агромодуля", "request": { "name": "Получение списка шаблонов экспорта агромодуля", "description": { "content": "Реестр сохраненных шаблонов экспорта агро-геометрии и атрибутов культур.", "type": "text/plain" }, "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "902dd1ca-9589-4eca-aee6-a5acdf82ff7d", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "56f1273f-1b42-4563-be91-69535dce459b", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13eac6e5-e819-43af-a0e2-c7de99658321", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5cbe383-6fac-4656-8f5a-4b8c727b65be", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18259d5c-d57d-4a58-90ee-8b0b697bd6f5", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6fd22c6-50c7-46a0-b5d6-45c84aa81f9c", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80c9baf0-b2d4-485b-98de-b18be356f171", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "export_templates", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4e3857d4-75e5-4f7f-9750-05455c09facf", "name": "Создание скрытого интервала агро-обработки", "request": { "name": "Создание скрытого интервала агро-обработки", "description": { "content": "Исключение интервала времени работы сельхозтехники из расчетов обработанной площади полей.", "type": "text/plain" }, "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "55661e5e-5bcc-4e3d-97ec-1d5f1f863817", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1ebfab92-8935-416a-b1e4-29e8d5dedd6f", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef6779ce-f17d-415c-838f-f71810461874", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55fbc4b8-2f10-48ad-a29a-1b05556286e6", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1846d6b0-7ec2-4276-9c8b-62b4ab9cefd3", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5494ceb4-94d9-46f5-abe3-5fe2cf461d06", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b519747-01b4-4e23-a31c-672995e9d211", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "agro_hidden_intervals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "84d60386-d16b-4f7a-9e46-0762bc3ca852", "name": "Получение списка скрытых интервалов агро-обработки", "request": { "name": "Получение списка скрытых интервалов агро-обработки", "description": { "content": "Реестр интервалов времени, исключенных из расчетов полевых работ (перегоны, сервисные паузы, холостой ход).", "type": "text/plain" }, "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "040119bd-5de1-47b0-a2ee-1bf9429afbbf", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "85673fa1-18d1-40de-a85d-c761a27f1229", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4960335-545e-4067-b7da-ba1d8a8a57b9", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83cd3d65-3c16-4d9f-8edc-493463b88ab4", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6600f8d-2a7a-4d00-ac83-4f7d971cb4ad", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa08f0be-5499-42bd-ae6f-291c3f2a4f4d", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8dcfe301-cbdc-4f5f-b593-0f52768df417", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", "list" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"count\": \"\",\n \"unit_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "99281474-58dd-4c09-afd4-7cb449992abf", "name": "Удаление скрытого интервала агро-обработки", "request": { "name": "Удаление скрытого интервала агро-обработки", "description": { "content": "Удаление исключенного интервала с возвратом отрезка в расчет агро-отчетов.", "type": "text/plain" }, "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e1f6b698-3e02-480b-9f9d-770ec65eb27f", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d86d1be8-e42e-4e2e-8d83-127e477f906d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f32fc0c-7bb7-408c-9867-5d0aa7c742a5", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4596ce3-2e1d-4714-ac51-0296d2202f92", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b14ee21-c51c-4155-91cc-fbc289476a75", "name": "Запрашиваемый ресурс (объект, интервал, счет или компания) не найден", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f0b4104-e56d-423d-81fa-b55d360bc533", "name": "Необрабатываемая сущность (ошибка валидации дат, превышение лимита строк)", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f6703e3-13b8-47c9-8b8f-f20c22e4acf2", "name": "Превышен лимит частоты запросов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "agro", "hidden_intervals", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) UUID скрытого интервала", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Экспорт сущностей", "description": "", "item": [ { "id": "2cb59e06-b12a-496b-9f4f-4ef58589e4a2", "name": "/admin_export", "request": { "name": "/admin_export", "description": { "content": "

Запуск экспорта сущностей в файл

\n
\n

Ставит в очередь выгрузку выбранных сущностей компаний в JSON (одна сущность) или ZIP из JSON-файлов (несколько сущностей). Используется на экране «Инструменты» админки.

\n

Метод не ждёт окончания выгрузки: сразу возвращает job_id, а ход и результат нужно запрашивать через GET /admin_export/status/:jobId. Ошибки в теле запроса (нет entities, нет доступных компаний и т. п.) тоже приходят не здесь, а в статусе задачи со status: \"error\".

\n

В выгрузку попадает не больше 20 000 записей каждого типа. Файл хранится 30 минут, потом удаляется.

\n
\n

Роль: Администратор и выше. Работает только под ролью по умолчанию: если пользователь переключился на другую роль, задача завершится ошибкой доступа.

\n
\n

Параметры:

\n
    \n
  • entities: object - какие сущности выгружать. Обязательно, минимум один ключ. Ключ — тип сущности, значение — условия выборки. Возможные ключи: units, units_groups, geozones, geozones_groups, routes, trips, notifications, report_templates, units_drivers, trailers.
      \n
    • ids: array of string (UUID) - идентификаторы сущностей этого типа. Необязательно. Если не передан и all не равен true, этот тип не выгружается.
      • \n
    • all: boolean - выгрузить все сущности этого типа в доступных компаниях. Необязательно, по умолчанию false. При true поле ids не учитывается.
      • \n
    • filter: object - сужает выборку при all: true, в том же формате, что и POST /admin_query. Необязательно. Без all: true не учитывается.
        \n
      • field: string - поле для поиска. Необязательно. Должно входить в поля поиска модели, иначе тип попадёт в summary.errors с причиной invalid_filter_field.
        • \n
      • value: string - искомое значение. Необязательно. Поиск по вхождению без учёта регистра.
        • \n
      • exact_match: boolean - искать точное совпадение вместо вхождения. Необязательно, по умолчанию false.
        • \n
      • conditions: array - дополнительные фильтры «значение из списка». Необязательно.
          \n
        • field: string - поле. Обязательно для элемента. Должно входить в поля поиска модели.
          • \n
        • values: array of string - допустимые значения. Необязательно, если указан value.
          • \n
        • value: string - одно допустимое значение. Используется, если values пустой.
          • \n
        \n
        • \n
      • companies: array - сужает список компаний для этого типа. Необязательно. Компании вне общего доступного списка не учитываются.
          \n
        • id: string (UUID) - идентификатор компании.
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
  • include_related: boolean - дополнительно выгрузить связанные сущности. Необязательно, по умолчанию false. Связи раскрываются на один уровень: группы объектов → объекты, группы геозон → геозоны, уведомления → объекты, группы объектов, геозоны и их группы, водители → объекты, шаблоны отчётов → геозоны и группы геозон, прицепы → объекты. К объекту (units) связанные сущности не подтягиваются.
    • \n
  • companies: array - из каких компаний выгружать. Необязательно. Берётся пересечение с компаниями пользователя; если поле не передано, выгрузка идёт по всем компаниям пользователя. Если пересечение пустое, задача завершится ошибкой «Компании не найдены».
      \n
    • id: string (UUID) - идентификатор компании. Обязательно для элемента.
      • \n
    \n
    • \n
\n

Если среди ids есть сущности, которых нет или к которым нет доступа, выгрузка не падает: они перечисляются в summary.errors с причиной not_found_or_no_access.

\n
\n

Пример запроса:\nДва объекта по идентификаторам и все геозоны с «склад» в названии из одной компании, вместе со связанными сущностями.

\n
{\n  \"entities\": {\n    \"units\": {\"ids\": [\"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"b23456c3-7890-2bc3-4de5-2bc345de6f78\"]},\n    \"geozones\": {\"all\": true, \"filter\": {\"field\": \"name\", \"value\": \"склад\"}}\n  },\n  \"include_related\": true,\n  \"companies\": [{\"id\": \"c34567d4-8901-3cd4-5ef6-3cd456ef7a89\"}]\n}\n
\n

Ответ:\nКод 200. Задача поставлена в очередь, дальше её статус запрашивается по job_id.

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\"\n}\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d2f5fdab-5a36-4d25-8627-cf70bfec4aae", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "560e67cb-500c-481a-a701-aefa62b1d23c", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07f577c7-697b-4a3c-b1e5-8d17e4b91c3c", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "158b882f-7151-4e1a-9c86-86183039a1e9", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6955e4f-0c6b-456b-9a0e-eb76f749d346", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3db94b49-8355-45e9-889a-8ae391c5f948", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a8b4b60-6a25-447f-8c3a-70bce14ca0cb", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"units\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"geozones\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\"\n }\n }\n },\n \"include_related\": \"\",\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "899434cd-9f35-4779-af4c-69e19a446140", "name": "/admin_export/jobs", "request": { "name": "/admin_export/jobs", "description": { "content": "

Получение списка задач экспорта пользователя

\n
\n

Возвращает задачи экспорта текущего пользователя в любом статусе, новые первыми. Нужен, чтобы после перезагрузки страницы вернуться к незавершённым выгрузкам. Задача пропадает из списка через 30 минут после завершения.

\n
\n

Роль: Администратор и выше, только под ролью по умолчанию.

\n
\n

Параметры: нет.

\n
\n

Ответ:
Код 200. Массив задач, формат элемента — как в ответе GET /admin_export/status/:jobId. Если задач нет, приходит пустой массив [].

\n
[\n  {\n    \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n    \"status\": \"running\",\n    \"created_at\": \"2026-09-23T09:15:02.418Z\",\n    \"percent\": 40\n  },\n  {\n    \"job_id\": \"e56789f6-0123-5ef6-7ab8-5ef678ab9c01\",\n    \"status\": \"done\",\n    \"created_at\": \"2026-09-23T09:02:47.105Z\",\n    \"summary\": {\"total\": 1, \"by_type\": {\"units\": 1}, \"errors\": []},\n    \"filename\": \"units_a12345b2-6789-1ab2-3cd4-1ab234cd5e67.json\",\n    \"download_path\": \"/api_v1/files/exports_entites/f67890a7-1234-6fa7-8bc9-6fa789bc0d12.json\"\n  }\n]\n\n

Код 403, если роль не подходит или активна не роль по умолчанию:

\n
{\n  \"error\": \"no_access\"\n}\n\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ec9459f4-7cb9-47cb-8851-8ec071e16974", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1ccbc904-5018-412e-8270-c55202b5b41a", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56cec1bc-2f36-479e-bc8c-7b94920f1181", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dd290f4-223e-4602-b745-0b1c282e91ea", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a00a92b6-ba90-4e73-bcd5-006f7b1b5b22", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac1a295d-1065-42ec-b47a-bd1790e9638b", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b8b041c-082f-475b-bad9-d19e9880cb19", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "030e7bc5-07b1-44cc-9ef3-0114e6633e1e", "name": "/admin_export/status/:jobId", "request": { "name": "/admin_export/status/:jobId", "description": { "content": "

Получение статуса задачи экспорта

\n
\n

Возвращает ход выполнения и результат задачи. Клиент опрашивает метод, пока status не станет done или error.

\n
\n

Роль: Администратор и выше, только под ролью по умолчанию.

\n
\n

Параметры:

\n
    \n
  • jobId: string (UUID) - идентификатор задачи из ответа POST /admin_export. Обязательно, передаётся в пути.
    • \n
\n
\n

Ответ:
Поля ответа:

\n
    \n
  • job_id: string (UUID) - идентификатор задачи.
    • \n
  • status: string - waiting — в очереди, running — выполняется, done — готово, error — ошибка.
    • \n
  • created_at: string - время создания задачи, ISO 8601, UTC.
    • \n
  • percent: number - прогресс от 0 до 100. Есть только при running: 0–40 — выборка записей, 40–100 — запись файла.
    • \n
  • summary: object - итог выгрузки. Есть только при done.
      \n
    • total: number - сколько сущностей выгружено.
      • \n
    • by_type: object - сколько сущностей каждого типа.
      • \n
    • errors: array - что не удалось выгрузить. type — тип сущности, id или field — сущность или поле фильтра, reason: unknown_entity_type — неизвестный тип, not_found_or_no_access — сущность не найдена или нет доступа, invalid_filter_field — по полю нельзя фильтровать, record_limit_exceeded — превышен лимит 20 000 записей для выборки по ids (при all: true лишнее отсекается без ошибки).
      • \n
    \n
    • \n
  • filename: string - имя файла для сохранения. Есть при done, если выгружена хотя бы одна сущность. Одна сущность — <тип>_.json, несколько — skif_export_.zip, внутри архива файлы <тип>/<тип>_.json.
    • \n
  • download_path: string - путь для скачивания файла, отдаётся nginx на том же домене. Есть там же, где filename. Файл хранится 30 минут.
    • \n
  • error: object - есть только при error.
      \n
    • code: number - всегда 4220.
      • \n
    • message: string - текст ошибки на языке пользователя.
      • \n
    \n
    • \n
\n

Код 200, выполняется:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"running\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"percent\": 65\n}\n\n

Код 200, готово:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"done\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"summary\": {\n    \"total\": 14,\n    \"by_type\": {\"units\": 2, \"geozones\": 12},\n    \"errors\": [\n      {\"type\": \"units\", \"id\": \"b23456c3-7890-2bc3-4de5-2bc345de6f78\", \"reason\": \"not_found_or_no_access\"}\n    ]\n  },\n  \"filename\": \"skif_export_a78901b8-2345-7ab8-9cd0-7ab890cd1e23.zip\",\n  \"download_path\": \"/api_v1/files/exports_entites/b89012c9-3456-8bc9-0de1-8bc901de2f34.zip\"\n}\n\n

Если ничего не выгрузилось, при done приходит только summary с total: 0, а filename и download_path отсутствуют.

\n

Код 200, ошибка:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"error\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"error\": {\n    \"code\": 4220,\n    \"message\": \"Компании не найдены\"\n  }\n}\n\n

Возможные сообщения ошибки: «У Вас недостаточно прав для этого действия», «Не валидный параметр» (тело запроса не разобралось), «Неверное значение параметра entities», «Компании не найдены», «Внутренняя ошибка сервера, обратитесь к администратору».

\n

Код 403, если роль не подходит или активна не роль по умолчанию:

\n
{\n  \"error\": \"no_access\"\n}\n\n

Код 404, если задачи нет: неверный jobId или прошло больше 30 минут после завершения.

\n
{\n  \"error\": \"job_not_found\"\n}\n\n

Код 400, если jobId не является UUID.

", "type": "text/plain" }, "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "jobId", "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "0be11c65-4c86-485b-b105-389b2c94e526", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4a4e9eee-a433-4c9d-90d8-540d30ee3f17", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2146986f-11f0-44fb-ad9b-2c0b10003388", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a58db6b-3c10-419a-8ad4-444426187588", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d79c969-fd01-4a12-8d90-3d7c7af93857", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5a9d73d-bd52-49b3-ab16-3e10ea265a84", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f1a0403-9261-45a5-ad1a-b49ee9d8e735", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ba034de1-d56c-4f8b-945f-e34cdd3498c0", "name": "/auth_admin_export", "request": { "name": "/auth_admin_export", "description": { "content": "

Запуск экспорта пользователей и водителей в файл

\n
\n

Ставит в очередь выгрузку пользователей и водителей компаний в JSON (одна запись) или ZIP из JSON-файлов (несколько записей). Остальные сущности (объекты, геозоны и т. д.) выгружаются методом POST /admin_export. Формат запроса, задачи и результата у методов одинаковый.

\n

Метод не ждёт окончания выгрузки: сразу возвращает job_id, а ход и результат нужно запрашивать через GET /auth_admin_export/status/:jobId. Ошибки в содержимом запроса (нет entities, нет доступных компаний и т. п.) приходят не здесь, а в статусе задачи со status: \"error\".

\n

Выгружаются только пользователи с ролью в компании не выше Администратора. Сотрудники интегратора (Супервайзер, Тарифный редактор, Контролёр) в выгрузку не попадают. В выгрузке нет пароля и настроек VPN, а в companies у пользователя перечислены только компании, доступные для выгрузки.

\n

В выгрузку попадает не больше 20 000 записей каждого типа. Файл хранится 30 минут, потом удаляется.

\n
\n

Роль: Администратор и выше.

\n
\n

Параметры:

\n
    \n
  • entities: object - кого выгружать. Обязательно, минимум один ключ. Ключ — тип сущности, значение — условия выборки. Возможные ключи: users — пользователи, drivers — водители.
      \n
    • ids: array of string (UUID) - идентификаторы пользователей или водителей. Необязательно. Если не передан и all не равен true, этот тип не выгружается.
      • \n
    • all: boolean - выгрузить всех пользователей или водителей в доступных компаниях. Необязательно, по умолчанию false. При true поле ids не учитывается.
      • \n
    • filter: object - сужает выборку при all: true, так же, как поиск пользователей в POST /auth_admin_query. Необязательно. Без all: true не учитывается.
        \n
      • field: string - поле для поиска. Необязательно. Возможные значения: name, code, telegram_chat_id, email, phone. Если не передано, value ищется по всем этим полям сразу и по точному совпадению с id. С другим значением тип попадёт в summary.errors с причиной invalid_filter_field.
        • \n
      • value: string - искомое значение. Необязательно. Поиск по вхождению без учёта регистра.
        • \n
      • exact_match: boolean - искать точное совпадение вместо вхождения. Необязательно, по умолчанию false.
        • \n
      • conditions: array - дополнительные фильтры «значение из списка». Необязательно.
          \n
        • field: string - поле. Обязательно для элемента. Возможное значение: только role_key — роль пользователя в компании. С другим значением тип попадёт в summary.errors с причиной invalid_filter_field.
          • \n
        • values: array of string - допустимые ключи ролей. Необязательно, если указан value. Возможные значения: ADMIN, EDITOR, OPERATOR, READER, OBSERVER, NO_ACCESS.
          • \n
        • value: string - один допустимый ключ роли. Используется, если values пустой.
          • \n
        \n
        • \n
      • companies: array - сужает список компаний для этого типа. Необязательно. Компании вне общего доступного списка не учитываются.
          \n
        • id: string (UUID) - идентификатор компании.
          • \n
        \n
        • \n
      \n
      • \n
    \n
    • \n
  • include_related: boolean - принимается для совместимости с POST /admin_export, ни на что не влияет. Необязательно.
    • \n
  • companies: array - из каких компаний выгружать. Необязательно. Берётся пересечение с компаниями, где у пользователя роль Администратор или выше; если поле не передано — все такие компании. Если пересечение пустое, задача завершится ошибкой «У Вас недостаточно прав для этого действия».
      \n
    • id: string (UUID) - идентификатор компании. Обязательно для элемента.
      • \n
    \n
    • \n
\n

Если среди ids есть записи, которых нет или к которым нет доступа, выгрузка не падает: они перечисляются в summary.errors с причиной not_found_or_no_access.

\n
\n

Пример запроса:\nДва пользователя по идентификаторам и все водители с ролью «Редактор» из одной компании, в имени которых есть «иванов».

\n
{\n  \"entities\": {\n    \"users\": {\"ids\": [\"a12345b2-6789-1ab2-3cd4-1ab234cd5e67\", \"b23456c3-7890-2bc3-4de5-2bc345de6f78\"]},\n    \"drivers\": {\n      \"all\": true,\n      \"filter\": {\n        \"field\": \"name\",\n        \"value\": \"иванов\",\n        \"conditions\": [{\"field\": \"role_key\", \"values\": [\"EDITOR\"]}]\n      }\n    }\n  },\n  \"companies\": [{\"id\": \"c34567d4-8901-3cd4-5ef6-3cd456ef7a89\"}]\n}\n
\n

Ответ:\nКод 200. Задача поставлена в очередь, дальше её статус запрашивается по job_id.

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\"\n}\n

Код 422, если тело запроса не JSON:

\n
{\n  \"code\": 4220,\n  \"field\": \"\",\n  \"message\": \"Недопустимый параметр body\"\n}\n

Код 403, если роль ниже Администратора:

\n
{\n  \"code\": 4030,\n  \"field\": \"\",\n  \"message\": \"Доступ запрещен, обратитесь к администратору\"\n}\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "bfa823db-f812-47d1-99fc-ad157c1e7ebe", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "37322290-55c0-40ed-be94-3aa15c671c0d", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0212ef66-645d-40e8-a025-2e5df64ac560", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83651ba5-9c2d-4430-be0f-0525459943e2", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffbe617b-758e-4ef8-83cb-ab46f66e7d62", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9e37ba8-5929-4591-9a50-192b61c30f0d", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "470092e2-44bf-4ef6-893d-17195d3a8ee8", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"entities\": {\n \"users\": {\n \"ids\": [\n \"\",\n \"\"\n ]\n },\n \"drivers\": {\n \"all\": \"\",\n \"filter\": {\n \"field\": \"\",\n \"value\": \"\",\n \"conditions\": [\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n },\n {\n \"field\": \"\",\n \"values\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n }\n },\n \"companies\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "257407e9-a85c-444c-8bab-3d3d6c847353", "name": "/auth_admin_export/jobs", "request": { "name": "/auth_admin_export/jobs", "description": { "content": "

Получение списка задач экспорта пользователей и водителей

\n
\n

Возвращает задачи экспорта пользователей и водителей, которые поставил текущий пользователь, в любом статусе, новые первыми. Нужен, чтобы после перезагрузки страницы вернуться к незавершённым выгрузкам. Задача пропадает из списка через 30 минут после завершения. Задачи POST /admin_export сюда не попадают — они в GET /admin_export/jobs.

\n
\n

Роль: Администратор и выше.

\n
\n

Параметры: нет.

\n
\n

Ответ:\nКод 200. Массив задач, формат элемента — как в ответе GET /auth_admin_export/status/:jobId. Если задач нет, приходит пустой массив [].

\n
[\n  {\n    \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n    \"status\": \"running\",\n    \"created_at\": \"2026-09-23T09:15:02.418Z\",\n    \"percent\": 20\n  },\n  {\n    \"job_id\": \"e56789f6-0123-5ef6-7ab8-5ef678ab9c01\",\n    \"status\": \"done\",\n    \"created_at\": \"2026-09-23T09:02:47.105Z\",\n    \"summary\": {\"total\": 1, \"by_type\": {\"users\": 1}, \"errors\": []},\n    \"filename\": \"users_a12345b2-6789-1ab2-3cd4-1ab234cd5e67.json\",\n    \"download_path\": \"/api_v1/files/exports_entites/f67890a7-1234-6fa7-8bc9-6fa789bc0d12.json\"\n  }\n]\n

Код 403, если роль ниже Администратора:

\n
{\n  \"code\": 4030,\n  \"field\": \"\",\n  \"message\": \"Доступ запрещен, обратитесь к администратору\"\n}\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1b600305-6bd2-42d4-8283-5223cb5c68df", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "06a11397-89a8-400c-9460-b1136e89fe30", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67bea865-a70b-401a-a6ec-0eef345f664a", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04a8c00e-dd45-47cf-ae96-5c7ede3dd3be", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56608b01-8a96-43dd-9da5-bbbadb7bed86", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91405f00-65ff-4090-9454-66f7018057f6", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7f8601c-2570-4bd3-b277-ec9ff1a84fa3", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "60782432-5674-4b31-942f-769cee7f44f3", "name": "/auth_admin_export/status/:jobId", "request": { "name": "/auth_admin_export/status/:jobId", "description": { "content": "

Получение статуса задачи экспорта пользователей и водителей

\n
\n

Возвращает ход выполнения и результат задачи. Клиент опрашивает метод, пока status не станет done или error. Задача видна только тому, кто её поставил: для чужой задачи ответ такой же, как для несуществующей.

\n
\n

Роль: Администратор и выше.

\n
\n

Параметры:

\n
    \n
  • jobId: string (UUID) - идентификатор задачи из ответа POST /auth_admin_export. Обязательно, передаётся в пути.
    • \n
\n
\n

Ответ:\nПоля ответа:

\n
    \n
  • job_id: string (UUID) - идентификатор задачи.
    • \n
  • status: string - waiting — в очереди, running — выполняется, done — готово, error — ошибка.
    • \n
  • created_at: string - время создания задачи, ISO 8601, UTC.
    • \n
  • percent: number - прогресс от 0 до 100. Есть только при running: 0–20 — выборка записей, 20–100 — запись файла.
    • \n
  • summary: object - итог выгрузки. Есть только при done.
      \n
    • total: number - сколько записей выгружено.
      • \n
    • by_type: object - сколько записей каждого типа (users, drivers).
      • \n
    • errors: array - что не удалось выгрузить. type — тип сущности, id или field — запись или поле фильтра, reason: unknown_entity_type — неизвестный тип (всё, кроме users и drivers), not_found_or_no_access — запись не найдена или нет доступа, invalid_filter_field — по полю нельзя фильтровать, record_limit_exceeded — превышен лимит 20 000 записей для выборки по ids (при all: true лишнее отсекается без ошибки).
      • \n
    \n
    • \n
  • filename: string - имя файла для сохранения. Есть при done, если выгружена хотя бы одна запись. Одна запись — <тип>_.json, несколько — skif_export_.zip, внутри архива файлы <тип>/<тип>_.json.
    • \n
  • download_path: string - путь для скачивания файла на том же домене. Есть там же, где filename. Файл хранится 30 минут.
    • \n
  • error: object - есть только при error.
      \n
    • code: number - всегда 4220.
      • \n
    • message: string - текст ошибки на языке пользователя.
      • \n
    \n
    • \n
\n

Код 200, выполняется:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"running\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"percent\": 60\n}\n

Код 200, готово:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"done\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"summary\": {\n    \"total\": 14,\n    \"by_type\": {\"users\": 1, \"drivers\": 13},\n    \"errors\": [\n      {\"type\": \"users\", \"id\": \"b23456c3-7890-2bc3-4de5-2bc345de6f78\", \"reason\": \"not_found_or_no_access\"}\n    ]\n  },\n  \"filename\": \"skif_export_a78901b8-2345-7ab8-9cd0-7ab890cd1e23.zip\",\n  \"download_path\": \"/api_v1/files/exports_entites/b89012c9-3456-8bc9-0de1-8bc901de2f34.zip\"\n}\n

Если ничего не выгрузилось, при done приходит только summary с total: 0, а filename и download_path отсутствуют.

\n

Код 200, ошибка:

\n
{\n  \"job_id\": \"d45678e5-9012-4de5-6fa7-4de567fa8b90\",\n  \"status\": \"error\",\n  \"created_at\": \"2026-09-23T09:15:02.418Z\",\n  \"error\": {\n    \"code\": 4220,\n    \"message\": \"Недопустимый параметр entities\"\n  }\n}\n

Возможные сообщения ошибки: «У Вас недостаточно прав для этого действия» (нет компаний, где пользователь Администратор или выше, или пересечение с companies пустое), «Недопустимый параметр body» (тело не разобралось), «Недопустимый параметр entities», «Внутренняя ошибка сервера. Пожалуйста, свяжитесь с администратором.».

\n

Код 404, если задачи нет: неверный jobId, задачу поставил другой пользователь или прошло больше 30 минут после завершения.

\n
{\n  \"error\": \"job_not_found\"\n}\n

Код 400, если jobId не является UUID.

\n

Код 403, если роль ниже Администратора:

\n
{\n  \"code\": 4030,\n  \"field\": \"\",\n  \"message\": \"Доступ запрещен, обратитесь к администратору\"\n}\n
", "type": "text/plain" }, "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "jobId", "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "PLAY_SESSION" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "cb2ac54a-cd9a-4e0f-a265-7135351ac535", "name": "Успешный ответ", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fcd25a5b-1348-44fb-901e-884ff1bb5813", "name": "Некорректный запрос или ошибка валидации входных параметров", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af8d17ad-bdb3-4e2c-ba1e-e8fd3d46eeef", "name": "Пользователь не авторизован или сессия устарела", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "303ba9bb-8184-4644-be27-44e75af03f89", "name": "Недостаточно прав доступа для выполнения операции", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8298ef0a-ad97-43c1-afad-c830ed7fbd91", "name": "Запрашиваемый ресурс (отчет, шаблон или задача экспорта) не найден", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef2688e3-e2f0-4632-9247-f9a2718658eb", "name": "Необрабатываемая сущность (ошибка в формуле, не найдены объекты в запросе)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d929d667-1561-4b2e-9d5a-b5ae03997d42", "name": "Превышен лимит частоты запросов к расчетному ядру отчетов (Rate limit exceeded)", "originalRequest": { "url": { "path": [ "api_v1", "auth_admin_export", "status", ":jobId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Параметр jobId", "type": "text/plain" }, "type": "any", "value": "", "key": "jobId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "PLAY_SESSION", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"field\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://app.skif.pro" } ], "info": { "_postman_id": "56a973ec-73a2-4f7c-9a9e-76e941bd29db", "name": "SKIF.PRO API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Официальная спецификация и документация внешнего API телематической платформы SKIF.PRO (v1).\n\nВсе запросы выполняются относительно базового пути `/api_v1`.\nДля авторизации используется метод `POST /api_v1/login` (в ответе устанавливается сессионная cookie `session`).\n\nContact Support:\n Name: Команда платформы SKIF.PRO", "type": "text/plain" } } }