openapi: 3.0.3 info: title: VRt.Studio [ST] version: 6.20.2289 license: name: Proprietary url: https://veeroute.ru/ termsOfService: https://veeroute.ru/resources/terms_of_service contact: name: Veeroute Support Team email: servicedesk@veeroute.com x-logo: url: ../images/studio.svg backgroundColor: '#FAFAFA' altText: VRt.Studio description: 'Программный интерфейс для инструмента Veeroute Studio. # Описание Серверная часть Veeroute Studio. ## Диаграмма сущностей ![erd](../uml/studio.svg)' servers: - url: https://api.edge.veeroute.tech description: Окружение для интеграции и ознакомления с новой функциональностью - url: https://api.prod.veeroute.com description: Основное окружение security: - ApiKeyAuth: [] tags: - name: Explorer description: 'Управление структурой папок. ' - name: Experiments description: 'Управление экспериментами ' - name: Locations description: 'Управление локациями. ' - name: Performers description: 'Управление исполнителями. ' - name: Transports description: 'Управление транспортом. ' - name: Orders description: 'Управление заказами. ' - name: Hardlinks description: 'Управление назначениями. ' - name: Trips description: 'Управление рейсами. ' - name: Facts description: 'Управление фактами. ' - name: System description: 'Системные функции. Вспомогательный функционал, общий для всех сервисов. ' externalDocs: description: Основной сайт url: https://veeroute.ru/ paths: /studio/explorer: post: tags: - Explorer summary: Создание папки description: Создание новой папки. operationId: create_folder requestBody: description: Запрос на создание папки. required: true content: application/json: schema: $ref: '#/components/schemas/folder_specification' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/unique_key' description: Ключ созданной папки. '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' get: tags: - Explorer summary: Чтение структуры папок description: 'Получение структуры папок. ' operationId: read_filesystem responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/filesystem' examples: DataExplorer: $ref: '#/components/examples/DataExplorer' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/explorer/{folder_key}: parameters: - $ref: '#/components/parameters/folder_key' get: tags: - Explorer summary: Список экспериментов description: 'Получение списка экспериментов. ' operationId: read_folder parameters: - $ref: '#/components/parameters/filter' description: 'Фильтр для поиска по текстовым полям - возвращаются только те эксперименты, у которых в названии или описании содержится подстрока из фильтра. Если фильтр пустой - возвращаются все эксперименты в папке. ' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment_list' examples: ExperimentList: $ref: '#/components/examples/ExperimentList' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Explorer summary: Обновление папки description: Переименование \ перемещение папки. operationId: update_folder requestBody: description: Запрос на обновление папки. required: true content: application/json: schema: $ref: '#/components/schemas/folder_specification' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/filesystem' examples: DataExplorer: $ref: '#/components/examples/DataExplorer' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Explorer summary: Удаление папки description: Удаление папки по ключу. operationId: delete_folder responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/explorer/search/global: get: tags: - Explorer summary: Поиск экспериментов description: Поиск экспериментов по всем вложенным папкам. operationId: global_search parameters: - $ref: '#/components/parameters/filter' description: 'Фильтр для поиска по текстовым полям - возвращаются только те эксперименты, у которых в названии или описании содержится подстрока из фильтра. Если фильтр пустой - возвращается пустой список. Результат сортируется по времени редактирования. ' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/sort_direction' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment_list' examples: ExperimentList: $ref: '#/components/examples/ExperimentList' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments: post: tags: - Experiments summary: Создание эксперимента description: Создание нового эксперимента. operationId: create_experiment requestBody: description: Запрос на создание эксперимента. required: true content: application/json: schema: $ref: '#/components/schemas/experiment_specification' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/unique_key' description: Ключ созданного эксперимента. '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}: parameters: - $ref: '#/components/parameters/experiment_key' get: tags: - Experiments summary: Чтение эксперимента description: Получение информации об эксперименте по его ключу. operationId: read_experiment responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' examples: Experiment: $ref: '#/components/examples/Experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Experiments summary: Обновление эксперимента description: Переименование \ перемещение эксперимента. operationId: update_experiment requestBody: description: Запрос на обновление описания эксперимента. required: true content: application/json: schema: $ref: '#/components/schemas/experiment_specification' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Experiments summary: Удаление эксперимента description: Удаление эксперимента по ключу. operationId: delete_experiment responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/duplication: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Experiments summary: Дублирование эксперимента description: Дублирование эксперимента. operationId: duplicate_experiment requestBody: description: Запрос на дублирование эксперимента. required: true content: application/json: schema: $ref: '#/components/schemas/experiment_specification' description: Параметры нового эксперимента, который получится в результате дублирования. responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/unique_key' description: Ключ продублированного эксперимента. '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/settings: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Experiments summary: Обновление настроек description: Обновление настроек. operationId: update_experiment_settings requestBody: description: Запрос на обновление настроек эксперимента. required: true content: application/json: schema: $ref: '#/components/schemas/experiment_settings' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/indicators: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Experiments summary: Обновление индикаторов description: Обновление индикаторов. operationId: update_experiment_indicators requestBody: description: Запрос на обновление индикаторов эксперимента. required: true content: application/json: schema: $ref: '#/components/schemas/indicators' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/calculation/{process_name}: post: tags: - Experiments summary: Запуск расчета description: Запуск расчета эксперимента. operationId: run_experiment_calculation parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/process_name' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' examples: Experiment: $ref: '#/components/examples/Experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/calculation: delete: tags: - Experiments summary: Остановка расчета description: Остановка расчета. operationId: stop_experiment_calculation parameters: - $ref: '#/components/parameters/experiment_key' responses: '204': description: Успешное выполнение - расчет отменен '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/validation/{process_name}: post: tags: - Experiments summary: Запуск валидации description: Запуск валидации данных эксперимента. operationId: run_experiment_validation parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/process_name' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' examples: Experiment: $ref: '#/components/examples/Experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/import/xlsx: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Experiments summary: Импорт (XLSX) description: 'Импорт новых данных из файла формата XLSX. Если сущность уже присутствует в эксперименте (определяется по ее ключу) - она обновляется, если нет - создается новая. ' operationId: import_xlsx parameters: - $ref: '#/components/parameters/timezone' requestBody: description: Данные (XLSX). required: true content: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet: schema: $ref: '#/components/schemas/file_xlsx' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/import/json: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Experiments summary: Импорт (JSON) description: 'Импорт новых данных из файла формата VRt.Universal JSON. Если сущность уже присутствует в эксперименте (определяется по ее ключу) - она обновляется, если нет - создается новая. ' operationId: import_json requestBody: description: Данные (JSON). required: true content: application/json: schema: $ref: '#/components/schemas/universal_data' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/import/json_url: post: tags: - Experiments summary: Импорт по URL (JSON) description: 'Импорт новых данных из файла формата VRt.Universal JSON по ссылке. Если сущность уже присутствует в эксперименте (определяется по ее ключу) - она обновляется, если нет - создается новая. ' operationId: import_json_url parameters: - $ref: '#/components/parameters/experiment_key' - name: url description: Url json файла. in: query required: true schema: description: Url. type: string format: uri example: https://docs.edge.veeroute.tech/assets/files/case_1.json responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/import/json_tracecode/{source}/{tracecode}/{sample}: post: tags: - Experiments summary: Импорт по tracecode description: 'Импорт новых данных из файла формата VRt.Universal JSON по tracecode. Если сущность уже присутствует в эксперименте (определяется по ее ключу) - она обновляется, если нет - создается новая. ' operationId: import_json_tracecode parameters: - $ref: '#/components/parameters/experiment_key' - name: source description: Источник. in: path required: true schema: $ref: '#/components/schemas/import_source' - $ref: '#/components/parameters/tracecode' - name: sample description: Выборка загружаемых данных - входная задача или входная задача + результат расчета. in: path required: true schema: $ref: '#/components/schemas/import_sample' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/experiment' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/export/xlsx: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Experiments summary: Экспорт (XLSX) description: Экспортировать (XLSX). operationId: export_xlsx parameters: - $ref: '#/components/parameters/timezone' responses: '200': description: Успешное выполнение content: application/octet-stream: schema: $ref: '#/components/schemas/file_xlsx' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/export/json: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Experiments summary: Экспорт (JSON) description: 'Экспортировать данные из эксперимента в файл формата VRt.Universal JSON. ' operationId: export_json responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/universal_data' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/locations/batch/list: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Locations summary: Список локаций description: Получение списка локаций. operationId: read_locations parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_location_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр локаций. required: false content: application/json: schema: $ref: '#/components/schemas/table_location_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_location_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/locations: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Locations summary: Создание локации description: Создание локации. operationId: create_location requestBody: description: Запрос на создание нового локации. required: true content: application/json: schema: $ref: '#/components/schemas/web_location' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_location' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Locations summary: Обновление локации description: Обновление локации по ее ключу. operationId: update_location requestBody: description: Запрос на обновление локации. required: true content: application/json: schema: $ref: '#/components/schemas/web_location' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_location' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/locations/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Locations summary: Чтение локации description: Получение информации о локации по ее ключу. operationId: read_location responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_location' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Locations summary: Удаление локации description: Удаление локации по ее ключу. operationId: delete_location responses: '204': description: Успешное выполнение - локация удалена '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/locations/batch/geopoints: post: tags: - Locations summary: Геоточки локаций description: Получение списка геоточек. operationId: read_locations_geopoints parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' requestBody: description: Фильтр локаций. required: false content: application/json: schema: $ref: '#/components/schemas/table_location_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_location_geopoint_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/performers/batch/list: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Performers summary: Список исполнителей description: Получение списка исполнителей. operationId: read_performers parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_performer_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр исполнителей. required: false content: application/json: schema: $ref: '#/components/schemas/table_performer_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_performer_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/performers: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Performers summary: Создание исполнителя description: Создание исполнителя. operationId: create_performer requestBody: description: Запрос на создание нового исполнителя. required: true content: application/json: schema: $ref: '#/components/schemas/web_performer' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_performer' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Performers summary: Обновление исполнителя description: Обновление исполнителя по его ключу. operationId: update_performer requestBody: description: Запрос на обновление исполнителя. required: true content: application/json: schema: $ref: '#/components/schemas/web_performer' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_performer' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/performers/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Performers summary: Чтение исполнителя description: Получение информации об исполнителе по его ключу. operationId: read_performer responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_performer' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Performers summary: Удаление исполнителя description: Удаление исполнителя по его ключу. operationId: delete_performer responses: '204': description: Успешное выполнение - исполнитель удален '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/performers/batch/geopoints: post: tags: - Performers summary: Геоточки исполнителей description: Получение списка геоточек. operationId: read_performers_geopoints parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' requestBody: description: Фильтр исполнителей. required: false content: application/json: schema: $ref: '#/components/schemas/table_performer_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_performer_geopoint_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/performers/batch/ability: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Performers summary: Включение исполнителей description: Включение исполнителей в расчет. operationId: enable_performers requestBody: description: Запрос на включение исполнителей. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Performers summary: Выключение исполнителей description: Выключение исполнителей из расчета. operationId: disable_performers requestBody: description: Запрос на выключение исполнителей. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/transports/batch/list: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Transports summary: Список транспорта description: Получение списка транспорта. operationId: read_transports parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_transport_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр транспорта. required: false content: application/json: schema: $ref: '#/components/schemas/table_transport_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_transport_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/transports: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Transports summary: Создание транспорта description: Создание транспорта. operationId: create_transport requestBody: description: Запрос на создание нового транспорта. required: true content: application/json: schema: $ref: '#/components/schemas/web_transport' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_transport' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Transports summary: Обновление транспорта description: Обновление транспорта по ее ключу. operationId: update_transport requestBody: description: Запрос на обновление транспорта. required: true content: application/json: schema: $ref: '#/components/schemas/web_transport' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_transport' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/transports/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Transports summary: Чтение транспорта description: Получение информации о транспорте по его ключу. operationId: read_transport responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_transport' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Transports summary: Удаление транспорта description: Удаление транспорта по ее ключу. operationId: delete_transport responses: '204': description: Успешное выполнение - транспорт удален '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/transports/batch/geopoints: post: tags: - Transports summary: Геоточки транспорта description: Получение списка геоточек. operationId: read_transports_geopoints parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' requestBody: description: Фильтр транспорта. required: false content: application/json: schema: $ref: '#/components/schemas/table_transport_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_transport_geopoint_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/transports/batch/ability: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Transports summary: Включение транспорта description: Включение транспорта в расчет. operationId: enable_transports requestBody: description: Запрос на включение транспорта. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Transports summary: Выключение транспорта description: Выключение транспорта из расчета. operationId: disable_transports requestBody: description: Запрос на выключение транспорта. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/orders/batch/list: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Orders summary: Список заказов description: Получение списка заказов. operationId: read_orders parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_order_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр заказов. required: false content: application/json: schema: $ref: '#/components/schemas/table_order_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_order_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/orders: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Orders summary: Создание заказа description: Создание заказа. operationId: create_order requestBody: description: Запрос на создание новой сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_order' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_order' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Orders summary: Обновление заказа description: Обновление сущности по ее ключу. operationId: update_order requestBody: description: Запрос на обновление сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_order' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_order' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/orders/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Orders summary: Чтение заказа description: Получение информации о заказе по его ключу. operationId: read_order responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_order' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Orders summary: Удаление заказа description: Удаление заказа по его ключу. operationId: delete_order responses: '204': description: Успешное выполнение - сущность удалена '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/orders/batch/geopoints: post: tags: - Orders summary: Геоточки заказов description: Получение списка геоточек. operationId: read_orders_geopoints parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' requestBody: description: Фильтр заказов. required: false content: application/json: schema: $ref: '#/components/schemas/table_order_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_order_geopoint_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/orders/batch/ability: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Orders summary: Включение заказов description: Включение заказов в расчет. operationId: enable_orders requestBody: description: Запрос на включение заказов. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Orders summary: Выключение заказов description: Выключение заказов из расчета. operationId: disable_orders requestBody: description: Запрос на выключение заказов. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/hardlinks/batch/list: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Hardlinks summary: Список назначений description: Получение списка назначений. operationId: read_hardlinks parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_hardlink_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр назначений. required: false content: application/json: schema: $ref: '#/components/schemas/table_hardlink_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_hardlink_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/hardlinks: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Hardlinks summary: Создание назначения description: Создание назначения. operationId: create_hardlink requestBody: description: Запрос на создание новой сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_hardlink' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_hardlink' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Hardlinks summary: Обновление назначения description: Обновление назначения по ключу. operationId: update_hardlink requestBody: description: Запрос на обновление сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_hardlink' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_hardlink' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/hardlinks/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Hardlinks summary: Чтение назначения description: Получение информации о назначении по его ключу. operationId: read_hardlink responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_hardlink' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Hardlinks summary: Удаление назначения description: Удаление назначения по ключу. operationId: delete_hardlink responses: '204': description: Успешное выполнение - сущность удалена '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/hardlinks/batch/ability: parameters: - $ref: '#/components/parameters/experiment_key' put: tags: - Hardlinks summary: Включение назначений description: Включение назначений в расчет. operationId: enable_hardlinks requestBody: description: Запрос на включение назначений. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Hardlinks summary: Выключение назначений description: Выключение назначений из расчета. operationId: disable_hardlinks requestBody: description: Запрос на выключение назначений. required: true content: application/json: schema: $ref: '#/components/schemas/basic_essence_key_list' responses: '204': description: Успешное выполнение '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/trips/batch/list: post: tags: - Trips summary: Список рейсов description: Получение списка рейсов. operationId: read_trips parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_trip_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр рейсов. required: false content: application/json: schema: $ref: '#/components/schemas/table_trip_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/table_trip_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/trips: parameters: - $ref: '#/components/parameters/experiment_key' post: tags: - Trips summary: Создание рейса description: Создание рейса. operationId: create_trip requestBody: description: Запрос на создание новой сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_trip' responses: '201': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_trip' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' put: tags: - Trips summary: Обновление рейса description: Обновление рейса по ее ключу. operationId: update_trip requestBody: description: Запрос на обновление сущности. required: true content: application/json: schema: $ref: '#/components/schemas/web_trip' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_trip' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/trips/{essence_key}: parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/essence_key' get: tags: - Trips summary: Чтение рейса description: Получение информации о рейсе по его ключу. operationId: read_trip responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_trip' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' delete: tags: - Trips summary: Удаление рейса description: Удаление рейса по ключу. operationId: delete_trip responses: '204': description: Успешное выполнение - рейс удален '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/trips/batch/tracks/{tracks_type}: post: tags: - Trips summary: Пути рейсов description: Получение путей. operationId: read_trips_tracks parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/tracks_type' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' requestBody: description: Фильтр рейсов. required: false content: application/json: schema: $ref: '#/components/schemas/table_trip_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_trip_track_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/experiments/{experiment_key}/trips/batch/charts: post: tags: - Trips summary: Диаграмма рейсов description: Получение рейсов для отображения на диаграмме. operationId: read_trips_charts parameters: - $ref: '#/components/parameters/experiment_key' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/table_trip_column' - $ref: '#/components/parameters/sort_direction' requestBody: description: Фильтр рейсов. required: false content: application/json: schema: $ref: '#/components/schemas/table_trip_filter_list' responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/web_trip_chart_list' '400': $ref: '#/components/responses/400_with_errors_and_warnings' '401': $ref: '#/components/responses/401' '402': $ref: '#/components/responses/402' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/system/check: get: tags: - System summary: Проверка доступности description: Проверка доступности сервиса. operationId: check security: [] responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/check_result' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/system/version: get: tags: - System summary: Получение версии сервиса description: Получение версии сервиса. operationId: version security: [] responses: '200': description: Успешное выполнение content: application/json: schema: $ref: '#/components/schemas/version_result' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' /studio/file/{filename}: parameters: - $ref: '#/components/parameters/filename' get: tags: - System summary: Получение документации description: Получение файла с документацией на этот сервис. operationId: file security: [] responses: '200': description: Успешное выполнение content: text/html: schema: $ref: '#/components/schemas/file_html' text/plain: schema: $ref: '#/components/schemas/file_json' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '415': $ref: '#/components/responses/415' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' '501': $ref: '#/components/responses/501' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' '504': $ref: '#/components/responses/504' default: $ref: '#/components/responses/503' components: securitySchemes: ApiKeyAuth: description: "Для [аутентификации](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)\ \ клиента \nиспользуется [JWT токен](https://ru.wikipedia.org/wiki/JSON_Web_Token),\ \ \nкоторый необходимо указывать в заголовке для каждого запроса в формате:\n\ \n`Authorization: Bearer `.\n\nУникальный токен для пользовательского\ \ аккаунта необходимо получить с помощью VRt.Account API.\n" type: http scheme: bearer bearerFormat: JWT responses: '401': description: 'Ошибка доступа - токен отсутствует или невалиден ' content: application/json: schema: $ref: '#/components/schemas/general_401' '402': description: Необходима оплата content: application/json: schema: $ref: '#/components/schemas/general_402' '403': description: 'Действие запрещено - уровень прав доступа не позволяет совершить данное действие ' content: application/json: schema: $ref: '#/components/schemas/general_403' '404': description: Запрашиваемая сущность не найдена content: application/json: schema: $ref: '#/components/schemas/general_404' '405': description: 'Метод запрещен для данного ресурса, проверьте указанный метод (POST, GET, ...) ' '406': description: 'Клиент не способен обработать формат ответа, проверьте заголовки ' '415': description: 'Неприемлемый формат запроса, проверьте заголовки ' '429': description: Превышено количество запросов content: application/json: schema: $ref: '#/components/schemas/general_429' '500': description: Внутренняя ошибка сервера content: application/json: schema: $ref: '#/components/schemas/general_500' '501': description: Функциональность не доступна для использования '502': description: Неверный шлюз '503': description: Сервис не доступен '504': description: Шлюз не отвечает 400_with_errors_and_warnings: description: Неверный запрос - данные содержат ошибки content: application/json: schema: $ref: '#/components/schemas/custom_400_with_errors_and_warnings' examples: Result400: $ref: '#/components/examples/Result400' schemas: unique_key: description: Ключ, уникальный идентификатор. type: string format: uuid example: 11111111-2222-3333-4444-555555555555 folder_type: description: "Тип элемента:\n * `ROOT` - корневой объект\n * `FOLDER` - папка\n" type: string enum: - ROOT - FOLDER example: FOLDER folder_stats: description: 'Стастика по текущей папке. ' type: object additionalProperties: false properties: folders_count: description: Количество вложенных папок. type: integer format: int32 minimum: 0 maximum: 10001 example: 12 experiments_count: description: Количество вложенных экспериментов. type: integer format: int32 minimum: 0 maximum: 10001 example: 16 required: - folders_count - experiments_count filesystem: description: 'Файловая система. Только один объект может иметь тип ROOT. ' type: object additionalProperties: false properties: key: $ref: '#/components/schemas/unique_key' type: $ref: '#/components/schemas/folder_type' name: description: Название папки. type: string minLength: 1 maxLength: 100 example: folder_1 statistics: $ref: '#/components/schemas/folder_stats' elements: description: Список дочерних элементов. type: array readOnly: true uniqueItems: false minItems: 0 maxItems: 101 items: $ref: '#/components/schemas/filesystem' required: - key - type - name - statistics service_name: description: Название сервиса. type: string enum: - UNIVERSAL - ROUTING - ACCOUNT - ADMIN - STUDIO - MONITOR - PACKER - AGRO - STOCK - LONGHAUL - CLUSTER - CARGOTIMETABLE example: UNIVERSAL operation_id: description: Идентификатор операции. type: string minLength: 3 maxLength: 256 example: run_plan_calculation tracedata: description: Данные используемые для трассировки запросов. type: object additionalProperties: false properties: code: description: 'Уникальный идентификатор процесса. Если запущен асинхронный процесс, то код для него будет одинаковый, хотя другие поля могут отличаться. ' type: string format: uuid example: 11111111-2222-3333-4444-555555555555 client: description: 'Уникальный идентификатор клиента (`company_key` + `_|_` + `username`), который совершил запрос. ' type: string pattern: \w+ minLength: 2 maxLength: 256 example: company_|_username server: description: Уникальный идентификатор сервера. type: string pattern: \w+ minLength: 2 maxLength: 256 example: server_name service: $ref: '#/components/schemas/service_name' operation: $ref: '#/components/schemas/operation_id' time: description: Дата и время вызова метода сервиса в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). type: string format: date-time example: '2024-02-21T09:30:00+03:00' required: - code - client - server - service - operation - time schema_error: description: Ошибка по схеме. type: object additionalProperties: false properties: entity: description: Идентификатор целевой сущности. type: string nullable: true maxLength: 1024 example: order_0001 message: description: Сообщение об ошибке. type: string example: bad input data required: - entity - message schema_error_list: description: Список ошибок. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/schema_error' example: [] entity_error_type: description: "Тип ошибки:\n * `INCONSISTENT_REFERENCE` - ссылка на несуществующую\ \ сущность\n * `UNIQUE_IDS_VIOLATION` - все идентификаторы должны быть уникальными\n\ \ * `INVALID_ROUTING_MATRIX` - проблема с размерностью матрицы гео-данных\n\ \ * `INVALID_GEO_PROVIDER` - проблема с указанным гео-провайдером\n * `COMPATIBILITY_CARGO_BOX`\ \ - ни один груз не совместим ни с одним отсеком\n * `COMPATIBILITY_TRANSPORT_PERFORMER`\ \ - ни один транспорт не совместим ни с одним исполнителем\n * `COMPATIBILITY_TRANSPORT_LOCATION`\ \ - ни один транспорт не совместим ни с одной локацией\n * `COMPATIBILITY_ORDER_PERFORMER`\ \ - ни один заказ не совместим ни с одним транспортом\n * `INCONSISTENT_HARDLINK`\ \ - ключ сущности должен находиться только в одной связи\n * `PLANNING_HORIZON_EXCEEDED`\ \ - превышен горизонт планирования (разница между самой ранней и самой поздней\ \ временными отметками)\n * `TOO_MANY_WARNINGS` - количество предупреждений\ \ (`warning`) больше 15 000\n" type: string enum: - INCONSISTENT_REFERENCE - UNIQUE_IDS_VIOLATION - INVALID_ROUTING_MATRIX - INVALID_GEO_PROVIDER - COMPATIBILITY_CARGO_BOX - COMPATIBILITY_TRANSPORT_PERFORMER - COMPATIBILITY_TRANSPORT_LOCATION - COMPATIBILITY_ORDER_PERFORMER - INCONSISTENT_HARDLINK - PLANNING_HORIZON_EXCEEDED - TOO_MANY_WARNINGS example: INCONSISTENT_REFERENCE entity_type: description: Тип сущности. type: string enum: - TASK - SETTINGS - ORDER - ORDER_LINK - PERFORMER - PERFORMER_LINK - TRANSPORT - TRANSPORT_LINK - HARDLINK - HARDLINK_LINK - LOCATION - LOCATION_LINK - BOX - BOX_LINK - TRIP - TRIP_LINK - CARGO - CARGO_LINK - DEMAND - DEMAND_LINK - EVENT - EVENT_LINK - PERFORMER_SHIFT - PERFORMER_SHIFT_LINK - TRANSPORT_SHIFT - TRANSPORT_SHIFT_LINK example: ORDER entity_path: description: 'Описание сущности и путь до нее. ' type: object additionalProperties: false nullable: true properties: entity_key: description: Ключ целевой сущности. type: string nullable: true maxLength: 1024 example: order_0001 entity_type: $ref: '#/components/schemas/entity_type' child_entity: $ref: '#/components/schemas/entity_path' required: - entity_key - entity_type entity_error: description: Описание ошибки во входных данных. type: object additionalProperties: false properties: type: $ref: '#/components/schemas/entity_error_type' info: description: Информация об ошибке. type: string nullable: true minLength: 0 maxLength: 2048 example: entity error entities: description: Список сущностей, которые вызвали ошибку. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/entity_path' required: - type - entities entity_error_list: description: 'Список ошибок в исходных данных, из-за которых запуск расчета невозможен. ' type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/entity_error' entity_warning_type: description: "Тип предупреждения:\n * `NO_AVAILABLE_TRANSPORT` - заказ не возможно\ \ выполнить, так как нет ни одного доступного (по ограничениям смен) транспорта\n\ \ * `NO_AVAILABLE_PERFORMER` - заказ не возможно выполнить, так как нет ни\ \ одного доступного (по ограничениям смен) исполнителя\n * `NO_COMPATIBLE_TRANSPORT`\ \ - заказ не возможно выполнить, так как нет ни одного совместимого (по вместимости\ \ и\\или тегам совместимости) транспорта\n * `NO_COMPATIBLE_PERFORMER` -\ \ заказ не возможно выполнить, так как нет ни одного совместимого (по тегам\ \ совместимости) исполнителя\n * `PICKUP_AND_DROP_VIOLATION` - для каждого\ \ груза в рамках заказа должна быть ровно одна погрузка и ровно одна выгрузка\ \ (кроме заявок `PICKUP_TO_BOX` и `DROP_FROM_BOX`)\n * `PICKUP_AND_DROP_VIOLATION_PRECEDENCE_IN_ORDER`\ \ - для каждого груза в рамках заказа должна погрузка должна идти перед выгрузкой\ \ (`precedence_in_order`)\n * `PICKUP_AND_DROP_VIOLATION_PRECEDENCE_IN_TRIP`\ \ - заданы противоречивые требования на порядок следования заявок (`precedence_in_trip`)\n\ \ * `VIOLATION_PRECEDENCE_IN_TRIP_AND_ORDER` - требования на порядок следования\ \ заявок в рейсе (`precedence_in_trip`) и в заказе (`precedence_in_order`)\ \ противоречат друг другу\n * `TIME_WINDOW_VIOLATION` - время начала временного\ \ окна позже времени окончания окна или временное окно превышает максимально\ \ допустимое\n * `DURATION_VIOLATION` - продолжительность не соответствует\ \ разрешенному интервалу\n * `ORDER_WINDOWS_INTERSECTION_VIOLATION` - мягкие\ \ окна не должны выходить за границы жесткого окна\n * `PERFORMER_SHIFTS_INTERSECTION_VIOLATION`\ \ - рабочие смены исполнителя не должны пересекаться \n * `TRANSPORT_SHIFTS_INTERSECTION_VIOLATION`\ \ - рабочие смены транспорта не должны пересекаться\n * `LOCATION_WINDOWS_INTERSECTION_VIOLATION`\ \ - временные диапазоны рабочих окон одной локации не должны пересекаться\n\ \ * `INVALID_LOCATION_DURATIONS` - у локации есть рабочее окно которое меньше\ \ суммы времен `arrival + departure`\n * `NO_TRANSPORT_BOXES` - если существуют\ \ заказы с грузом - то у транспорта должен быть хотя бы один отсек \n * `MAX_CAPACITY_VIOLATION`\ \ - ограничение `max_capacity` превышает суммарную вместимость всех отсеков\ \ или указывается для одного отсека или меньше вместимости какого-то отсека\n\ \ * `MAX_BOXES_VIOLATION` - ограничение `max_boxes` больше или равно суммарного\ \ количества отсеков или указывается для одного отсека или равно нулю\n *\ \ `TOO_MANY_CARGOS_FOR_DROP_VIOLATION` - количество грузов для заявки, имеющей\ \ тип `DROP` / `DROP_FROM_BOX`, должно быть не больше единицы\n * `EMPTY_CARGOES_LIST`\ \ - пустой список грузов у заявок, имеющих тип `DROP` / `DROP_FROM_BOX` /\ \ `PICKUP` / `PICKUP_TO_BOX`\n * `CARGO_WORK_VIOLATION` - у заявки типа `WORK`\ \ список грузов должен быть пустой\n * `GEODATA_TIME_WINDOW_VIOLATION` -\ \ горизонт планирования превышает максимально доступное значение\n * `SHIFT_RESTRICTIONS_COULD_BE_MORE_PRECISE`\ \ - рабочее окно `working_window` смены исполнителя не лежит полностью внутри\ \ окна доступности `availability_window`\n * `DURATION_DOES_NOT_FIT_INTO_HARD_WINDOW`\ \ - продолжительность события не помещается в жесткое временное окно\n *\ \ `DURATION_DOES_NOT_FIT_INTO_SOFT_WINDOW` - продолжительность события не\ \ помещается в мягкое временное окно\n * `EXTRA_DURATION_DOES_NOT_FIT_INTO_SOFT_WINDOW`\ \ - дополнительное время на выполнение заявки не помещается в мягкое временное\ \ окно\n * `MAX_CALCULATION_TIME_VIOLATION` - превышено максимальное допустимое\ \ время расчета\n * `MAX_WAITING_TIME_VIOLATION` - превышено максимальное\ \ допустимое время ожидания\n * `INVALID_HARDLINK` - связь невозможно учесть,\ \ нельзя назначать на транспорт заказ с заявками с типом `WORK`\n * `CARGO_BOX_VIOLATION`\ \ - для заявок всех типов кроме `DROP_FROM_BOX` ключ отсека, где находится\ \ груз, должен быть пустым\n * `CARGO_MULTIBOX_VIOLATION` - для заявки типа\ \ `DROP_FROM_BOX` указанные грузы находятся в отсеках разных транспортов\n\ \ * `CARGO_CAPACITY_VIOLATION` - указанный груз на борту превышает размеры\ \ отсека, в котором он находится\n * `CARGO_ORDER_VIOLATION` - указанный\ \ в заказе груз не присутствует в заявках\n * `FEATURE_LIFETIME_VIOLATION`\ \ - окна свойств пересекаются между собой или рабочее окно `working_window`\ \ смены исполнителя или транспорта не пересекается с временным окном свойства\n" type: string enum: - NO_AVAILABLE_TRANSPORT - NO_AVAILABLE_PERFORMER - NO_COMPATIBLE_TRANSPORT - NO_COMPATIBLE_PERFORMER - PICKUP_AND_DROP_VIOLATION - PICKUP_AND_DROP_VIOLATION_PRECEDENCE_IN_ORDER - PICKUP_AND_DROP_VIOLATION_PRECEDENCE_IN_TRIP - VIOLATION_PRECEDENCE_IN_TRIP_AND_ORDER - TIME_WINDOW_VIOLATION - DURATION_VIOLATION - ORDER_WINDOWS_INTERSECTION_VIOLATION - PERFORMER_SHIFTS_INTERSECTION_VIOLATION - TRANSPORT_SHIFTS_INTERSECTION_VIOLATION - LOCATION_WINDOWS_INTERSECTION_VIOLATION - INVALID_LOCATION_DURATIONS - NO_TRANSPORT_BOXES - MAX_CAPACITY_VIOLATION - MAX_BOXES_VIOLATION - TOO_MANY_CARGOS_FOR_DROP_VIOLATION - EMPTY_CARGOES_LIST - CARGO_WORK_VIOLATION - GEODATA_TIME_WINDOW_VIOLATION - SHIFT_RESTRICTIONS_COULD_BE_MORE_PRECISE - DURATION_DOES_NOT_FIT_INTO_HARD_WINDOW - DURATION_DOES_NOT_FIT_INTO_SOFT_WINDOW - EXTRA_DURATION_DOES_NOT_FIT_INTO_SOFT_WINDOW - MAX_CALCULATION_TIME_VIOLATION - MAX_WAITING_TIME_VIOLATION - INVALID_HARDLINK - CARGO_BOX_VIOLATION - CARGO_MULTIBOX_VIOLATION - CARGO_CAPACITY_VIOLATION - CARGO_ORDER_VIOLATION - FEATURE_LIFETIME_VIOLATION example: TIME_WINDOW_VIOLATION entity_warning: description: Описание предупреждения. type: object additionalProperties: false properties: type: $ref: '#/components/schemas/entity_warning_type' info: description: Информация о предупреждении. type: string nullable: true minLength: 0 maxLength: 2048 example: entity warning entities: description: Список сущностей, которые относятся к предупреждению. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/entity_path' required: - type - entities entity_warning_list: description: Список предупреждений. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/entity_warning' example: [] custom_400_with_errors_and_warnings: description: Детализация по ошибке 400. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: bad task data schema_errors: $ref: '#/components/schemas/schema_error_list' logical_errors: $ref: '#/components/schemas/entity_error_list' warnings: $ref: '#/components/schemas/entity_warning_list' required: - tracedata general_401: description: Детализация по ошибке 401. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: Unauthorized required: - tracedata general_402: description: Детализация по ошибке 402. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: Payment Required required: - tracedata general_403: description: Детализация по ошибке 403. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: Forbidden required: - tracedata general_404: description: Детализация по ошибке 404. type: object additionalProperties: false properties: resource_id: description: Идентификатор ресурса. type: string nullable: true default: null example: resource_id detail: description: Детализация по ресурсу. type: object additionalProperties: false nullable: true properties: tracedata: $ref: '#/components/schemas/tracedata' required: - tracedata general_429: description: Детализация по ошибке 429. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: Too many requests required: - tracedata general_500: description: Детализация по ошибке 500. type: object additionalProperties: false properties: tracedata: $ref: '#/components/schemas/tracedata' message: description: Сообщение об ошибке. type: string nullable: true example: Internal Server Error required: - tracedata folder_specification: description: Запрос на создание новой папки. type: object additionalProperties: false properties: parent_key: $ref: '#/components/schemas/unique_key' description: Ключ папки, в которой будет создана новая папка. name: description: Название новой папки. type: string minLength: 1 maxLength: 100 example: folder_1_new required: - parent_key - name experiment_specification: description: Описание эксперимента. type: object additionalProperties: false properties: name: description: Название эксперимента. type: string minLength: 1 maxLength: 100 example: Exp_1 comment: description: Комментарий к эксперименту. type: string nullable: true default: null minLength: 0 maxLength: 10000 example: long long long long text folder_key: $ref: '#/components/schemas/unique_key' description: Ключ папки типа `FOLDER`, в которой находится эксперимент. required: - name - comment - folder_key plan_configuration: description: "Название конфигурации планирования.\nКонфигурация определяет цель\ \ и качество результата. \n[Перечень доступных](#section/Opisanie/Konfiguraciya-planirovaniya)\ \ конфигураций планирования." type: string minLength: 1 maxLength: 256 default: default example: optimize_distance trip_start_time_strategy: description: "Стратегия выбора оптимального времени начала рейса:\n * `EARLIEST_FINISH`\ \ - оптимальное время начала рейса с целью пораньше завершить все заказы.\n\ \ * `LOWEST_COST` - оптимальное время рейса с целью увеличения процента попаданий\ \ в мягкие временные окна и минимизации общей стоимости рейса.\n" type: string enum: - EARLIEST_FINISH - LOWEST_COST default: EARLIEST_FINISH example: LOWEST_COST transport_type: description: "Типы транспорта:\n * `CAR` - легковой автомобиль\n * `TRUCK_1500`\ \ - грузовой автомобиль с разрешенной массой не более 1500 кг\n * `TRUCK_3000`\ \ - грузовой автомобиль с разрешенной массой не более 3000 кг\n * `TRUCK_5000`\ \ - грузовой автомобиль с разрешенной массой не более 5000 кг\n * `TRUCK_10000`\ \ - грузовой автомобиль с разрешенной массой не более 10000 кг\n * `TRUCK_20000`\ \ - грузовой автомобиль с разрешенной массой не более 20000 кг\n * `TRUCK_GARBAGE_1`\ \ - грузовой автомобиль для перевозки мусора (тип 1) \n * `TRUCK_GARBAGE_2`\ \ - грузовой автомобиль для перевозки мусора (тип 2)\n * `TUK_TUK` - моторикша\n\ \ * `BICYCLE` - велосипед\n * `PEDESTRIAN` - пешеход \n * `PUBLIC_TRANSPORT`\ \ - общественный транспорт\n\nРазрешенная масса - это масса снаряженного транспорта\ \ с грузом и водителем, установленная предприятием-изготовителем в качестве\ \ максимально допустимой.\n" type: string enum: - CAR - TRUCK_1500 - TRUCK_3000 - TRUCK_5000 - TRUCK_10000 - TRUCK_20000 - TRUCK_GARBAGE_1 - TRUCK_GARBAGE_2 - TUK_TUK - BICYCLE - PEDESTRIAN - PUBLIC_TRANSPORT default: CAR example: CAR transport_factor: description: Коэффициент изменения скорости указанного типа транспорта. type: object additionalProperties: false properties: transport_type: $ref: '#/components/schemas/transport_type' speed: description: Множитель средней скорости транспорта. type: number format: double minimum: 0.1 maximum: 100000 example: 2.5 required: - transport_type - speed capacity: description: Характеритистики вместимости. type: object additionalProperties: false nullable: true properties: mass: description: Масса в килограммах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 10 volume: description: Объем в кубических метрах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 capacity_a: description: 'Дополнительный параметр (A) для измерения грузов и отсеков в альтернативных единицах измерения. Например, для учета грузов в штуках (у груза данный параметр равен единице, у отсека - максимальному количеству вмещаемых грузов). ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 capacity_b: description: 'Дополнительный параметр (B) для измерения грузов и отсеков в альтернативных единицах измерения. ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 capacity_c: description: 'Дополнительный параметр (C) для измерения грузов и отсеков в альтернативных единицах измерения. ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 3 capacity_factor: description: 'Коэффициенты изменения вместимости указанного типа транспорта. Умножает все соответствующие поля `capacity` у всех отсеков у всех транспортов указанного типа. ' type: object additionalProperties: false properties: transport_type: $ref: '#/components/schemas/transport_type' capacity: $ref: '#/components/schemas/capacity' required: - transport_type - capacity time_duration: description: 'Продолжительность временного отрезка в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). ' type: string format: duration x-custom-format: duration pattern: ^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$ minLength: 3 maxLength: 16 default: PT0S example: P1Y1M1DT2H12M34.3S demand_extra_duration: description: 'Дополнительное время выполнения заявки определенным исполнителем. ' type: object additionalProperties: false properties: demand_key: description: Ключ заявки, для событий которой необходимо увеличить время выполнения. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: demand01.1 performer_key: description: Ключ исполнителя. type: string minLength: 1 maxLength: 1024 example: performer0001 additional_duration: description: 'Дополнительное время выполнения всех событий указанной заявки для всех смен указанного исполнителя. В формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). ' $ref: '#/components/schemas/time_duration' required: - demand_key - performer_key - additional_duration compatibility_tag: description: Тег, используемый для определения [совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti). type: string minLength: 1 maxLength: 256 example: B1 time_window: description: Временное окно. type: object additionalProperties: false nullable: true properties: from: description: 'Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time example: '2024-02-21T09:30:00+03:00' to: description: 'Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time example: '2024-02-21T19:45:00Z' required: - from - to feature_lifetime: description: Время жизни тега. type: object additionalProperties: false properties: feature: $ref: '#/components/schemas/compatibility_tag' time_windows: description: 'Список временных окон, внутри которых существует указанный тег. Если на совместимость влияют несколько свойств с разными окнами - сущности будут считаться совместимыми внутри пересечения окон. ' type: array minItems: 1 maxItems: 4 uniqueItems: true items: $ref: '#/components/schemas/time_window' required: - feature - time_windows feature_lifetime_list: description: 'Список ограничения на время жизни тегов. ' type: array minItems: 0 maxItems: 1000 default: [] uniqueItems: true items: $ref: '#/components/schemas/feature_lifetime' trip_assumptions: description: 'Допущения при планировании. Предназначены для корректировки бизнес-логики планирования и массового изменения входных данных. ' type: object additionalProperties: false properties: transport_factor: description: Коэффициенты изменения скорости транспорта. type: array minItems: 0 maxItems: 12 default: [] uniqueItems: true items: $ref: '#/components/schemas/transport_factor' capacity_factor: description: 'Коэффициенты изменения вместимости транспорта. Изменяют параметры `capacity` у всех отсеков и `max_capacity` у транспорта. ' type: array minItems: 0 maxItems: 12 default: [] uniqueItems: true items: $ref: '#/components/schemas/capacity_factor' demands_extra_duration: description: 'Список дополнительных времен выполнения заявки определенными исполнителями. Действует для указанной пары исполнитель-заявка для всех смен исполнителя и всех вариантов исполнения заявки. ' type: array minItems: 0 maxItems: 15001 default: [] uniqueItems: true items: $ref: '#/components/schemas/demand_extra_duration' feature_lifetimes: deprecated: true description: 'Ограничения на время жизни свойств исполнителя и транспорта. Влияет только на совместимости Исполнитель-Заказ и Транспорт-Локация. ' $ref: '#/components/schemas/feature_lifetime_list' disable_compatibility: description: 'Отключить учет совместимостей. Если указано `true` - все становится совместимо со всем. ' type: boolean default: false example: true disable_capacity: description: 'Отключить учет вместимостей. Если указано `true` - весь транспорт вмещает неограниченное количество грузов. ' type: boolean default: false example: true same_order_time_window: description: 'Использовать для расчетов одинаковое (указанное) временное окно для заказов и заявок. Временное окно берется от начала самого раннего до конца самого позднего окна из всех заказов и заявок. ' type: boolean default: false example: true expand_shift_time_window: description: 'Расширить временное окно для смен исполнителей и транспорта. Левая граница первой смены одной сущности расширяется до левой границы указанного окна, правая до правой границы или начала следующего окна на эту же сущность. Каждая следующая смена сдвигает правую границу до следующей смены или до правой границы указанного окна. ' type: boolean default: false example: true compatibility_penalty: description: 'Штраф за нарушение совместимости. При учете нарушения совместимости с локацией штраф применяется за каждую остановку на локации. ' type: object additionalProperties: false properties: tag: $ref: '#/components/schemas/compatibility_tag' penalty: description: 'Штраф за нарушение совместимости по указанному тегу. ' type: number format: double minimum: 0 maximum: 1000000 example: 2000 required: - tag - penalty trip_penalties: description: 'Штрафы при планировании - возможность нарушить часть бизнес-правил. ' type: object additionalProperties: false properties: compatibilities: description: Штрафы за каждый факт нарушения совместимости. type: array uniqueItems: true minItems: 0 maxItems: 1000000 default: [] items: $ref: '#/components/schemas/compatibility_penalty' trips_settings: description: Настройки создания рейсов. type: object additionalProperties: false properties: configuration: $ref: '#/components/schemas/plan_configuration' trip_start_time_strategy: $ref: '#/components/schemas/trip_start_time_strategy' assumptions: $ref: '#/components/schemas/trip_assumptions' penalties: $ref: '#/components/schemas/trip_penalties' geo_settings: description: 'Настройки использования гео-данных. ' type: object additionalProperties: false properties: geo_provider: description: Поставщик гео-данных. type: string default: OSRM minLength: 1 maxLength: 256 example: OSRM toll_roads: description: Использовать платные дороги. type: boolean default: true example: false ferry_crossing: description: Использовать паромные переправы. type: boolean default: true example: false traffic_jams: description: Учет пробок при планировании маршрутов. type: boolean default: true example: false flight_distance: description: 'Использовать для расчетов расстояния по прямой. Если указано `false` - расстояния рассчитываются по дорогам. При включении данного параметра не используется поставщик гео-данных и автоматически выключается учет пробок (`traffic_jams`). ' type: boolean default: false example: true restricted_zones: description: 'Список зон, через которые запрещено проезжать. ' type: array deprecated: true minItems: 0 maxItems: 5 uniqueItems: true default: [] items: description: Идентификатор зоны. type: string minLength: 1 maxLength: 256 example: - ART_MOSCOW_MKAD_CARGO_FRAME calculation_settings: description: Настройки процесса расчета. type: object additionalProperties: false properties: max_calculation_time: description: 'Максимальное время расчета. Старт отсчета начинается от времени завершения загрузки данных на сервер и начала расчета. ' type: string format: duration x-custom-format: duration pattern: ^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$ minLength: 3 maxLength: 16 default: PT20M example: PT4M30S max_waiting_time: description: 'Максимальное время нахождения расчета в очереди. Старт отсчета начинается от времени завершения загрузки данных на сервер. ' type: string format: duration x-custom-format: duration pattern: ^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$ minLength: 3 maxLength: 16 default: PT20M example: PT2H result_ttl: description: 'Время жизни результата расчета. Старт отсчета начинается от времени завершения расчета. ' type: string format: duration x-custom-format: duration pattern: ^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$ minLength: 3 maxLength: 16 default: PT20M example: PT4M30S result_timezone: description: 'Временная зона, в которой возвращается результат расчета. ' type: integer format: int32 minimum: -12 maximum: 12 default: 0 example: 3 treat_warnings_as_errors: description: 'Относится к предупреждениям как к ошибкам и не запускать расчет если хотя бы одна сущность содержит невалидные данные. ' type: boolean default: false example: true precision: description: 'Указание точности полей типа double в порядковом номере знака после запятой. По умолчанию 2, т.е. точность 0.01. ' type: integer format: int32 minimum: 0 maximum: 6 default: 2 example: 3 plan_settings: description: Настройки планирования. type: object additionalProperties: false properties: trips_settings: $ref: '#/components/schemas/trips_settings' geo_settings: $ref: '#/components/schemas/geo_settings' calculation_settings: $ref: '#/components/schemas/calculation_settings' replan_strategy: description: Стратегия перепланирования. type: object additionalProperties: false properties: reorder: description: Возможность изменять существующий порядок выполнения заказов. type: boolean default: false example: true plan_new_orders: description: Возможность планировать новые заказы в существующие или новые (если включена опция `create_new_trips`) рейсы. type: boolean default: false example: true create_new_trips: description: Возможность создавать новые рейсы. type: boolean default: false example: true replan_settings: description: Настройки перепланирования. type: object additionalProperties: false properties: replan_strategy: $ref: '#/components/schemas/replan_strategy' trips_settings: $ref: '#/components/schemas/trips_settings' geo_settings: $ref: '#/components/schemas/geo_settings' calculation_settings: $ref: '#/components/schemas/calculation_settings' actualize_settings: description: 'Настройки актуализации. ' type: object additionalProperties: false properties: current_time: description: 'Указание даты и времени, которое для актуализации будет являться текущим, в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). Если не указано - берется текущее время получения запроса сервером. ' type: string format: date-time nullable: true example: '2024-02-21T09:30:00+03:00' geo_settings: $ref: '#/components/schemas/geo_settings' calculation_settings: $ref: '#/components/schemas/calculation_settings' experiment_settings: description: Настройки эксперимента. type: object additionalProperties: false properties: plan_settings: $ref: '#/components/schemas/plan_settings' replan_settings: $ref: '#/components/schemas/replan_settings' actualize_settings: $ref: '#/components/schemas/actualize_settings' required: - plan_settings - replan_settings - actualize_settings indicators: description: Список индикаторов. type: array uniqueItems: false minItems: 0 maxItems: 100 items: description: Ключ индикатора. type: string minLength: 2 maxLength: 256 example: - total_statistics_cost - total_statistics_measurements_waiting_time measurements: description: 'Измерения времен и дистанций для работ на локации, отдельных рейсов и планирования в целом. ' type: object additionalProperties: false properties: driving_time: $ref: '#/components/schemas/time_duration' waiting_time: $ref: '#/components/schemas/time_duration' break_time: $ref: '#/components/schemas/time_duration' working_time: $ref: '#/components/schemas/time_duration' arriving_time: $ref: '#/components/schemas/time_duration' departure_time: $ref: '#/components/schemas/time_duration' total_time: $ref: '#/components/schemas/time_duration' distance: description: Расстояние в метрах. type: integer format: int32 minimum: 0 maximum: 4000000000 example: 5200 time_window: $ref: '#/components/schemas/time_window' required: - driving_time - waiting_time - break_time - working_time - arriving_time - departure_time - total_time - distance - time_window object_metrics: description: Метрики объектов. type: object additionalProperties: false properties: keys: description: Список ключей объектов. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: description: Ключ объекта. type: string minLength: 1 maxLength: 1024 example: - obj1 count: description: Суммарное количество объектов. type: integer format: int32 minimum: 0 default: 0 maximum: 15001 example: 1700 time_window_violations: description: "Статистика по нарушениям временных окон. \n" type: object additionalProperties: false properties: before: $ref: '#/components/schemas/object_metrics' description: Количество и ключи заказов, у которые запланированы до наступления разрешенного временного окна. after: $ref: '#/components/schemas/object_metrics' description: Количество и ключи заказов, у которые запланированы после наступления разрешенного временного окна. quality_statistics: description: 'Статистические показатели качества. ' type: object additionalProperties: false properties: soft_time_window_violations: $ref: '#/components/schemas/time_window_violations' description: Статистика по нарушению мягких временных окон. hard_time_window_violations: $ref: '#/components/schemas/time_window_violations' description: Статистика по нарушению жестких временных окон. statistics: description: 'Общая статистика по одному либо совокупности рейсов. ' type: object additionalProperties: false properties: cost: description: 'Суммарные затраты, которые считаются на базе тарифов исполнителей и транспорта. Суммарная стоимость при этом равна разнице между суммарным вознаграждением (`reward`) и расходами (`cost`). ' type: number format: double minimum: 0 example: 1231.1 reward: description: Суммарное вознаграждение за выполнение заказов. type: number format: double minimum: 0 example: 2343.3 measurements: $ref: '#/components/schemas/measurements' description: "Измерения времен и дистанций для совокупности и отдельных\ \ рейсов:\n\n * `driving_time` - продолжительность времени вождения\n\ \ * `waiting_time` - суммарное время ожидания по всем локациям\n * `break_time`\ \ - суммарное время перерывов по всем локациям\n * `working_time` - суммарное\ \ время выполнения работ на всех локациях, входящих в рейс\n * `arriving_time`\ \ - суммарное время на подъезд/парковку на локациях\n * `departure_time`\ \ - суммарное время на отъезд от локаций\n * `time_window` - время начала\ \ первого рейса и время окончания последнего, если рейсов нет - возвращается\ \ время левой границы горизонта планирования, при этом поля from\\to имеют\ \ одинаковое значение\n * `total_time` - суммарное время, складывается\ \ из `driving_time` + `waiting_time` + `break_time` + `working_time` +\ \ `arriving_time` + `departure_time`\n * `distance` - суммарная протяжённость\ \ рейса/совокупности рейсов, в метрах\n" trips_count: description: Суммарное количество запланированных рейсов. type: integer format: int32 minimum: 0 maximum: 15001 example: 250 performers_count: description: Суммарное количество исполнителей, задействованных в выполнении заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 157 orders_count: description: Суммарное количество запланированных и назначенных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1700 plan_orders_count: description: Суммарное количество запланированных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1003 waitlist_orders_count: description: Суммарное количество назначенных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 697 cargo_capacity_ratio: $ref: '#/components/schemas/capacity' description: 'Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков. В долях единицы. Может быть больше единицы. ' max_transport_load: $ref: '#/components/schemas/capacity' description: 'Отношение максимальной загрузки отсеков к суммарной вместимости отсеков. В долях единицы. Не может быть больше единицы. ' quality: $ref: '#/components/schemas/quality_statistics' required: - cost - reward - measurements - trips_count - performers_count - orders_count - plan_orders_count - waitlist_orders_count - cargo_capacity_ratio - max_transport_load table_data_stats: description: Статистика по данным. type: object additionalProperties: false readOnly: true properties: locations: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 orders: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 performers: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 transports: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 hardlinks: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 trips: description: Количество элементов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 external_routing: description: Использование внешних матриц времен и расстояний. type: boolean example: false required: - locations - orders - performers - transports - hardlinks - trips - external_routing unplanned_items: description: Список незапланированных сущностей. type: object additionalProperties: false properties: order_keys: description: Список ключей незапланированных заказов. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: description: Ключ, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: key_01 order_keys_count: description: Количество незапланированных заказов. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 99 performer_keys: description: Список ключей исполнителей, не участвующих ни в одном рейсе. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: description: Ключ, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: key_01 performer_keys_count: description: Количество незапланированных исполнителей. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 99 transport_keys: description: Список ключей транспорта, не участвующих ни в одном рейсе. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: description: Ключ, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: key_01 transport_keys_count: description: Количество незапланированного транспорта. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 99 hardlink_keys: description: Список ключей связей, не участвующих ни в одном рейсе. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: description: Ключ, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: key_01 hardlink_keys_count: description: Количество незапланированных связей. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 99 experiment_statistics: description: Статистика эксперимента. type: object additionalProperties: false properties: indicators: $ref: '#/components/schemas/indicators' total_statistics: $ref: '#/components/schemas/statistics' data_statistics: $ref: '#/components/schemas/table_data_stats' unplanned_items: $ref: '#/components/schemas/unplanned_items' required: - indicators - total_statistics - data_statistics calculation_progress: description: 'Прогресс расчета в процентах. Прогресс отражает текущее количество завершенных шагов. ' type: integer format: int32 default: 0 minimum: 0 maximum: 100 example: 52 calculation_status: description: "Статус расчета:\n * `WAITING` - расчет ожидает запуска.\n *\ \ `IN_PROGRESS` - расчет в процессе.\n * `FINISHED_IN_TIME` - расчет завершился\ \ раньше указанного времени на планирование.\n * `FINISHED_OUT_OF_TIME` -\ \ расчет завершился, так как закончилось указанное время на планирование,\ \ при этом полученные маршруты могут не соответствовать целям планирования\ \ (при этом они гарантированно валидные).\n * `CANCELED` - расчет был отменен,\ \ так как была получена команда на отмену.\n * `CANCELED_BY_TIMEOUT` - расчет\ \ был отменен автоматически, так как превышено время ожидания в очереди.\n\ \ * `FAILED` - расчет завершился с ошибкой.\n" type: string enum: - WAITING - IN_PROGRESS - FINISHED_IN_TIME - FINISHED_OUT_OF_TIME - CANCELED - CANCELED_BY_TIMEOUT - FAILED example: FINISHED_IN_TIME calculation_info: description: Информация о расчете. type: object additionalProperties: false properties: status: $ref: '#/components/schemas/calculation_status' result_version: description: Версия текущего результата расчета. type: integer format: int32 minimum: 0 maximum: 1000000 example: 133 preparing_time: description: Время подготовки к расчету (конвертация данных), формат [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' business_validation_time: description: Время бизнес-проверки данных, формат [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' math_validation_time: description: Время математической проверки данных, формат [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' waiting_time: description: Время ожидания расчета в очереди, формат [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' calculation_time: description: Время фактического расчета, формат [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' required: - status - result_version - preparing_time - business_validation_time - math_validation_time - waiting_time - calculation_time experiment_calculation: description: Информация по расчету эксперимента. type: object additionalProperties: false nullable: true properties: progress: $ref: '#/components/schemas/calculation_progress' info: $ref: '#/components/schemas/calculation_info' tracedata: $ref: '#/components/schemas/tracedata' required: - progress - info - tracedata experiment_check: description: Результат проверки данных по эксперименту. type: object additionalProperties: false nullable: true properties: logical_errors: $ref: '#/components/schemas/entity_error_list' warnings: $ref: '#/components/schemas/entity_warning_list' basic_pristine: description: 'Флаг, показывающий производились ли изменения сущности относительно исходных данных. `true` - означает что данные исходные и не изменялись. ' type: boolean default: true example: false readOnly: true basic_sharing: description: 'Флаг совместного использования эксперимента. ' type: boolean default: false example: true readOnly: true experiment: description: Эксперимент. type: object additionalProperties: false properties: key: $ref: '#/components/schemas/unique_key' specification: $ref: '#/components/schemas/experiment_specification' settings: $ref: '#/components/schemas/experiment_settings' statistics: $ref: '#/components/schemas/experiment_statistics' progress: $ref: '#/components/schemas/calculation_progress' description: 'Прогресс расчета в процентах, отражает текущее количество завершенных шагов. Прогресс расчета эксперимента отличается от прогресса планирования, так как имеет большее количество шагов. ' calculation: $ref: '#/components/schemas/experiment_calculation' check: $ref: '#/components/schemas/experiment_check' pristine: $ref: '#/components/schemas/basic_pristine' sharing: $ref: '#/components/schemas/basic_sharing' edit_date: description: 'Дата и время последнего редактирования в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time example: '2024-02-21T19:45:00Z' creation_date: description: 'Дата и время создания в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time example: '2024-02-21T19:45:00Z' required: - key - specification - settings - pristine - statistics - edit_date - creation_date table_list_stats_detail: description: Детальная статистика по списку. type: object additionalProperties: false properties: total: description: Количество. type: integer format: int32 minimum: 0 maximum: 100000 example: 1 required: - total table_list_stats: description: Статистика по списку. type: object additionalProperties: false properties: overall: $ref: '#/components/schemas/table_list_stats_detail' description: Общая статистика, не зависит от фильтра. filter: $ref: '#/components/schemas/table_list_stats_detail' description: Статистика по отфильтрованным данным. required: - overall - filter experiment_list: description: Список экспериментов. type: object additionalProperties: false properties: experiments: description: Список экспериментов. type: array uniqueItems: false minItems: 0 maxItems: 101 items: $ref: '#/components/schemas/experiment' statistics: $ref: '#/components/schemas/table_list_stats' required: - experiments - statistics basic_process: description: "Название процесса обработки данных:\n * `PLAN` - планирование\n\ \ * `REPLAN` - перепланирование\n * `ACTUALIZE` - актуализация\n" type: string enum: - PLAN - REPLAN - ACTUALIZE default: PLAN example: ACTUALIZE file_xlsx: description: Файл с данными в формате [XLSX](https://ru.wikipedia.org/wiki/Microsoft_Excel). type: string format: byte geopoint: description: Географическая точка. type: object additionalProperties: false properties: latitude: description: Широта в градусах. type: number format: double minimum: -90 maximum: 90 example: 55.692789 longitude: description: Долгота в градусах. type: number format: double minimum: -180 maximum: 180 example: 37.554554 required: - latitude - longitude compatibility_tag_list: description: 'Список тегов которые определяют свойство или требование. ' type: array minItems: 0 maxItems: 1000 uniqueItems: true default: [] items: $ref: '#/components/schemas/compatibility_tag' location_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) локации с транспортом. ' type: object additionalProperties: false nullable: true properties: transport_restrictions: description: 'Список необходимых требований к транспорту. Используется для проверки совместимости транспорта с локацией. ' $ref: '#/components/schemas/compatibility_tag_list' attribute: description: Атрибут. type: object additionalProperties: false properties: key: description: Ключ атрибута. type: string minLength: 1 maxLength: 100 example: attribute_name value: description: Значение атрибута. type: string minLength: 0 maxLength: 2000 example: X51 required: - key - value attributes: description: Атрибуты. Используются для указания служебной информации. type: array minItems: 0 maxItems: 1000 uniqueItems: true default: [] items: $ref: '#/components/schemas/attribute' location: description: 'Локация - уникальное географическое местоположение объекта с параметрами доступности. ' type: object additionalProperties: false properties: key: description: Ключ локации, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: location01 geopoint: $ref: '#/components/schemas/geopoint' arrival_duration: description: Время на подъезд (парковку) на локации, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' departure_duration: description: Время на отъезд от локации, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' work_windows: description: 'Список временных окон работы локации. Если список пустой или не указан - локация работает без ограничений по времени. ' type: array uniqueItems: true minItems: 0 maxItems: 100 default: [] items: $ref: '#/components/schemas/time_window' compatibilities: $ref: '#/components/schemas/location_compatibilities' attributes: $ref: '#/components/schemas/attributes' required: - key - geopoint demand_type: description: "Тип заявки:\n * `PICKUP` - загрузка\n * `DROP` - выгрузка\n\ \ * `WORK` - работа на локации\n * `PICKUP_TO_BOX` - загрузка в кузов\n\ \ * `DROP_FROM_BOX` - выгрузка из кузова\n" nullable: false type: string enum: - PICKUP - DROP - WORK - PICKUP_TO_BOX - DROP_FROM_BOX example: WORK cargo_list: description: "Список ключей грузов, зависит от типа заявки, в которой находятся\ \ грузы:\n * `PICKUP` - список ключей\n * `DROP` - один ключ\n * `WORK`\ \ - пустой список\n * `PICKUP_TO_BOX` - один ключ\n * `DROP_FROM_BOX` -\ \ один ключ\n" type: array minItems: 0 maxItems: 1000 uniqueItems: true items: description: Ключ груза. type: string minLength: 1 maxLength: 1024 example: - cargo01 possible_event: description: 'Возможное событие. Объединяет географическую локацию и временное окно, в которое возможно выполнение заявки. ' type: object additionalProperties: false properties: key: description: Ключ события, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: event_1 location_key: description: Ключ локации, в которой возможно данное событие. type: string minLength: 1 maxLength: 1024 example: location01 duration: description: Время выполнения события, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' reward: description: Вознаграждение за выполнение данного события. type: number format: double minimum: 0 maximum: 1000000000 default: 1000.1 example: 199.9 hard_time_window: $ref: '#/components/schemas/time_window' soft_time_window: $ref: '#/components/schemas/time_window' required: - key - location_key - hard_time_window demand: description: Заявка на единичное действие с грузом (загрузка / выгрузка) или работу на локации. type: object additionalProperties: false properties: key: description: Ключ заявки, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: demand_1 demand_type: $ref: '#/components/schemas/demand_type' target_cargos: $ref: '#/components/schemas/cargo_list' precedence_in_trip: description: Приоритет внутри рейса, 0 - приоритет не учитывается. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 default: 0 precedence_in_order: description: Приоритет внутри заказа, 0 - приоритет не учитывается. type: integer format: int32 minimum: 0 maximum: 15001 example: 1 default: 0 possible_events: description: Список временных окон и ключей локаций, в которых возможно выполнение заявки. type: array uniqueItems: true minItems: 1 maxItems: 25 items: $ref: '#/components/schemas/possible_event' attributes: $ref: '#/components/schemas/attributes' required: - key - demand_type - possible_events cargo_rotation_type: description: "Способность груза вращаться с шагом в 90 градусов вокруг осей:\n\ \ * `ALL` - любых осей.\n * `YAW` - вокруг оси Z.\n * `PITCH` - вокруг\ \ оси Y.\n * `ROLL` - вокруг оси X.\n" type: string enum: - ALL - YAW - PITCH - ROLL default: ALL example: ALL cargo_rotation: description: "Список способностей объекта вращаться (с шагом в 90 градусов):\n\ \ * `ALL` - можно поворачивать по любой оси любое количество раз\n * `YAW`\ \ - можно повернуть один раз по вертикальной оси (вокруг своей оси)\n * `PITCH`\ \ - можно повернуть один раз по поперечной оси (поставить вертикально)\n \ \ * `ROLL` - можно повернуть один раз по продольной оси (положить на бок)\n\ \nЕсли список пустой - объект вращать запрещено.\n\nПодробнее про [размещение\ \ грузов в кузове](#section/Opisanie/Razmeshenie-gruzov-v-kuzove)." type: array minItems: 0 maxItems: 4 uniqueItems: true default: [] items: $ref: '#/components/schemas/cargo_rotation_type' example: - ALL cargo_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) груза с отсеком транспорта и другими грузами. ' type: object additionalProperties: false nullable: true properties: width: description: Ширина в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 height: description: Высота в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.3 length: description: Длина в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2.2 rotation: $ref: '#/components/schemas/cargo_rotation' box_restrictions: description: 'Список необходимых требований к отсеку транспорта, в котором может перевозиться этот груз. ' $ref: '#/components/schemas/compatibility_tag_list' cargo_features: description: 'Список свойств груза. Используется для проверки совместимости груза с другими грузами. Несовместимые грузы не могу находится одновременно в одном отсеке транспорта. ' $ref: '#/components/schemas/compatibility_tag_list' cargo_restrictions: description: 'Список необходимых требований к грузу. Используется для проверки совместимости груза с другими грузами. Несовместимые грузы не могу находится одновременно в одном отсеке транспорта. ' $ref: '#/components/schemas/compatibility_tag_list' cargo: description: 'Груз. Вне зависимости от размеров груз может перемещаться только внутри отсека транспорта. ' type: object additionalProperties: false properties: key: description: Ключ груза, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: cargo01 capacity: $ref: '#/components/schemas/capacity' description: Аддитивные меры груза. compatibilities: $ref: '#/components/schemas/cargo_compatibilities' target_box_key: description: 'Ключ отсека транспорта, в котором уже находится груз. Применимо только для груза, который находится в заявке с типом `DROP_FROM_BOX`. Для других типов заявок ключ должен быть пустым. ' type: string minLength: 1 maxLength: 1024 nullable: true default: null example: box01 required: - key order_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) заказа с исполнителями и другими заказами. ' type: object additionalProperties: false nullable: true properties: order_features: description: 'Список свойств заказа. Используется для проверки совместимости заказа с другими заказами. Несовместимые заказы не могу находится в одном рейсе. ' $ref: '#/components/schemas/compatibility_tag_list' order_restrictions: description: 'Список требований к заказу, выполняемому в этом же рейсе. Используется для проверки совместимости заказа с другими заказами. Несовместимые заказы не могу находится в одном рейсе. ' $ref: '#/components/schemas/compatibility_tag_list' performer_restrictions: description: 'Список необходимых требований к исполнителю, который может выполнить данный заказ. ' $ref: '#/components/schemas/compatibility_tag_list' performer_blacklist: description: 'Список требований, наличие которых у исполнителя не допустимо. Данный список не должен пересекаться с `performer_restrictions`. ' $ref: '#/components/schemas/compatibility_tag_list' order: description: Заказ на перемещение груза, содержит список заявок. type: object additionalProperties: false properties: key: description: Ключ заказа, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: order01 demands: description: Список заявок. type: array uniqueItems: true minItems: 1 maxItems: 1000 items: $ref: '#/components/schemas/demand' cargos: description: 'Список грузов, на которые ссылаются заявки данного заказа. Список должен быть пустой, если все заявки заказа имеют тип `WORK`. ' type: array uniqueItems: true minItems: 0 maxItems: 1000 default: [] items: $ref: '#/components/schemas/cargo' compatibilities: $ref: '#/components/schemas/order_compatibilities' attributes: $ref: '#/components/schemas/attributes' required: - key - demands performer_tariff_constraint: description: Оплачиваемый промежуток времени - составная часть тарифа. type: object additionalProperties: false properties: stage_length: description: Длина оплачиваемого периода, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). type: string format: duration x-custom-format: duration pattern: ^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$ minLength: 3 maxLength: 16 default: PT24H example: P1T8H30M20S cost_per_unit: description: 'Стоимость внутри оплачиваемого периода, денежная единица за секунду работы. ' type: number format: double minimum: 0.001 maximum: 10000 default: 0.001 example: 5.05 performer_tariff: description: Тариф, определяет стоимость и временные ограничения смены. type: object additionalProperties: false properties: cost_per_shift: description: Цена за использование смены, денежная единица. type: number format: double minimum: 0.001 maximum: 1000000 default: 0.001 example: 2000 constraints: description: Список составных частей тарифа. type: array minItems: 1 maxItems: 100 uniqueItems: false items: $ref: '#/components/schemas/performer_tariff_constraint' default: - stage_length: PT24H cost_per_unit: 0.001 max_penalty_cost: description: 'Максимальная сумма штрафов, которую может получить исполнитель в рамках данной смены, денежная единица. Если параметр не указан или указан как null - исполнитель может нарушать без ограничений. ' type: number format: double nullable: true default: null minimum: 0 maximum: 1000000 example: 2000 break: description: Условие наступления и характеристики перерыва. type: object additionalProperties: false nullable: true properties: max_work_duration_sum: description: Суммарное время работы, после которого необходимо сделать перерыв, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' duration: description: Продолжительность перерыва, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). $ref: '#/components/schemas/time_duration' required: - max_work_duration_sum - duration work_and_rest_rules: description: 'Режим труда и отдыха. ' type: object additionalProperties: false properties: first_break: $ref: '#/components/schemas/break' description: 'Первый перерыв в простом виде - не позже чем через N секунд от планового времени начала работы должен быть один перерыв длительностью M секунд. Время ожидания не учитывается как рабочее время. Работа не может быть прервана перерывом. Если много заказов в одной локации - то между выполнением заказов может быть запланирован перерыв. ' performer_shift: description: 'Рабочая смена исполнителя, которая определяет доступность ресурса для планирования внутри его временного окна доступности. ' type: object additionalProperties: false properties: key: description: Ключ смены, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: shift01 availability_time: description: Временное окно смены, в которое исполнитель может выполнять работу на локациях и осуществлять перемещение между локациями. $ref: '#/components/schemas/time_window' working_time: description: Рабочее временное окно, в которые исполнитель может выполнять работу на локациях, должно быть внутри временного окна смены. $ref: '#/components/schemas/time_window' start_location_key: description: 'Ключ начальной локациями. Если ключ не задан - то рейс начинается на первом заказе. ' type: string minLength: 1 maxLength: 1024 nullable: true default: null example: start_location01 finish_location_key: description: 'Ключ финальной локации. Если ключ не задан - то рейс завершается на последнем заказе. ' type: string minLength: 1 maxLength: 1024 nullable: true default: null example: finish_location01 max_locations: description: 'Ограничение количества уникальных локаций в одном рейсе, включая локации старта и финиша. Если параметр не указан или указан как null - то количество локаций не ограничено. ' type: integer format: int32 minimum: 1 maximum: 1000 nullable: true default: null example: 15 max_stops: description: 'Ограничение количества остановок в одном рейсе, включая локации старта и финиша. Если параметр не указан или указан как null - то количество остановок не ограничено. ' type: integer format: int32 minimum: 1 maximum: 1000 nullable: true default: null example: 15 tariff: $ref: '#/components/schemas/performer_tariff' work_and_rest_rules: $ref: '#/components/schemas/work_and_rest_rules' attributes: $ref: '#/components/schemas/attributes' required: - key - availability_time - working_time performer_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) исполнителя с транспортом и заказами. ' type: object additionalProperties: false nullable: true properties: performer_features: description: 'Список свойств исполнителя. Используется для проверки совместимости исполнителя с заказами. ' $ref: '#/components/schemas/compatibility_tag_list' performer_features_lifetimes: description: 'Ограничения на время жизни свойств исполнителя. Влияет на совместимость Исполнитель-Заказ. ' $ref: '#/components/schemas/feature_lifetime_list' transport_restrictions: description: 'Список необходимых требований к транспорту. Используется для проверки совместимости транспорта с исполнителем. ' $ref: '#/components/schemas/compatibility_tag_list' performer_limits: description: 'Ограничение на рабочую загрузку исполнителя. ' type: object additionalProperties: false nullable: true properties: max_work_shifts: description: Ограничение количества смен исполнителя в одном планировании. type: integer format: int32 minimum: 1 maximum: 31 default: 31 example: 3 performer: description: 'Исполнитель. Выполняет заказы, используя транспорт. ' type: object additionalProperties: false properties: key: description: Ключ исполнителя, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: performer0001 shifts: description: Список рабочих смен исполнителя. type: array uniqueItems: true minItems: 1 maxItems: 15001 items: $ref: '#/components/schemas/performer_shift' own_transport_type: $ref: '#/components/schemas/transport_type' compatibilities: $ref: '#/components/schemas/performer_compatibilities' limits: $ref: '#/components/schemas/performer_limits' attributes: $ref: '#/components/schemas/attributes' required: - key - shifts transport_tariff_constraint: description: Оплачиваемый пробег - составная часть тарифа. type: object additionalProperties: false properties: stage_length: description: Длина оплачиваемой части пути, в метрах. type: integer format: int32 minimum: 1 maximum: 100000000 default: 100000000 example: 200000 cost_per_unit: description: 'Стоимость внутри оплачиваемой части пути, денежная единица за один метр. ' type: number format: double minimum: 0.001 maximum: 10000 default: 0.001 example: 5.05 transport_tariff: description: Тариф, определяет стоимость работы транспорта и ограничения по пробегу за смену. type: object additionalProperties: false properties: cost_per_shift: description: Цена за использование смены, денежная единица. type: number format: double minimum: 0.001 maximum: 1000000 default: 0.001 example: 2000 constraints: description: Список составных частей тарифа. type: array minItems: 1 maxItems: 100 uniqueItems: false items: $ref: '#/components/schemas/transport_tariff_constraint' default: - stage_length: 100000000 cost_per_unit: 0.001 transportation_cost: description: Стоимость перемещения 1 единицы меры груза на 1 метр (по каждому полю capacity соответственно), в условных денежных единицах. $ref: '#/components/schemas/capacity' max_penalty_cost: description: 'Максимальная сумма штрафов, которую может получить транспорт в рамках данной смены, денежная единица. ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2000 deprecated: true transport_shift: description: 'Рабочая смена транспорта. Определяет доступность транспорта для планирования. Конец смены обнуляет оставшийся в кузове груз после выполнения заявок типов `DROP_FROM_BOX` и `PICKUP_TO_BOX`. ' type: object additionalProperties: false properties: key: description: Ключ смены, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: shift01 availability_time: description: Временное окно смены, в которое транспорт может осуществлять перемещение между локациями и использоваться исполнителем в работах на локациях. $ref: '#/components/schemas/time_window' working_time: deprecated: true description: Рабочее временное окно, в которые транспорт может использоваться исполнителем в работах на локациях, должно быть внутри временного окна смены. $ref: '#/components/schemas/time_window' start_location_key: description: 'Ключ начальной локациями. Если ключ не задан - то путь транспорта начинается на первом заказе. ' type: string minLength: 1 maxLength: 1024 nullable: true default: null example: start_location01 finish_location_key: description: 'Ключ финальной локации. Если ключ не задан - то путь транспорта завершается на последнем заказе. ' type: string minLength: 1 maxLength: 1024 nullable: true default: null example: finish_location01 tariff: $ref: '#/components/schemas/transport_tariff' attributes: $ref: '#/components/schemas/attributes' required: - key - availability_time - working_time box_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) отсека транспорта. ' type: object additionalProperties: false nullable: true properties: width: description: Ширина в метрах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 height: description: Высота в метрах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 3.1 length: description: Длина в метрах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2.1 box_features: description: 'Список свойств отсека. Используется для проверки совместимости груза с отсеком. ' $ref: '#/components/schemas/compatibility_tag_list' box_limits: description: '`max_one_cargo_capacity` - ограничение по полям capacity для *одного* груза. ' type: object additionalProperties: false nullable: true properties: max_one_cargo_capacity: $ref: '#/components/schemas/capacity' box: description: 'Отсек транспорта, который способен вмещать грузы. ' type: object additionalProperties: false properties: key: description: Ключ отсека, уникальный идентификатор, используется для идентификации размещения грузов по отсекам. type: string minLength: 1 maxLength: 1024 example: box01 capacity: description: Вместимость отсека, которая ограничивает максимальную сумму по всем полям `capacity` у *всех* грузов. $ref: '#/components/schemas/capacity' compatibilities: $ref: '#/components/schemas/box_compatibilities' limits: $ref: '#/components/schemas/box_limits' required: - key transport_compatibilities: description: '[Совместимости](#section/Opisanie/Ispolzuemye-sovmestimosti) транспорта с исполнителями и локациями. ' type: object additionalProperties: false nullable: true properties: transport_features: description: 'Список свойств транспорта. Используется для проверки совместимости транспорта с локациями и исполнителями. ' $ref: '#/components/schemas/compatibility_tag_list' transport_features_lifetimes: description: 'Ограничения на время жизни свойств транспорта. Влияет на совместимость Транспорт-Локация. ' $ref: '#/components/schemas/feature_lifetime_list' performer_restrictions: description: 'Список необходимых требований к исполнителю для использования данного транспорта. ' $ref: '#/components/schemas/compatibility_tag_list' transport_limits: description: 'Ограничения на загрузку транспорт. ' type: object additionalProperties: false nullable: true properties: max_boxes: description: 'Ограничение максимального количества используемых отсеков транспорта в одном рейсе. Если параметр не указан или указан как null - то количество отсеков не ограничено. Ограничение не должно превышать количество отсеков. ' type: integer format: int32 nullable: true default: null minimum: 0 maximum: 100 example: 2 max_capacity: $ref: '#/components/schemas/capacity' description: 'Параметр дополнительно ограничивает максимально возможную загрузку транспорта в целом суммарно по всем отсекам. Если параметр не задан - загрузка ограничивается только каждым отсеком. Применимо только если у транспорта больше одного отсека. Параметр не должен быть меньше вместимости любого отсека. ' transport: description: 'Транспорт. Исполнитель использует транспорт для перемещения и перевозки грузов. ' type: object additionalProperties: false properties: key: description: Ключ транспорта, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: transport001 shifts: description: Список рабочих смен транспорта. type: array uniqueItems: true minItems: 1 maxItems: 15001 items: $ref: '#/components/schemas/transport_shift' transport_type: $ref: '#/components/schemas/transport_type' boxes: description: Список отсеков транспорта, которые могут вмещать груз. type: array minItems: 0 maxItems: 100 uniqueItems: true default: [] items: $ref: '#/components/schemas/box' compatibilities: $ref: '#/components/schemas/transport_compatibilities' limits: $ref: '#/components/schemas/transport_limits' attributes: $ref: '#/components/schemas/attributes' required: - key - shifts hardlink_element_type: description: 'Тип сущности-цели, которая связана назначением с другими сущностями. Может быть заказом, сменой исполнителя, сменой транспорта. ' type: string enum: - ORDER - PERFORMER_SHIFT - TRANSPORT_SHIFT example: ORDER hardlink_element: description: Элемент группы назначения. type: object additionalProperties: false properties: type: $ref: '#/components/schemas/hardlink_element_type' entity_key: description: Ключ сущности-цели (соответственно заказа или смены). type: string minLength: 1 maxLength: 1024 example: ord0001 required: - type - entity_key hardlink: description: "Назначение, необходимое чтобы связать сущности в одну группу.\ \ Может состоять из двух сущностей или более. Пример применения:\n * назначение\ \ водителя на транспорт (связь смен исполнителя и траспорта).\n * назначение\ \ заказа на исполнителя (связь заказа со сменой исполнителя).\n * указание\ \ необходимости выполнять несколько заказов в одном рейсе (связь заказов между\ \ собой).\n" type: object additionalProperties: false properties: key: description: Ключ назначения. type: string minLength: 1 maxLength: 1024 example: group01 links: description: Список элементов группы назначения. type: array minItems: 2 maxItems: 1000 items: $ref: '#/components/schemas/hardlink_element' required: - key - links trip_name: description: Краткое наименование рейса. type: string minLength: 0 maxLength: 64 default: '' example: 1-ABC assigned_performer: description: Назначенная на определенное время (`shift_time`) смена исполнителя. type: object additionalProperties: false properties: performer_key: description: Ключ исполнителя, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: performer0001 shift_key: description: Ключ смены исполнителя. type: string minLength: 1 maxLength: 1024 example: performer0001_shift01 shift_time: $ref: '#/components/schemas/time_window' required: - performer_key - shift_key - shift_time assigned_transport: description: Назначенная на определенное время (`shift_time`) смена транспорта. type: object additionalProperties: false properties: transport_key: description: Ключ транспорта, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: transport001 shift_key: description: Ключ смены транспорта. type: string minLength: 1 maxLength: 1024 example: performer01 shift_time: $ref: '#/components/schemas/time_window' required: - transport_key - shift_key - shift_time trip_state_flag: description: 'Логический [флаг состояния](#section/Opisanie/Model-reisa) в рамках рейса. ' type: string enum: - AROUND_LOCATION - INSIDE_LOCATION - INSIDE_LOCATION_WINDOW - INSIDE_WORKING_WINDOW - INSIDE_EVENT_HARD_WINDOW - INSIDE_EVENT_SOFT_WINDOW - ON_DEMAND - WAITING - RELOCATING - BREAK example: RELOCATING cargo_placement: description: Расположение одного груза в отсеке. type: object additionalProperties: false properties: box_key: description: Ключ отсека. type: string minLength: 1 maxLength: 1024 example: box01 cargo_key: description: Ключ груза. type: string minLength: 1 maxLength: 1024 example: cargo01 required: - box_key - cargo_key cargo_placement_list: description: Список расположений грузов в транспорте на начало состояния. type: array uniqueItems: true minItems: 0 maxItems: 1000 default: [] items: $ref: '#/components/schemas/cargo_placement' trip_state: description: Состояние рейса. type: object additionalProperties: false properties: time: description: Время начала действия в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). type: string format: date-time example: '2024-02-21T09:30:00+03:00' order_key: description: Ключ заказа, с которым производится действие. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: order01 demand_key: description: Ключ заявки, с которой производится действие. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: demand01.1 event_key: description: Ключ события, с которым производится действие. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: event01 location_key: description: Ключ локации, в которой производится действие. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: location01 flags: description: "Список флагов, совокупность которых описывает текущее состояние.\n\ Возможные значения флагов, отвечающих за географическое положение:\n \ \ * `AROUND_LOCATION` - исполнитель находится рядом с локацией - в процессе\ \ парковки или выезда с нее.\n * `INSIDE_LOCATION` - исполнитель находится\ \ на локации.\n\nВозможные значения флагов, отвечающих за нахождения во\ \ временных окнах:\n * `INSIDE_WORKING_WINDOW` - исполнитель находится\ \ внутри рабочего временного окна.\n * `INSIDE_LOCATION_WINDOW` - исполнитель\ \ находится внутри времени работы локации.\n * `INSIDE_EVENT_HARD_WINDOW`\ \ - исполнитель находится внутри жесткого временного окна.\n * `INSIDE_EVENT_SOFT_WINDOW`\ \ - исполнитель находится внутри мягкого временного окна.\n\nВозможные\ \ значения флагов, отвечающих за действия:\n * `ON_DEMAND` - исполнитель\ \ работает над заявкой.\n * `WAITING` - исполнитель находится в режиме\ \ ожидания. \n * `RELOCATING` - исполнитель перемещается к следующей\ \ остановке.\n * `BREAK` - исполнитель находится на перерыве.\n" type: array uniqueItems: true minItems: 0 maxItems: 9 default: [] items: $ref: '#/components/schemas/trip_state_flag' cargo_placements: $ref: '#/components/schemas/cargo_placement_list' attributes: $ref: '#/components/schemas/attributes' required: - time - flags trip_waitlist: description: Список ключей заказов, назначенных на исполнителя, но не запланированных на определенное время. type: array minItems: 0 maxItems: 15001 uniqueItems: true items: description: Ключ заказа. type: string minLength: 1 maxLength: 1024 example: - order02 trip: description: 'Рейс - это совокупность работ, запланированных на выполнение конкретным исполнителем на конкретном транспорте, выраженных через изменение состояний исполнителя. ' type: object additionalProperties: false properties: key: description: Уникальный идентификатор рейса. type: string minLength: 1 maxLength: 1024 example: 631988f0-9e27-11ed-a8fc-0242ac120002 name: $ref: '#/components/schemas/trip_name' performer: $ref: '#/components/schemas/assigned_performer' transport: $ref: '#/components/schemas/assigned_transport' states: description: Список состояний исполнителя. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/trip_state' waitlist: $ref: '#/components/schemas/trip_waitlist' attributes: $ref: '#/components/schemas/attributes' required: - key - performer - transport - states fact_time: description: Дата и время создания факта в формате [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). type: string format: date-time example: '2024-02-21T09:30:00+03:00' order_fact_type: description: "Возможные типы факта о заказе (заявке):\n * `ORDER_DONE` - исполнитель\ \ закончил выполнять заказ, связанный с заказом груз более не находится в\ \ отсеках транспорта\n * `ORDER_CANCEL` - заказ был отменен, поведение аналогично\ \ `ORDER_DONE`\n * `DEMAND_START` - исполнитель начал выполнять заявку \n\ \ * `DEMAND_DONE` - исполнитель закончил выполнять заявку\n" type: string enum: - ORDER_DONE - ORDER_CANCEL - DEMAND_START - DEMAND_DONE example: ORDER_DONE order_fact: description: 'Факт о заказе - совершенное действие с заказом или его частью (заявкой). ' type: object additionalProperties: false properties: key: description: Ключ факта. type: string minLength: 1 maxLength: 1024 example: fact_01 time: $ref: '#/components/schemas/fact_time' type: $ref: '#/components/schemas/order_fact_type' order_key: description: Ключ заказа. type: string minLength: 1 maxLength: 1024 example: order_01 demand_key: description: Ключ заявки, обязателен для фактов с типом `DEMAND_DONE` и `DEMAND_START`. type: string nullable: true minLength: 1 maxLength: 1024 example: order_01_demand_01 default: null required: - key - time - type - order_key performer_fact: description: Факт о нахождении исполнителя в определенной локации. type: object additionalProperties: false properties: key: description: Ключ факта. type: string minLength: 1 maxLength: 1024 example: fact_01 time: $ref: '#/components/schemas/fact_time' performer_key: description: Ключ исполнителя. type: string minLength: 1 maxLength: 1024 example: performer_01 location_key: description: Ключ локации, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: location01 required: - key - time - performer_key - location_key facts: description: 'Произошедшие события. ' type: object additionalProperties: false properties: order_facts: description: 'Список фактов по заказам - совершенных действий с заказами или его частями (заявками). ' type: array uniqueItems: false minItems: 0 maxItems: 50001 items: $ref: '#/components/schemas/order_fact' performer_facts: description: 'Список фактов о нахождении исполнителя в определенной локации. При наличии нескольких фактов учитывается только самый поздний по полю `time`. Локация, на которую ссылается факт, должна находится в списке `locations`. ' type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/performer_fact' transport_load: description: Загрузка транспорта. type: object additionalProperties: false properties: count: description: Количество заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1460 capacity: $ref: '#/components/schemas/capacity' required: - count - capacity stop_statistics: description: 'Статистика по конкретной остановке в рейсе. ' type: object additionalProperties: false properties: location_key: description: Ключ локации, на которой происходит остановка. type: string minLength: 1 maxLength: 1024 example: location01 demand_ids: description: Список ключей заявок выполненных на этой остановке. type: array minItems: 0 maxItems: 15001 uniqueItems: true items: description: 'Идентификатор заявки, получается по следующей формуле: идентификатор заказа + ''#'' + идентификатор заявки. ' type: string minLength: 1 maxLength: 1024 example: demand01 stop_time_window: description: 'Временное окно остановки - от начала парковки до полного отъезда с локации. Продолжительность окна складывается из `waiting_time` + `break_time` + `working_time` + `arriving_time` + `departure_time`. ' $ref: '#/components/schemas/time_window' measurements: $ref: '#/components/schemas/measurements' description: "Измерения времен и дистанций для работ на остановке:\n\n \ \ * `driving_time` - время движения от предыдущей остановки до текущей\ \ локации\n * `waiting_time` - продолжительность ожидания исполнения\ \ работы на локации\n * `break_time` - продолжительность перерыва исполнителя\ \ на локации\n * `working_time` - время, затраченное на непосредственное\ \ выполнение работ на локации\n * `arriving_time` - время, затраченное\ \ на подъезд/парковку на локации\n * `departure_time` - время, затраченное\ \ на отъезд от локации\n * `time_window` - временное окно от начала движения\ \ к остановке до окончания отъезда с остановки\n * `total_time` - суммарное\ \ время на остановку, складывается из `driving_time` + `waiting_time`\ \ + `break_time` + `working_time` + `arriving_time` + `departure_time`\n\ \ * `distance` - расстояние от предыдущей остановки до текущей\n" upload: $ref: '#/components/schemas/transport_load' description: Суммарная загрузка товаров в транспорт на этой остановке. download: $ref: '#/components/schemas/transport_load' description: Суммарная выгрузка товаров из транспорта на этой остановке. max_load: $ref: '#/components/schemas/transport_load' description: Максимальная загрузка транспорта в процессе загрузки/выгрузки на остановке. arrival_load: $ref: '#/components/schemas/transport_load' description: Загрузка транспорта в момент его прибытия в данную остановку. departure_load: $ref: '#/components/schemas/transport_load' description: Загрузка транспорта в момент его отъезда от данной остановки. required: - location_key - demand_ids - stop_time_window - measurements - upload - download - max_load - arrival_load - departure_load trip_statistics: description: 'Статистика по конкретному рейсу. ' type: object additionalProperties: false properties: trip_key: description: Ключ рейса, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: trip01 statistics: $ref: '#/components/schemas/statistics' stop_statistics: description: Статистика по каждой остановке в рейсе. type: array minItems: 0 maxItems: 15001 uniqueItems: false items: $ref: '#/components/schemas/stop_statistics' total_load: $ref: '#/components/schemas/transport_load' description: Суммарная загрузка транспорта за все время рейса. max_load: $ref: '#/components/schemas/transport_load' description: Максимальная загрузка транспорта за все время рейса (по каждому измерению) - и в движении и на точках погрузки\разгрузки. max_transfer_load: $ref: '#/components/schemas/transport_load' description: Максимальная загрузка транспорта за все время рейса (по каждому измерению) в движении. required: - trip_key - statistics - stop_statistics - total_load - max_load - max_transfer_load plan_statistics: description: 'Общая статистика по запланированным рейсам. ' type: object additionalProperties: false nullable: true properties: total_statistics: $ref: '#/components/schemas/statistics' description: Суммарная статистика по всем рейсам. trips_statistics: description: 'Список статистик по каждому запланированному рейсу отдельно. ' type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/trip_statistics' required: - total_statistics - trips_statistics waypoint: description: 'Точка пути. ' type: object additionalProperties: false properties: name: description: Название точки, может использоваться как идентификатор. type: string nullable: true default: null minLength: 0 maxLength: 1024 example: central geopoint: $ref: '#/components/schemas/geopoint' duration: $ref: '#/components/schemas/time_duration' description: Время остановки на точке, в формате [ISO 8601 duration](https://ru.wikipedia.org/wiki/ISO_8601#Durations). required: - geopoint routing_matrix_line: description: Линия значений в матрице расстояний (в метрах) или продолжительностей (в секундах) маршрутов между точками. type: array minItems: 2 maxItems: 15001 uniqueItems: false items: description: 'Расстояние (в метрах) или продолжительность (в секундах) маршрута между точками. Отрицательное значение (-1) означает невозможность проезда между указанными точками. ' type: integer format: int64 minimum: -1 maximum: 10000000 example: 1500 routing_matrix: description: Матрица расстояний и времен. type: object additionalProperties: false properties: waypoints: description: Массив географических точек, между которыми вычислены расстояния и времена. type: array minItems: 2 maxItems: 15001 uniqueItems: false items: $ref: '#/components/schemas/waypoint' distances: description: 'Длины маршрутов между точками, в метрах. Значения в массиве упорядочены в соответствии с порядком элементов в параметре `waypoints`. Каждая строчка матрицы - массив расстояний из искомой точки до каждой другой точки. ' type: array minItems: 2 maxItems: 15001 uniqueItems: false items: $ref: '#/components/schemas/routing_matrix_line' durations: description: 'Массив продолжительностей маршрутов между точками, в секундах. Значения в массиве упорядочены в соответствии с порядком элементов в параметре `waypoints`. Каждая строчка матрицы - массив времен перемещений из искомой точки до каждой другой точки. ' type: array minItems: 2 maxItems: 15001 uniqueItems: false items: $ref: '#/components/schemas/routing_matrix_line' required: - waypoints - distances - durations routing_transport_matrix: description: Матрица времен и расстояний для определенного типа транспорта. type: object additionalProperties: false properties: transport_type: $ref: '#/components/schemas/transport_type' matrix: $ref: '#/components/schemas/routing_matrix' required: - transport_type - matrix routing_transport_matrix_list: description: 'Список матриц времен и расстояний для каждого типа транспорта, которые указаны в данных. Матрица должна описывать все локации для каждого типа транспорта из данных. При указании внешней матрицы маршрутизации `external_routing` не учитываются параметры `geo_settings`. ' type: array uniqueItems: true minItems: 0 maxItems: 12 default: [] items: $ref: '#/components/schemas/routing_transport_matrix' dataset_name: description: 'Название датасета. Техническое поле, не влияющее на планирование. ' type: string minLength: 0 maxLength: 1000 default: '' example: custom_dataset_one universal_data: description: 'Формат VRt.Universal JSON. Общий список данных и настроек, объединяет все данные для планирования, перепланирования и актуализации. ' type: object additionalProperties: false properties: locations: description: Список локаций, которые используются в заказах и сменах. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/location' orders: description: Список заказов. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/order' performers: description: Список доступных исполнителей. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/performer' transports: description: Список доступного транспорта. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/transport' hardlinks: description: Список назначений. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/hardlink' trips: description: Существующие рейсы. type: array uniqueItems: true minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/trip' facts: $ref: '#/components/schemas/facts' statistics: $ref: '#/components/schemas/plan_statistics' external_routing: $ref: '#/components/schemas/routing_transport_matrix_list' plan_settings: $ref: '#/components/schemas/plan_settings' replan_settings: $ref: '#/components/schemas/replan_settings' actualize_settings: $ref: '#/components/schemas/actualize_settings' dataset_name: $ref: '#/components/schemas/dataset_name' import_source: description: Источник импорта данных. type: string enum: - ACCOUNT - ADMIN example: ACCOUNT import_sample: description: Выборка загружаемых данных - входная задача или входная задача + результат расчета. type: string enum: - TASK - FULL example: TASK table_location_column_type: description: "Название колонки в таблице с локациями:\n * `ESSENCE_KEY` - ключ\ \ сущности\n * `ENABLED` - участие в расчете\n * `PRISTINE` - флаг изменения\ \ данных\n" type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - WORKING_TIME - ATTRIBUTES example: ESSENCE_KEY table_filter_type: description: "Тип фильтра:\n * `DATETIME_RANGE` - пересечение временного отрезка\n\ \ * `INT_RANGE` - попадание числа внутрь целочисленного отрезка\n * `FLOAT_RANGE`\ \ - попадание числа внутрь float отрезка\n * `DURATION_RANGE` - попадание\ \ внутрь временного отрезка (длительность)\n * `BOOL_LIST` - точное совпадение\ \ булевых значений\n * `ENUM_LIST` - точное совпадение строковых значений\ \ из заранее определенного списка\n * `STRING_LIST` - частичное или точное\ \ совпадение списка строковых значений\n * `STRING_SEARCH` - частичное или\ \ точное совпадение строки\n" type: string enum: - DATETIME_RANGE - INT_RANGE - FLOAT_RANGE - DURATION_RANGE - BOOL_LIST - ENUM_LIST - STRING_LIST - STRING_SEARCH example: STRING_SEARCH table_filter_datetime_range: description: Временное окно. type: object additionalProperties: false nullable: true properties: from: description: 'Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time nullable: true example: '2024-02-21T08:45:00+03:00' to: description: 'Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). ' type: string format: date-time nullable: true example: '2024-02-21T19:45:00+03:00' table_filter_int_range: description: Числовой диапазон. type: object additionalProperties: false nullable: true properties: from: description: Левая граница. type: integer format: int32 minimum: -10000000 maximum: 10000000 default: -9999999 example: 1 to: description: Правая граница. type: integer format: int32 minimum: -10000000 maximum: 10000000 default: 9999999 example: 100 table_filter_float_range: description: Числовой диапазон. type: object additionalProperties: false nullable: true properties: from: description: Левая граница. type: number format: double minimum: -10000000 maximum: 10000000 default: -9999999.9 example: 1 to: description: Правая граница. type: number format: double minimum: -10000000 maximum: 10000000 default: 9999999.9 example: 100 table_filter_bool_list: description: Фильтр по списку булевых значений. type: object additionalProperties: false nullable: true properties: elements: description: Список булевых значений. type: array uniqueItems: false minItems: 0 maxItems: 2 items: description: Логическая переменная. type: boolean default: false example: false table_filter_string_list: description: Фильтр по списку строк. type: object additionalProperties: false nullable: true properties: elements: description: Список строк. type: array uniqueItems: false minItems: 0 maxItems: 101 items: description: Строка для поиска. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: key01 strict: description: Точное совпадение (`false`) или поиск по вхождению подмножества (`true`). type: boolean default: false example: false table_filter_enum_list: description: Фильтр по списку заранее известных текстовых значений. type: object additionalProperties: false nullable: true properties: elements: description: Список строк. type: array uniqueItems: false minItems: 0 maxItems: 101 items: description: Значение. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: key01 table_filter_string_search: description: Строковый фильтр. type: object additionalProperties: false nullable: true properties: text: description: Строка для поиска. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: key01 strict: description: Точное совпадение (`false`) или поиск по вхождению подстроки (`true`). type: boolean default: false example: false table_location_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_location_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' required: - type - column table_location_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_location_filter' basic_essence_key: description: Ключ, уникальный идентификатор. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: key01 basic_enabled: description: Использование сущности в расчете. type: boolean default: true example: false readOnly: false basic_time_window: description: Временное окно. type: object additionalProperties: false nullable: true properties: from: description: "Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6).\n\ Для левой границы временного окна выбирается самое ранее из левых границ\ \ временных окон дочерних сущностей. \n" type: string format: date-time nullable: true example: '2024-02-21T08:45:00+03:00' to: description: 'Дата и время в соответствии с [ISO 8601](https://tools.ietf.org/html/rfc3339#section-5.6). Для правой границы временного окна выбирается самое позднее из правых границ временных окон дочерних сущностей. ' type: string format: date-time nullable: true example: '2024-02-21T19:45:00+03:00' basic_attributes: description: Атрибуты. type: string minLength: 0 maxLength: 1000000 default: '' example: key1:value1, key2:value2 table_location_fields: description: Табличные поля локации. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - LOCATION - WORK_WINDOW default: LOCATION example: LOCATION enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' working_time: $ref: '#/components/schemas/basic_time_window' attributes: $ref: '#/components/schemas/basic_attributes' table_location: description: Локация. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_location_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_location_fields' required: - fields - elements table_location_list: description: Список локаций. type: object additionalProperties: false properties: essences: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_location' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics linked_essence: description: Ссылка на связанную сущность. type: object additionalProperties: false properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - LOCATION - ORDER - ASSIGNED_ORDER - PERFORMER - TRANSPORT - HARDLINK - TRIP - FACT example: LOCATION required: - essence_key - essence_type linked_essence_list: description: Список связанных сущностей. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/linked_essence' web_location: description: Web location. type: object additionalProperties: false properties: location: $ref: '#/components/schemas/location' fields: $ref: '#/components/schemas/table_location_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - location web_location_geopoint: description: Геоточка для карты. type: object additionalProperties: false properties: geopoint: $ref: '#/components/schemas/geopoint' location_key: description: Ключ локации, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: location01 linked: description: Флаг указывающий наличие ссылок на локацию. type: boolean default: false example: true required: - geopoint - location_key - linked web_location_geopoint_list: description: Геоточки для отображения на карте. type: object additionalProperties: false properties: geopoints: description: Список точек. type: array uniqueItems: false minItems: 0 maxItems: 60002 items: $ref: '#/components/schemas/web_location_geopoint' statistics: $ref: '#/components/schemas/table_list_stats' required: - geopoints - statistics table_performer_column_type: description: "Название колонки в таблице с исполнителями:\n * `ESSENCE_KEY`\ \ - ключ сущности\n * `ENABLED` - участие в расчете\n * `PRISTINE` - флаг\ \ изменения данных\n" type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - WORKING_TIME - AVAILABILITY_TIME - TRIP_KEY - TRIP_NAME - LOCATION_KEYS - TRIPS_COUNT - ATTRIBUTES example: ESSENCE_KEY table_performer_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_performer_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' required: - type - column table_performer_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_performer_filter' basic_essence_key_list: description: Список ключей сущностей. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/basic_essence_key' table_performer_fields: description: Табличные поля исполнителя и его смены. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - PERFORMER - SHIFT default: PERFORMER example: PERFORMER enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' working_time: $ref: '#/components/schemas/basic_time_window' availability_time: $ref: '#/components/schemas/basic_time_window' trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' location_keys: $ref: '#/components/schemas/basic_essence_key_list' description: Список ключей локаций, которые связаны с данной сущностью. trips_count: description: Количество рейсов, в которых участвует исполнитель (для смены - 0 или 1). type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 1 attributes: $ref: '#/components/schemas/basic_attributes' table_performer: description: Исполнитель. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_performer_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_performer_fields' required: - fields - elements table_performer_list: description: Список. type: object additionalProperties: false properties: essences: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_performer' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics web_performer: description: Web Performer. type: object additionalProperties: false properties: performer: $ref: '#/components/schemas/performer' fields: $ref: '#/components/schemas/table_performer_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - performer web_performer_geopoint: description: Геоточка для карты. type: object additionalProperties: false properties: geopoint: $ref: '#/components/schemas/geopoint' performer_key: description: Ключ исполнителя. type: string minLength: 1 maxLength: 1024 example: performer_01 shift_key: description: Ключ смены, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: shift01 point_type: description: Тип точки - начальная или конечная. nullable: false type: string enum: - START - FINISH example: START trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' stop_number: description: Порядковый номер остановки в рейсе. type: integer format: int32 minimum: 0 maximum: 1000 default: 0 example: 10 required: - geopoint - performer_key - shift_key - point_type web_performer_geopoint_list: description: Геоточки для отображения на карте. type: object additionalProperties: false properties: geopoints: description: Список точек. type: array uniqueItems: false minItems: 0 maxItems: 60002 items: $ref: '#/components/schemas/web_performer_geopoint' statistics: $ref: '#/components/schemas/table_list_stats' required: - geopoints - statistics table_transport_column_type: description: "Название колонки в таблице с транспортом:\n * `ESSENCE_KEY` -\ \ ключ сущности\n * `ENABLED` - участие в расчете\n * `PRISTINE` - флаг\ \ изменения данных\n" type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - WORKING_TIME - AVAILABILITY_TIME - TRANSPORT_TYPE - TRIP_KEY - TRIP_NAME - LOCATION_KEYS - TRIPS_COUNT - ATTRIBUTES example: ESSENCE_KEY table_transport_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_transport_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' required: - type - column table_transport_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_transport_filter' table_transport_fields: description: Табличные поля транспорта и его смены. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - TRANSPORT - SHIFT default: TRANSPORT example: TRANSPORT enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' working_time: deprecated: true $ref: '#/components/schemas/basic_time_window' availability_time: $ref: '#/components/schemas/basic_time_window' transport_type: $ref: '#/components/schemas/transport_type' trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' location_keys: $ref: '#/components/schemas/basic_essence_key_list' description: Список ключей локаций, которые связаны с данной сущностью. trips_count: description: Количество рейсов, в которых участвует транспорт (для смены - 0 или 1). type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 1 attributes: $ref: '#/components/schemas/basic_attributes' table_transport: description: Транспорт. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_transport_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_transport_fields' required: - fields - elements table_transport_list: description: Список. type: object additionalProperties: false properties: essences: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_transport' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics web_transport: description: Web Transport. type: object additionalProperties: false properties: transport: $ref: '#/components/schemas/transport' fields: $ref: '#/components/schemas/table_transport_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - transport web_transport_geopoint: description: Географическая точка для карты. type: object additionalProperties: false properties: geopoint: $ref: '#/components/schemas/geopoint' transport_key: description: Ключ транспорта. type: string minLength: 1 maxLength: 1024 example: transport_01 shift_key: description: Ключ смены, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: shift01 point_type: description: Тип точки - начальная или конечная. nullable: false type: string enum: - START - FINISH example: START trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' stop_number: description: Порядковый номер остановки в рейсе. type: integer format: int32 minimum: 0 maximum: 1000 default: 0 example: 10 required: - geopoint - transport_key - shift_key - point_type web_transport_geopoint_list: description: Географические точки для отображения на карте. type: object additionalProperties: false properties: geopoints: description: Список точек. type: array uniqueItems: false minItems: 0 maxItems: 60002 items: $ref: '#/components/schemas/web_transport_geopoint' statistics: $ref: '#/components/schemas/table_list_stats' required: - geopoints - statistics table_order_column_type: description: "Название колонки в таблице с заказами:\n * `ESSENCE_KEY` - ключ\ \ сущности\n * `ENABLED` - участие в расчете\n * `PRISTINE` - флаг изменения\ \ данных\n" type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - STATE - TYPE - HARD_TIME_WINDOW - SOFT_TIME_WINDOW - GENERAL_DROP_TIME_WINDOW - GENERAL_PICKUP_TIME_WINDOW - GENERAL_WORK_TIME_WINDOW - REWARD - MASS - VOLUME - CAPACITY_A - CAPACITY_B - CAPACITY_C - ORDER_FEATURES - ORDER_RESTRICTIONS - PERFORMER_RESTRICTIONS - PERFORMER_BLACKLIST - WIDTH - HEIGHT - LENGTH - ROTATION - BOX_RESTRICTIONS - CARGO_FEATURES - CARGO_RESTRICTIONS - DEMANDS_COUNT - TRIP_KEY - TRIP_NAME - ATTRIBUTES example: ESSENCE_KEY table_order_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_order_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' required: - type - column table_order_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_order_filter' basic_state: description: 'Состояние сущности, определяющее ее отношение к расчету. ' type: string enum: - PLANNED - ASSIGNED - UNPLANNED - ERROR default: UNPLANNED example: PLANNED table_order_fields: description: Табличные поля заказа и заявок. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - ORDER - DEMAND default: ORDER example: ORDER enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' state: $ref: '#/components/schemas/basic_state' type: description: Тип заказа\заявки. type: string nullable: true default: null minLength: 1 maxLength: 1024 example: PD hard_time_window: $ref: '#/components/schemas/basic_time_window' soft_time_window: $ref: '#/components/schemas/basic_time_window' general_drop_time_window: $ref: '#/components/schemas/basic_time_window' general_pickup_time_window: $ref: '#/components/schemas/basic_time_window' general_work_time_window: $ref: '#/components/schemas/basic_time_window' reward: description: Суммарное вознаграждение за выполнение заказов. type: number format: double minimum: 0 default: 0 example: 2343.3 mass: description: Масса в килограммах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 10 volume: description: Объем в кубических метрах. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 capacity_a: description: 'Дополнительный параметр вместимости (A) для измерения грузов и отсеков в альтернативных единицах измерения. Например, для учета грузов в штуках (у груза данный параметр равен единице, у отсека - максимальному количеству вмещаемых грузов). ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 capacity_b: description: 'Дополнительный параметр вместимости (B) для измерения грузов и отсеков в альтернативных единицах измерения. ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 capacity_c: description: 'Дополнительный параметр вместимости (C) для измерения грузов и отсеков в альтернативных единицах измерения. ' type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 3 order_features: $ref: '#/components/schemas/compatibility_tag_list' order_restrictions: $ref: '#/components/schemas/compatibility_tag_list' performer_restrictions: $ref: '#/components/schemas/compatibility_tag_list' performer_blacklist: $ref: '#/components/schemas/compatibility_tag_list' width: description: Ширина в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 height: description: Высота в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.3 length: description: Длина в метрах, используется для проверки вместимости в отсек транспорта. type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2.2 rotation: $ref: '#/components/schemas/cargo_rotation' box_restrictions: $ref: '#/components/schemas/compatibility_tag_list' cargo_features: $ref: '#/components/schemas/compatibility_tag_list' cargo_restrictions: $ref: '#/components/schemas/compatibility_tag_list' demands_count: description: Количество заявок. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 1 trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' attributes: $ref: '#/components/schemas/basic_attributes' table_order: description: Заказ. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_order_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_order_fields' required: - fields - elements table_order_list: description: Список. type: object additionalProperties: false properties: essences: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_order' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics web_order: description: Web Order. type: object additionalProperties: false properties: order: $ref: '#/components/schemas/order' fields: $ref: '#/components/schemas/table_order_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - order web_order_geopoint: description: Геоточка для карты. type: object additionalProperties: false properties: geopoint: $ref: '#/components/schemas/geopoint' order_key: description: Ключ заказа, с которым производится действие. type: string minLength: 1 maxLength: 1024 example: order01 demand_key: description: Ключ заявки, с которой производится действие. type: string minLength: 1 maxLength: 1024 example: demand01.1 event_key: description: Ключ события, с которым производится действие. type: string minLength: 1 maxLength: 1024 example: event01 demand_type: $ref: '#/components/schemas/demand_type' trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' stop_number: description: Порядковый номер остановки в рейсе. type: integer format: int32 minimum: 0 maximum: 1000 default: 0 example: 10 required: - geopoint - order_key - demand_key - event_key - demand_type web_order_geopoint_list: description: Геоточки для отображения на карте. type: object additionalProperties: false properties: geopoints: description: Список точек. type: array uniqueItems: false minItems: 0 maxItems: 60002 items: $ref: '#/components/schemas/web_order_geopoint' statistics: $ref: '#/components/schemas/table_list_stats' required: - geopoints - statistics table_hardlink_column_type: description: 'Название колонки в таблице со связями. ' type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - ELEMENT_TYPE - ELEMENTS_COUNT - TRIP_KEY - TRIP_NAME example: ESSENCE_KEY table_hardlink_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_hardlink_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' required: - type - column table_hardlink_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_hardlink_filter' table_hardlink_fields: description: Табличные поля связи и связанных сущностей. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - HARDLINK - ELEMENT default: HARDLINK example: HARDLINK enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' element_type: description: Тип элемента. type: string nullable: false enum: - HARDLINK - ORDER - PERFORMER_SHIFT - TRANSPORT_SHIFT default: HARDLINK example: ORDER elements_count: description: Количество объектов в связи. type: integer format: int32 minimum: 0 maximum: 15001 default: 0 example: 1 trip_key: $ref: '#/components/schemas/basic_essence_key' trip_name: $ref: '#/components/schemas/trip_name' table_hardlink: description: Hardlink. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_hardlink_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_hardlink_fields' required: - fields - elements table_hardlink_list: description: Список связей. type: object additionalProperties: false properties: essences: description: Список связей. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_hardlink' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics web_hardlink: description: Web Hardlink. type: object additionalProperties: false properties: hardlink: $ref: '#/components/schemas/hardlink' fields: $ref: '#/components/schemas/table_hardlink_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - hardlink table_trip_column_type: description: "Название колонки в таблице с рейсами:\n * `ESSENCE_KEY` - ключ\ \ сущности\n * `ENABLED` - участие в расчете\n * `PRISTINE` - флаг изменения\ \ данных\n" type: string enum: - ESSENCE_KEY - ENABLED - PRISTINE - TRIP_NAME - ATTRIBUTES - COST - REWARD - DRIVING_TIME - WAITING_TIME - BREAK_TIME - WORKING_TIME - ARRIVING_TIME - DEPARTURE_TIME - TOTAL_TIME - DISTANCE - TIME_WINDOW - ORDERS_COUNT - PLAN_ORDERS_COUNT - WAITLIST_ORDERS_COUNT - STOPS_COUNT - LOCATIONS_COUNT - CARGO_CAPACITY_RATIO_MASS - CARGO_CAPACITY_RATIO_VOLUME - CARGO_CAPACITY_RATIO_CAPACITY_A - CARGO_CAPACITY_RATIO_CAPACITY_B - CARGO_CAPACITY_RATIO_CAPACITY_C - MAX_TRANSPORT_LOAD_MASS - MAX_TRANSPORT_LOAD_VOLUME - MAX_TRANSPORT_LOAD_CAPACITY_A - MAX_TRANSPORT_LOAD_CAPACITY_B - MAX_TRANSPORT_LOAD_CAPACITY_C example: ESSENCE_KEY table_filter_duration_range: description: Диапазон длительности. type: object additionalProperties: false nullable: true properties: from: description: Левая граница. example: PT10M $ref: '#/components/schemas/time_duration' to: description: Правая граница. example: PT30M $ref: '#/components/schemas/time_duration' table_trip_filter: description: Универсальный фильтр для колонок в таблице. type: object additionalProperties: false readOnly: true properties: type: $ref: '#/components/schemas/table_filter_type' column: $ref: '#/components/schemas/table_trip_column_type' datetime_range: $ref: '#/components/schemas/table_filter_datetime_range' int_range: $ref: '#/components/schemas/table_filter_int_range' float_range: $ref: '#/components/schemas/table_filter_float_range' bool_list: $ref: '#/components/schemas/table_filter_bool_list' string_list: $ref: '#/components/schemas/table_filter_string_list' enum_list: $ref: '#/components/schemas/table_filter_enum_list' string_search: $ref: '#/components/schemas/table_filter_string_search' duration_range: $ref: '#/components/schemas/table_filter_duration_range' required: - type - column table_trip_filter_list: description: Список фильтров. type: object additionalProperties: false properties: filters: description: Список фильтров. type: array uniqueItems: false minItems: 0 maxItems: 100 items: $ref: '#/components/schemas/table_trip_filter' table_trip_fields: description: Табличные поля рейса и остановок. type: object additionalProperties: false readOnly: true properties: essence_key: $ref: '#/components/schemas/basic_essence_key' essence_type: description: Тип сущности. type: string nullable: false enum: - TRIP - STOP default: TRIP example: TRIP enabled: $ref: '#/components/schemas/basic_enabled' pristine: $ref: '#/components/schemas/basic_pristine' trip_name: $ref: '#/components/schemas/trip_name' attributes: $ref: '#/components/schemas/basic_attributes' cost: description: 'Суммарные затраты, которые считаются на базе тарифов исполнителей и транспорта. Суммарная стоимость при этом равна разнице между суммарным вознаграждением (`reward`) и расходами (`cost`). ' type: number format: double minimum: 0 example: 1231.1 default: 0 reward: description: Суммарное вознаграждение за выполнение заказов. type: number format: double minimum: 0 example: 2343.3 default: 0 driving_time: $ref: '#/components/schemas/time_duration' waiting_time: $ref: '#/components/schemas/time_duration' break_time: $ref: '#/components/schemas/time_duration' working_time: $ref: '#/components/schemas/time_duration' arriving_time: $ref: '#/components/schemas/time_duration' departure_time: $ref: '#/components/schemas/time_duration' total_time: $ref: '#/components/schemas/time_duration' distance: description: Расстояние в метрах. type: integer format: int32 minimum: 0 maximum: 4000000000 example: 5200 default: 0 time_window: $ref: '#/components/schemas/basic_time_window' orders_count: description: Суммарное количество запланированных и назначенных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1700 default: 0 plan_orders_count: description: Суммарное количество запланированных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 1003 default: 0 waitlist_orders_count: description: Суммарное количество назначенных заказов. type: integer format: int32 minimum: 0 maximum: 15001 example: 697 default: 0 stops_count: description: Суммарное количество остановок (неуникальных локаций). type: integer format: int32 minimum: 0 maximum: 15001 example: 87 default: 0 locations_count: description: Суммарное количество уникальный локаций в рамках одного рейса. type: integer format: int32 minimum: 0 maximum: 15001 example: 45 default: 0 cargo_capacity_ratio_mass: description: Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков (по массе). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 10 cargo_capacity_ratio_volume: description: Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков (по обьему). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 cargo_capacity_ratio_capacity_a: description: Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков (по параметру A). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 1 cargo_capacity_ratio_capacity_b: description: Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков (по параметру B). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 2 cargo_capacity_ratio_capacity_c: description: Отношение суммарных аддитивных мер перевезенного груза к суммарной вместимости отсеков (по параметру C). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 3 max_transport_load_mass: description: Отношение максимальной загрузки отсеков к суммарной вместимости отсеков (по массе). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.1 max_transport_load_volume: description: Отношение максимальной загрузки отсеков к суммарной вместимости отсеков (по обьему). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.1 max_transport_load_capacity_a: description: Отношение максимальной загрузки отсеков к суммарной вместимости отсеков (по параметру A). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.1 max_transport_load_capacity_b: description: Отношение максимальной загрузки отсеков к суммарной вместимости отсеков (по параметру B). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.1 max_transport_load_capacity_c: description: Отношение максимальной загрузки отсеков к суммарной вместимости отсеков (по параметру C). type: number format: double minimum: 0 maximum: 1000000 default: 0 example: 0.1 table_trip: description: Trip. type: object additionalProperties: false properties: fields: $ref: '#/components/schemas/table_trip_fields' elements: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_trip_fields' required: - fields - elements table_trip_list: description: Список. type: object additionalProperties: false properties: essences: description: Список. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/table_trip' statistics: $ref: '#/components/schemas/table_list_stats' required: - essences - statistics web_trip: description: Web Trip. type: object additionalProperties: false properties: trip: $ref: '#/components/schemas/trip' trip_statistics: $ref: '#/components/schemas/trip_statistics' fields: $ref: '#/components/schemas/table_trip_fields' linked_essences: $ref: '#/components/schemas/linked_essence_list' required: - trip - trip_statistics basic_tracks_type: description: "Тип трека:\n * `LINE` - соединение точек остановок по прямой\n\ \ * `ROAD` - соединение точек остановок по дорогам\n" type: string enum: - LINE - ROAD default: LINE example: ROAD web_trip_track: description: Трек для отрисовки на карте. type: object additionalProperties: false properties: geopoints: description: Массив географических точек, между которыми построен путь. type: array minItems: 0 maxItems: 1000000 items: $ref: '#/components/schemas/geopoint' trip_key: description: Ключ рейса, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: location01 trip_name: $ref: '#/components/schemas/trip_name' performer_key: description: Ключ исполнителя. type: string minLength: 1 maxLength: 1024 example: performer_01 performer_shift_key: description: Ключ смены исполнителя, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: performer_shift_01 transport_key: description: Ключ транспорта. type: string minLength: 1 maxLength: 1024 example: transport_01 transport_shift_key: description: Ключ смены транспорта, уникальный идентификатор. type: string minLength: 1 maxLength: 1024 example: transport_shift_01 required: - geopoints - trip_key - performer_key - performer_shift_key - transport_key - transport_shift_key web_trip_track_list: description: Треки для отображения на карте. type: object additionalProperties: false properties: tracks: description: Список треков. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/web_trip_track' statistics: $ref: '#/components/schemas/table_list_stats' required: - tracks - statistics web_trip_chart_demand: description: Заявка для отрисовки на диаграмме. type: object additionalProperties: false properties: demand_key: description: Ключ заявки. type: string minLength: 1 maxLength: 1024 example: demand_1 demand_type: $ref: '#/components/schemas/demand_type' required: - demand_key - demand_type web_trip_chart: description: Рейс для отрисовки на диаграмме. type: object additionalProperties: false properties: trip: $ref: '#/components/schemas/trip' chart_demands: description: Список дополнительной информации по запланированным заявкам. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/web_trip_chart_demand' required: - trip - chart_demands web_trip_chart_list: description: Рейсы для отображения на диаграмме. type: object additionalProperties: false properties: charts: description: Данные для диаграммы. type: array uniqueItems: false minItems: 0 maxItems: 15001 items: $ref: '#/components/schemas/web_trip_chart' statistics: $ref: '#/components/schemas/table_list_stats' required: - charts - statistics check_result: description: Результат проверки работоспособности сервиса. type: object additionalProperties: false properties: health: description: "Текущий показатель здоровья сервиса. \n0 означает неготовность\ \ сервиса выполнять задачи. \n1 означает полную готовность сервиса\ \ для выполнения задач.\n" type: number format: double minimum: 0 maximum: 1 example: 0.999 required: - health version_result: description: Версия сервиса. type: object additionalProperties: false properties: major: description: "Версия продукта.\nВ рамках одной версии гарантируется совместимость\ \ общих структур данных между сервисами. \nИзменение версии указывает\ \ на несовместимые с предыдущими версиями продукта (и, соответственно,\ \ всех сервисов) изменения.\n" type: integer format: int32 minimum: 1 maximum: 100 example: 4 minor: description: 'Минорная версия сервиса. Изменение версии указывает на новую функциональность. Обновление имеет обратную совместимость в рамках мажорной версии сервиса. ' type: integer format: int32 minimum: 0 maximum: 111 example: 4 build: description: "Версия сборки. \nИзменяется при обновлении документации\ \ и исправлении ошибок.\n" type: string minLength: 1 maxLength: 64 example: 1754RC required: - major - minor - build file_html: description: Файл с данными в формате [HTML](https://html.spec.whatwg.org/). type: string file_json: description: Файл с данными в формате [JSON](https://www.json.org/). type: string examples: DataExplorer: summary: Пример проводника value: key: 5fffc47c-8239-42c4-8a3f-95d0ed235173 type: ROOT name: ROOT statistics: folders_count: 1 experiments_count: 3 elements: - key: 2bff0b86-2ddc-445c-9d98-f75ca2eec091 type: FOLDER name: MyFolder statistics: folders_count: 0 experiments_count: 3 elements: [] Result400: summary: Ошибка в данных value: tracedata: code: 215b87e0-4407-4e0f-b2cc-8540f8f0cad7 client: veeroute_|_example server: edge service: UNIVERSAL operation: run_plan_calculation time: '2024-02-28T17:13:27.945583194Z' message: logical schema_errors: [] logical_errors: - type: UNIQUE_IDS_VIOLATION entities: - entity_key: order_1 entity_type: ORDER warnings: [] ExperimentList: summary: Список экспериментов value: experiments: - key: 65fb88e5-128d-4f3f-9a50-4c2754adcbed specification: name: Exp_1 comment: long long long long text folder_key: 65fb88e5-128d-4f3f-9a50-4c2754adcbed settings: plan_settings: trips_settings: configuration: optimize_distance trip_start_time_strategy: LOWEST_COST assumptions: transport_factor: [] capacity_factor: [] disable_compatibility: true disable_capacity: true same_order_time_window: true expand_shift_time_window: true penalties: compatibilities: [] geo_settings: geo_provider: OSRM toll_roads: false ferry_crossing: false traffic_jams: false flight_distance: true restricted_zones: - ART_MOSCOW_MKAD_CARGO_FRAME calculation_settings: max_calculation_time: PT4M30S max_waiting_time: PT2H result_ttl: PT4M30S result_timezone: 3 treat_warnings_as_errors: true precision: 3 replan_settings: replan_strategy: reorder: true plan_new_orders: true create_new_trips: true trips_settings: configuration: optimize_distance trip_start_time_strategy: LOWEST_COST assumptions: transport_factor: [] capacity_factor: [] disable_compatibility: true disable_capacity: true same_order_time_window: true expand_shift_time_window: true penalties: compatibilities: [] geo_settings: geo_provider: OSRM toll_roads: false ferry_crossing: false traffic_jams: false flight_distance: true restricted_zones: - ART_MOSCOW_MKAD_CARGO_FRAME calculation_settings: max_calculation_time: PT4M30S max_waiting_time: PT2H result_ttl: PT4M30S result_timezone: 3 treat_warnings_as_errors: true precision: 3 actualize_settings: current_time: '2024-02-21T09:30:00+03:00' geo_settings: geo_provider: OSRM toll_roads: false ferry_crossing: false traffic_jams: false flight_distance: true restricted_zones: - ART_MOSCOW_MKAD_CARGO_FRAME calculation_settings: max_calculation_time: PT4M30S max_waiting_time: PT2H result_ttl: PT4M30S result_timezone: 3 treat_warnings_as_errors: true precision: 3 statistics: indicators: - total_statistics_cost - total_statistics_measurements_waiting_time total_statistics: cost: 1231.1 reward: 2343.3 measurements: driving_time: PT2H waiting_time: PT2H break_time: PT2H working_time: PT2H arriving_time: PT2H departure_time: PT2H total_time: PT2H distance: 5200 time_window: from: '2024-02-21T09:30:00+03:00' to: '2024-02-21T19:45:00Z' trips_count: 250 performers_count: 157 orders_count: 1700 plan_orders_count: 1003 waitlist_orders_count: 697 cargo_capacity_ratio: mass: 10 volume: 2 capacity_a: 1 capacity_b: 2 capacity_c: 3 max_transport_load: mass: 10 volume: 2 capacity_a: 1 capacity_b: 2 capacity_c: 3 quality: soft_time_window_violations: before: keys: - obj1 count: 1700 after: keys: - obj1 count: 1700 hard_time_window_violations: before: keys: - obj1 count: 1700 after: keys: - obj1 count: 1700 data_statistics: locations: 1 orders: 1 performers: 1 transports: 1 hardlinks: 1 trips: 1 external_routing: false unplanned_items: order_keys: - key_01 order_keys_count: 99 performer_keys: - key_01 performer_keys_count: 99 transport_keys: - key_01 transport_keys_count: 99 hardlink_keys: - key_01 hardlink_keys_count: 99 progress: 52 calculation: progress: 52 info: status: FINISHED_IN_TIME result_version: 133 preparing_time: PT2H business_validation_time: PT2H math_validation_time: PT2H waiting_time: PT2H calculation_time: PT2H tracedata: code: 11111111-2222-3333-4444-555555555555 client: company_|_username server: server_name service: STUDIO operation: run_plan_calculation time: '2024-02-21T09:30:00+03:00' check: logical_errors: [] warnings: [] pristine: false sharing: true edit_date: '2024-02-21T19:45:00Z' creation_date: '2024-02-21T19:45:00Z' statistics: overall: total: 1 filter: total: 1 Experiment: summary: Пример эксперимента value: key: da4e62b0-86cb-4423-b187-5c1a633ca703 specification: name: new experiment 1000 comment: '' folder_key: 2bff0b86-2ddc-445c-9d98-f75ca2eec091 settings: plan_settings: trips_settings: configuration: default trip_start_time_strategy: EARLIEST_FINISH assumptions: transport_factor: [] capacity_factor: [] disable_compatibility: false disable_capacity: false same_order_time_window: false expand_shift_time_window: false penalties: compatibilities: [] geo_settings: geo_provider: OSRM toll_roads: true ferry_crossing: true traffic_jams: true flight_distance: false calculation_settings: max_calculation_time: PT20M max_waiting_time: PT30M result_ttl: PT20M result_timezone: 0 treat_warnings_as_errors: false precision: 2 replan_settings: replan_strategy: reorder: false plan_new_orders: false create_new_trips: false trips_settings: configuration: default trip_start_time_strategy: EARLIEST_FINISH assumptions: transport_factor: [] capacity_factor: [] disable_compatibility: false disable_capacity: false same_order_time_window: false expand_shift_time_window: false penalties: compatibilities: [] geo_settings: geo_provider: OSRM toll_roads: true ferry_crossing: true traffic_jams: true flight_distance: false calculation_settings: max_calculation_time: PT20M max_waiting_time: PT30M result_ttl: PT20M result_timezone: 0 treat_warnings_as_errors: false precision: 2 actualize_settings: geo_settings: geo_provider: OSRM toll_roads: true ferry_crossing: true traffic_jams: true flight_distance: false calculation_settings: max_calculation_time: PT20M max_waiting_time: PT30M result_ttl: PT20M result_timezone: 0 treat_warnings_as_errors: false precision: 2 statistics: indicators: - data_statistics_hardlinks - data_statistics_locations - data_statistics_orders - data_statistics_performers - data_statistics_transports - data_statistics_trips - total_statistics_max_transport_load_capacity_a - total_statistics_max_transport_load_capacity_b - total_statistics_max_transport_load_capacity_c - total_statistics_max_transport_load_mass - total_statistics_max_transport_load_volume - total_statistics_cargo_capacity_ratio_capacity_a - total_statistics_cargo_capacity_ratio_capacity_b - total_statistics_cargo_capacity_ratio_capacity_c - total_statistics_cargo_capacity_ratio_mass - total_statistics_cargo_capacity_ratio_volume - total_statistics_cost - total_statistics_measurements_arriving_time - total_statistics_measurements_departure_time - total_statistics_measurements_distance - total_statistics_measurements_driving_time - total_statistics_measurements_time_window_from - total_statistics_measurements_time_window_to - total_statistics_measurements_total_time - total_statistics_measurements_waiting_time - total_statistics_measurements_working_time - total_statistics_orders_count - total_statistics_performers_count - total_statistics_plan_orders_count - total_statistics_quality_hard_time_window_violations_after_count - total_statistics_quality_hard_time_window_violations_before_count - total_statistics_quality_soft_time_window_violations_after_count - total_statistics_quality_soft_time_window_violations_before_count - total_statistics_reward - total_statistics_waitlist_orders_count total_statistics: cost: 0 reward: 0 measurements: driving_time: P0D waiting_time: P0D break_time: P0D working_time: P0D arriving_time: P0D departure_time: P0D total_time: P0D distance: 0 time_window: from: '2024-02-15T13:56:07.697Z' to: '2024-02-15T13:56:07.697Z' performers_count: 0 trips_count: 0 orders_count: 0 plan_orders_count: 0 waitlist_orders_count: 0 cargo_capacity_ratio: mass: 0 volume: 0 capacity_a: 0 capacity_b: 0 capacity_c: 0 max_transport_load: mass: 0 volume: 0 capacity_a: 0 capacity_b: 0 capacity_c: 0 quality: soft_time_window_violations: before: keys: [] count: 0 after: keys: [] count: 0 hard_time_window_violations: before: keys: [] count: 0 after: keys: [] count: 0 data_statistics: locations: 958 orders: 1000 performers: 1000 transports: 1000 hardlinks: 0 trips: 0 external_routing: false pristine: true edit_date: '2024-02-15T13:56:07.728Z' creation_date: '2024-02-15T13:56:07.728Z' progress: 0 sharing: false parameters: folder_key: name: folder_key description: Ключ папки, уникальный идентификатор. in: path required: true schema: $ref: '#/components/schemas/unique_key' filter: name: filter description: Фильтр для поиска по текстовым полям. in: query required: false schema: description: Фильтр для поиска по текстовым полям. type: string minLength: 1 maxLength: 64 example: example text offset: name: offset description: Количество пропущенных сущностей до возвращаемого списка. in: query schema: description: Количество пропущенных сущностей до возвращаемого списка. type: integer format: int32 minimum: 0 maximum: 10000000 default: 0 example: 10 required: false limit: name: limit description: Максимальное количество возвращаемых сущностей. in: query schema: description: Максимальное количество возвращаемых сущностей. type: integer format: int32 minimum: 1 maximum: 10000000 default: 100 example: 10 required: false sort_direction: name: sort_direction description: Направление сортировки. in: query required: false schema: description: Направление сортировки. type: string nullable: false enum: - ASC - DESC default: ASC example: DESC experiment_key: name: experiment_key description: Ключ, уникальный идентификатор. in: path required: true schema: $ref: '#/components/schemas/unique_key' process_name: name: process_name description: "Название процесса обработки данных:\n * `PLAN` - планирование\n\ \ * `REPLAN` - перепланирование\n * `ACTUALIZE` - актуализация\n" in: path required: true schema: $ref: '#/components/schemas/basic_process' timezone: name: timezone description: Временная зона. in: query required: false schema: description: Целевая временная зона данных. type: integer format: int32 minimum: -12 maximum: 12 default: 0 example: 3 tracecode: name: tracecode description: Уникальный идентификатор процесса. in: path required: true schema: description: Уникальный идентификатор процесса. type: string format: uuid example: 11111111-2222-3333-4444-555555555555 table_location_column: name: sort_field description: 'Название колонки в таблице с локациями. ' in: query required: false schema: $ref: '#/components/schemas/table_location_column_type' essence_key: name: essence_key description: Ключ. in: path required: true schema: $ref: '#/components/schemas/basic_essence_key' table_performer_column: name: sort_field description: 'Название колонки в таблице с исполнителями. ' in: query required: false schema: $ref: '#/components/schemas/table_performer_column_type' table_transport_column: name: sort_field description: 'Название колонки в таблице с транспортом. ' in: query required: false schema: $ref: '#/components/schemas/table_transport_column_type' table_order_column: name: sort_field description: 'Название колонки в таблице с заказами. ' in: query required: false schema: $ref: '#/components/schemas/table_order_column_type' table_hardlink_column: name: sort_field description: 'Название колонки в таблице со связями. ' in: query required: false schema: $ref: '#/components/schemas/table_hardlink_column_type' table_trip_column: name: sort_field description: 'Название колонки в таблице с рейсами. ' in: query required: false schema: $ref: '#/components/schemas/table_trip_column_type' tracks_type: name: tracks_type description: "Тип трека:\n * `LINE` - соединение точек остановок по прямой\n\ \ * `ROAD` - соединение точек остановок по дорогам\n" in: path required: true schema: $ref: '#/components/schemas/basic_tracks_type' filename: name: filename description: Название файла. in: path required: true schema: description: Название файла. type: string minLength: 6 maxLength: 128 example: file_en.html x-tagGroups: - name: General tags: - Explorer - Experiments - System - name: Essences tags: - Locations - Orders - Performers - Transports - Hardlinks - Trips - Facts