Euro Truck Simulator 2 Delivery API

1.4.0 OAS 3.0

[ Base URL: https://api.ets2-telemetry.local/api/v1 ]

Официальный интерфейс REST API для доступа к телеметрии грузовиков, текущим заказам на доставку, бирже грузов и профилю водителя в Euro Truck Simulator 2. Используется для построения внешних приборных панелей (dashboards), диспетчерских систем виртуальных транспортных компаний (VTC) и интеграции с ботами.

Скачать OpenAPI spec (json) Поддержка разработчиков Мод ETS2 Telemetry Server

Jobs & Deliveries Управление контрактами, биржей грузов и текущей доставкой

GET /api/v1/jobs/available Получить список доступных контрактов/грузов

Доставка

Возвращает список актуальных контрактов на перевозку грузов по всей Европе с возможностью фильтрации по городам отправления и назначения.

Параметры запроса

Ответы сервера (Responses)

Code: 200 OK Content-Type: application/json

{
  "status": "success",
  "total_jobs": 2,
  "jobs": [
    {
      "job_id": "job_ets2_9821",
      "cargo_name": "Medical Supplies (Медикаменты)",
      "cargo_weight_kg": 12500,
      "city_from": "Berlin",
      "company_from": "LKW Log",
      "city_to": "Praha",
      "company_to": "ITCC",
      "payout_euro": 8450.00,
      "distance_km": 350,
      "expiration_minutes": 45,
      "urgency": "urgent"
    },
    {
      "job_id": "job_ets2_4412",
      "cargo_name": "Heavy Machinery (Тяжелая техника)",
      "cargo_weight_kg": 24000,
      "city_from": "Warszawa",
      "company_from": "Posped",
      "city_to": "Berlin",
      "company_to": "TradeAux",
      "payout_euro": 14200.00,
      "distance_km": 570,
      "expiration_minutes": 120,
      "urgency": "normal"
    }
  ]
}

POST /api/v1/jobs/accept Взять выбранный груз в работу

Доставка

Назначает указанный груз выбранному грузовику водителя и формирует маршрут в GPS навигаторе.

Тело запроса (Request Body)

Ответ сервера

Code: 200 OK Content-Type: application/json

{
  "status": "accepted",
  "message": "Контракт официально принят в работу!",
  "assigned_job": {
    "job_id": "job_ets2_9821",
    "cargo": "Medical Supplies",
    "route": "Berlin -> Praha",
    "gps_distance_km": 350,
    "deadline_time": "2026-09-22T18:30:00Z"
  }
}

GET /api/v1/deliveries/current Статус текущей активной доставки в реальном времени

Доставка

Возвращает телеметрический статус текущего рейса: координаты, остаток расстояния, повреждение груза и остаток топлива.

Параметры

Ответ сервера

Code: 200 OK Content-Type: application/json

{
  "active_delivery": true,
  "job_id": "job_ets2_9821",
  "cargo": "Medical Supplies",
  "source": {
    "city": "Berlin",
    "company": "LKW Log"
  },
  "destination": {
    "city": "Praha",
    "company": "ITCC"
  },
  "progress": {
    "remaining_distance_km": 142,
    "eta_minutes": 95,
    "cargo_damage_percent": 0.4
  },
  "truck_status": {
    "fuel_remaining_liters": 380.5,
    "wear_engine_percent": 1.2
  }
}

POST /api/v1/deliveries/complete Завершить доставку и расчитать финальную выплату и XP

Доставка

Вызывается при парковке трейлера в точке назначения. Рассчитывает штрафы за повреждения/опоздания, начисляя итоговый баланс и опыт.

Тело запроса (Request Body)

Ответ сервера

Code: 200 OK Content-Type: application/json

{
  "summary": {
    "status": "completed",
    "base_payout": 8450.00,
    "parking_bonus": 90.00,
    "damage_penalty": 0.00,
    "fines_deduction": 150.00,
    "final_payout_euro": 8390.00,
    "xp_earned": 1240
  },
  "driver_new_balance": 154200.50
}

Telemetry & Vehicle Живые показатели спидометра, датчиков двигателя и спидометра

GET /api/v1/telemetry/truck Живые физические данные грузовика в игре

Телеметрия

Считывает мгновенные данные из памяти процесса игры (скорость км/ч, передачи, статус фар, круиз-контроль).

Параметры

Ответ сервера

Code: 200 OK Content-Type: application/json

{
  "truck": {
    "brand": "Scania",
    "model": "S730 Super 4x2",
    "speed_kmh": 83.4,
    "engine_rpm": 1250,
    "gear": 11,
    "engine_running": true,
    "cruise_control_enabled": true,
    "cruise_control_speed": 85,
    "fuel": {
      "current_liters": 420.0,
      "capacity_liters": 700.0,
      "avg_consumption_l100km": 31.2
    },
    "lights": {
      "low_beam": true,
      "high_beam": false,
      "blinker_left": false,
      "blinker_right": false
    },
    "current_city": "A2 Highway (near Poznań)"
  }
}

Driver Profile & Economy Профиль игрока, баланс, гаражи и статистика

GET /api/v1/driver/profile Информация о профиле водителя и экономике

Профиль

Возвращает общее состояние компании игрока, текущий баланс, рейтинг дальнобойщика и список гаражей.

Параметры

Ответ сервера

Code: 200 OK Content-Type: application/json

{
  "driver_name": "Alex_Trucker59",
  "company_name": "Nordic Logistics Express",
  "level": 34,
  "rank_title": "Master of the Highway",
  "balance_euro": 154200.50,
  "stats": {
    "total_distance_km": 128450,
    "completed_jobs": 210,
    "rating_stars": 4.9
  },
  "garages": [
    { "city": "Berlin", "size": "large", "trucks_count": 5 },
    { "city": "Warszawa", "size": "small", "trucks_count": 2 }
  ]
}

Schemas / Схемы данных

JobContract {object}

job_id *string — Уникальный ID контракта

cargo_name *string — Наименование груза

cargo_weight_kg integer — Вес в килограммах

payout_euro number — Оплата за транспортировку (€)

urgency string (enum) — [normal, urgent]

TruckTelemetry {object}

brand *string — Производитель (Scania, Volvo, MAN, DAF)

speed_kmh number — Текущая скорость (км/ч)

engine_rpm integer — Обороты двигателя

gear integer — Включенная передача (0=Neutral, -1=Reverse)