VRt.Monitor [MT] (7.9.2527)
Программный интерфейс для инструмента Veeroute Monitor.
Чтение рейса
Получение информации о рейсе по его ключу.
Authorizations:
ApiKeyAuth
path Parameters
| essence_key required | string or null (basic_essence_key) [ 1 .. 1024 ] characters Default: null Example: key01 Ключ, уникальный идентификатор. |
Responses
Response Schema: application/json
required | object (trip) Рейс - это совокупность работ, запланированных на выполнение конкретным исполнителем на конкретном транспорте, выраженных через изменение состояний исполнителя. |
required | object (trip_statistics) Статистика по конкретному рейсу. |
object (table_trip_fields) Табличные поля рейса и остановок. | |
Array of objects (linked_essence_list) [ 0 .. 15001 ] items Список связанных сущностей. |
Response samples
- 200
- 400
- 402
- 403
- 404
- 429
- 500
Content type
application/json
{- "trip": {
- "key": "trip-0000-9999",
- "name": "1-ABC",
- "performer": {
- "performer_key": "performer0001",
- "shift_key": "performer0001_shift01",
- "shift_time": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}
}, - "transport": {
- "transport_key": "transport001",
- "shift_key": "performer01",
- "shift_time": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}
}, - "states": [
- {
- "time": "2024-11-21T09:30:00+03:00",
- "order_key": "order01",
- "demand_key": "demand01.1",
- "event_key": "event01",
- "location_key": "location_01",
- "flags": [
- "RELOCATING"
], - "cargo_actions": [
- {
- "box_key": "box01",
- "cargo_key": "cargo01",
- "cargo_action_type": "ADD"
}
], - "distance": 5200,
- "cost": 1231.1,
- "reward": 2343.3,
- "attributes": [ ]
}
], - "waitlist": [
- "order02"
], - "attributes": [ ]
}, - "trip_statistics": {
- "trip_key": "trip01",
- "general_statistics": {
- "cost": 1231.1,
- "reward": 2343.3,
- "profit": 1231.1,
- "measurements": {
- "time_window": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}, - "driving_time": "PT1H45M",
- "waiting_time": "PT1H45M",
- "working_time": "PT1H45M",
- "break_time": "PT1H45M",
- "rest_time": "PT1H45M",
- "arriving_time": "PT1H45M",
- "departure_time": "PT1H45M",
- "total_time": "PT1H45M",
- "distance": 5200
}, - "trips_count": 250,
- "performers_count": 157,
- "orders_count": 1700,
- "plan_orders_count": 1003,
- "waitlist_orders_count": 697,
- "stops_count": 87,
- "locations_count": 45,
- "cargo_capacity_sum": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}, - "cargo_capacity_ratio": {
- "mass": 0.5,
- "volume": 0.1,
- "capacity_a": 0.7,
- "capacity_b": 0.8,
- "capacity_c": 0.9
}, - "max_transport_load": {
- "mass": 0.5,
- "volume": 0.1,
- "capacity_a": 0.7,
- "capacity_b": 0.8,
- "capacity_c": 0.9
}, - "average_speed": 43.1,
- "round_trips_count": 2,
- "attributes": [ ]
}, - "load_statistics": {
- "total_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "max_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "max_transfer_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}
}, - "stop_statistics": [
- {
- "location_key": "location_01",
- "stop_demands": [
- {
- "demand_key": "demand_key_01",
- "event_key": "event_key_01",
- "demand_time_window": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}
}
], - "stop_time_window": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}, - "measurements": {
- "time_window": {
- "from": "2024-11-21T09:30:00+03:00",
- "to": "2024-11-21T19:45:00Z"
}, - "driving_time": "PT1H45M",
- "waiting_time": "PT1H45M",
- "working_time": "PT1H45M",
- "break_time": "PT1H45M",
- "rest_time": "PT1H45M",
- "arriving_time": "PT1H45M",
- "departure_time": "PT1H45M",
- "total_time": "PT1H45M",
- "distance": 5200
}, - "upload": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "download": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "max_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "arrival_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}, - "departure_load": {
- "count": 1460,
- "capacity": {
- "mass": 105500,
- "volume": 220034,
- "capacity_a": 100000,
- "capacity_b": 200000,
- "capacity_c": 300000
}
}
}
], - "attributes": [ ]
}, - "fields": {
- "essence_key": "key01",
- "essence_type": "TRIP",
- "enabled": false,
- "pristine": false,
- "trip_name": "1-ABC",
- "attributes": "key1:value1, key2:value2",
- "cost": 1231.1,
- "reward": 2343.3,
- "profit": 1231.1,
- "driving_time": "PT1H45M",
- "waiting_time": "PT1H45M",
- "break_time": "PT1H45M",
- "rest_time": "PT1H45M",
- "working_time": "PT1H45M",
- "arriving_time": "PT1H45M",
- "departure_time": "PT1H45M",
- "total_time": "PT1H45M",
- "distance": 5200,
- "time_window": {
- "from": "2024-11-21T08:45:00+03:00",
- "to": "2024-11-21T19:45:00+03:00"
}, - "orders_count": 1700,
- "plan_orders_count": 1003,
- "waitlist_orders_count": 697,
- "stops_count": 87,
- "locations_count": 45,
- "cargo_capacity_ratio_mass": 10,
- "cargo_capacity_ratio_volume": 2,
- "cargo_capacity_ratio_capacity_a": 1,
- "cargo_capacity_ratio_capacity_b": 2,
- "cargo_capacity_ratio_capacity_c": 3,
- "max_transport_load_mass": 0.1,
- "max_transport_load_volume": 0.1,
- "max_transport_load_capacity_a": 0.1,
- "max_transport_load_capacity_b": 0.1,
- "max_transport_load_capacity_c": 0.1
}, - "linked_essences": [
- {
- "essence_key": "key01",
- "essence_type": "LOCATION"
}
]
}Проверка доступности
Проверка доступности сервиса.
Responses
Response Schema: application/json
| health required | number <double> [ 0 .. 1 ] Example: "0.999" Текущий показатель здоровья сервиса.
|
Response samples
- 200
- 404
- 429
- 500
Content type
application/json
{- "health": 0.999
}Получение версии сервиса
Получение версии сервиса.
Responses
Response Schema: application/json
| major required | integer <int32> [ 1 .. 100 ] Example: "7" Версия продукта.
В рамках одной версии гарантируется совместимость общих структур данных между сервисами. |
| minor required | integer <int32> [ 0 .. 111 ] Example: "5" Минорная версия сервиса. Изменение версии указывает на новую функциональность. Обновление имеет обратную совместимость в рамках мажорной версии сервиса. |
| build required | string [ 1 .. 64 ] characters Example: "3754RC" Версия сборки. |
Response samples
- 200
- 404
- 429
- 500
Content type
application/json
{- "major": 7,
- "minor": 5,
- "build": "3754RC"
}Получение документации
Получение файла с документацией на этот сервис.
path Parameters
| filename required | string [ 6 .. 128 ] characters Example: file_en.html Название файла. |
Responses
Response Schema:
string (file_html)
Файл с данными в формате HTML.
Response samples
- 404
- 429
- 500
Content type
application/json
{- "resource_key": "resource_key",
- "detail": {
- "tracedata": {
- "process_code": "11111111-2222-3333-4444-555555555555",
- "request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
- "username": "username_for_login",
- "company": "smart_company",
- "service": "UNIVERSAL",
- "operation": "run_plan_calculation",
- "env": "edge7",
- "pod": "11111111-2222-3333-4444-555555555555",
- "time": "2024-11-21T09:30:00+03:00"
}
}
}