API für mechanische Diagnostik - Steer Autos Documentation

POST /v1/inspections/mechanical

Führen Sie eine umfassende mechanische Diagnostik mithilfe von OBD-II-Daten, Sensormesswerten und KI-gestützter Analyse durch. Erkennt Motorprobleme, Getriebeprobleme, Bremsenverschleiß und mehr.

Anfrage

curl -X POST "https://api.steerai.autos/v1/inspections/mechanical" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "obd_data": {
      "dtcs": ["P0420", "P0171"],
      "live_data": {
        "engine_rpm": 850,
        "coolant_temp": 92,
        "intake_temp": 25,
        "maf_rate": 3.2,
        "throttle_position": 0,
        "fuel_pressure": 380,
        "o2_sensor_voltage": 0.45,
        "timing_advance": 15
      },
      "freeze_frame": {
        "P0420": {
          "engine_rpm": 2800,
          "vehicle_speed": 65,
          "coolant_temp": 95
        }
      }
    },
    "test_results": {
      "battery_voltage": 12.6,
      "alternator_output": 14.2,
      "brake_fluid_level": "ok",
      "engine_oil_level": "ok",
      "coolant_level": "ok",
      "transmission_fluid": "ok"
    },
    "options": {
      "include_recommendations": true,
      "severity_threshold": "minor"
    }
  }'

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`vehicle_id`	string	Ja	Fahrzeugkennung
`obd_data`	object	Ja	OBD-II-Diagnosedaten
`obd_data.dtcs`	array	Nein	Diagnose-Fehlercodes
`obd_data.live_data`	object	Ja	Echtzeit-Sensordaten
`test_results`	object	Nein	Manuelle Inspektionsresultate
`options.include_recommendations`	boolean	Nein	Reparaturempfehlungen einschließen (Standard: true)
`options.severity_threshold`	string	Nein	Mindestschweregrad für Meldung: `minor`, `moderate`, `severe` (Standard: `minor`)

Live-Data-Parameter

Parameter	Einheit	Beschreibung
`engine_rpm`	RPM	Motordrehzahl pro Minute
`coolant_temp`	°C	Motorkühlmitteltemperatur
`intake_temp`	°C	Ansauglufttemperatur
`maf_rate`	g/s	Luftmassenstromrate
`throttle_position`	%	Drosselklappenstellung (0-100)
`fuel_pressure`	kPa	Kraftstoffdruck an der Rail
`o2_sensor_voltage`	V	Spannung am Sauerstoffsensor
`timing_advance`	°	Zündzeitpunktverstellung
`vehicle_speed`	km/h	Fahrzeuggeschwindigkeit
`engine_load`	%	Berechnete Motorlast

Antwort

{
  "status": "success",
  "data": {
    "diagnostic_id": "mech_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "status": "completed",
    "created_at": "2024-01-15T11:00:00Z",
    "completed_at": "2024-01-15T11:00:15Z",
    "results": {
      "overall_health": "fair",
      "health_score": 6.8,
      "confidence": 0.91,
      "systems": [
        {
          "system": "engine",
          "status": "needs_attention",
          "health_score": 7.0,
          "issues": [
            {
              "issue_id": "eng_cat_efficiency",
              "component": "catalytic_converter",
              "severity": "moderate",
              "status": "active",
              "description": "Catalytic converter efficiency below threshold",
              "dtc": "P0420",
              "confidence": 0.94,
              "symptoms": [
                "Reduced fuel efficiency",
                "Failed emissions test possible",
                "Check engine light on"
              ],
              "recommended_action": "Replace catalytic converter",
              "urgency": "medium",
              "estimated_repair": {
                "min": 800,
                "max": 1500,
                "currency": "USD",
                "labor_hours": 2.5
              }
            },
            {
              "issue_id": "eng_fuel_trim",
              "component": "fuel_system",
              "severity": "minor",
              "status": "active",
              "description": "System running lean (Bank 1)",
              "dtc": "P0171",
              "confidence": 0.88,
              "symptoms": [
                "Rough idle",
                "Slight hesitation on acceleration",
                "Decreased fuel efficiency"
              ],
              "possible_causes": [
                "Vacuum leak",
                "Dirty MAF sensor",
                "Fuel filter restriction",
                "Weak fuel pump"
              ],
              "recommended_action": "Inspect for vacuum leaks, clean MAF sensor",
              "urgency": "low",
              "estimated_repair": {
                "min": 150,
                "max": 400,
                "currency": "USD",
                "labor_hours": 1.5
              }
            }
          ]
        },
        {
          "system": "transmission",
          "status": "good",
          "health_score": 8.5,
          "issues": []
        },
        {
          "system": "brakes",
          "status": "good",
          "health_score": 8.2,
          "issues": []
        },
        {
          "system": "electrical",
          "status": "good",
          "health_score": 9.0,
          "issues": [],
          "notes": "Battery voltage and alternator output within normal range"
        },
        {
          "system": "cooling",
          "status": "good",
          "health_score": 8.8,
          "issues": []
        },
        {
          "system": "emissions",
          "status": "needs_attention",
          "health_score": 6.5,
          "issues": [
            {
              "issue_id": "emis_cat_001",
              "component": "catalytic_converter",
              "severity": "moderate",
              "status": "active",
              "description": "Emissions system efficiency degraded",
              "recommended_action": "Replace catalytic converter to meet emissions standards"
            }
          ]
        }
      ],
      "maintenance_schedule": {
        "overdue": [],
        "due_soon": [
          {
            "service": "engine_oil_change",
            "miles_remaining": 1200,
            "recommended_date": "2024-02-15"
          }
        ],
        "upcoming": [
          {
            "service": "tire_rotation",
            "miles_remaining": 3500,
            "recommended_date": "2024-04-01"
          }
        ]
      },
      "summary": {
        "total_issues": 2,
        "by_severity": {
          "minor": 1,
          "moderate": 1,
          "severe": 0,
          "critical": 0
        },
        "by_urgency": {
          "immediate": 0,
          "high": 0,
          "medium": 1,
          "low": 1
        },
        "total_estimated_repair": {
          "min": 950,
          "max": 1900,
          "currency": "USD"
        },
        "systems_affected": ["engine", "emissions"]
      }
    },
    "reports": {
      "pdf_url": "https://reports.steerai.autos/mech_1234567890abcdef.pdf",
      "json_url": "https://api.steerai.autos/v1/inspections/mechanical/mech_1234567890abcdef/report"
    }
  },
  "meta": {
    "request_id": "req_mech_xyz789",
    "processing_time": 15.123,
    "diagnostic_protocols": ["OBD-II", "CAN", "AI_Analysis"]
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`diagnostic_id`	string	Eindeutige Kennung der Diagnostikinspektion
`results.overall_health`	string	`excellent`, `good`, `fair`, `poor`, `critical`
`results.health_score`	float	Gesamt-Health-Score (0–10)
`systems[].system`	string	Name des Fahrzeugsystems
`systems[].status`	string	`good`, `needs_attention`, `critical`
`issues[].severity`	string	`minor`, `moderate`, `severe`, `critical`
`issues[].urgency`	string	`immediate`, `high`, `medium`, `low`
`issues[].dtc`	string	OBD-II-Diagnose-Fehlercode

Fahrzeugsysteme

Motorsystem

Analysierte Komponenten: • Motorleistung und Effizienz • Kraftstoffsystem und Einspritzdüsen • Ansaugsystem und MAF-Sensor • Zündanlage und Zündzeitpunkt • Öldruck und Ölzustand • Kompression und Zylinderzustand

Getriebesystem

Analysierte Komponenten: • Schaltverhalten • Zustand des Getriebeöls • Kupplungsverschleiß (manuell) • Drehmomentwandler (automatisch) • Übersetzungen und Synchronringe • Elektronische Steuerung

Bremssystem

Analysierte Komponenten: • Bremsbelag-/Backenstärke • Zustand von Scheiben/Trommeln • Bremsflüssigkeitsstand und -qualität • ABS-Funktionalität • Bremsdruck und Reaktion • Elektronische Stabilitätskontrolle

Elektriksystem

Analysierte Komponenten: • Batteriespannung und -zustand • Lichtmaschinenleistung • Starterfunktion • Beleuchtungssysteme • Elektronische Steuergeräte • Sensor-Diagnostik

Kühlsystem

Analysierte Komponenten: • Kühlmittelstand und -zustand • Kühler und Schläuche • Wasserpumpenbetrieb • Thermostatfunktion • Lüfterbetrieb • Temperaturregelung

Abgassystem

Analysierte Komponenten: • Katalysator-Effizienz • Sauerstoffsensoren • EVAP-Systemintegrität • EGR-Ventilfunktion • PCV-System • Emissions-Compliance

Häufige DTCs (Diagnose-Fehlercodes)

Code	System	Beschreibung	Typische Ursache
P0420	Abgas	Katalysator-Effizienz unter Schwelle	Defekter Katalysator
P0171	Motor	System zu mager (Bank 1)	Unterdruckleck, verschmutzter MAF
P0300	Motor	Zufällige/mehrfache Zündaussetzer	Zündkerzen, Spulen, Kraftstoff
P0401	Abgas	EGR-Durchfluss unzureichend	Verstopftes EGR-Ventil
P0456	Abgas	EVAP-Kleinstleck erkannt	Loser Tankdeckel, Leck
P0442	Abgas	EVAP-Mittelleck erkannt	Gerissene Schläuche, Spülventil

Fehlerantworten

400 Ungültige Anfrage

{
  "status": "error",
  "error": {
    "code": "INVALID_OBD_DATA",
    "message": "OBD data format is invalid or incomplete",
    "type": "validation_error",
    "field": "obd_data.live_data"
  }
}

422 Nicht verarbeitbare Entität

{
  "status": "error",
  "error": {
    "code": "VEHICLE_NOT_OBD_COMPATIBLE",
    "message": "Vehicle does not support OBD-II diagnostics (pre-1996 model)",
    "type": "validation_error",
    "details": {
      "vehicle_year": 1994,
      "minimum_year": 1996
    }
  }
}

Integration mit Hardware

OBD-II-Adapter

Kompatible Geräte• Bluetooth-OBD-II-Adapter • WiFi-OBD-II-Adapter • USB-OBD-II-Leser • Professionelle Diagnosegeräte • Mobile Diagnose-Apps

Datenprotokolle

Unterstützte Protokolle• ISO 15765-4 (CAN) • ISO 14230-4 (KWP2000) • ISO 9141-2 • SAE J1850 PWM • SAE J1850 VPW

DeepDiag-Integration

Für erweiterte Diagnostik über OBD-II hinaus integrieren Sie DeepDiag, unsere umfassende Diagnoseplattform:

curl -X POST "https://api.steerai.autos/v1/inspections/deepdiag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "diagnostic_level": "comprehensive",
    "include_mechanical": true
  }'

Pro-Tipp: Kombinieren Sie mechanische Diagnostik mit visueller Inspektion für eine vollständige Fahrzeugbewertung. Bündeln Sie beide API-Aufrufe für vergünstigte Preise.

Webhooks

{
  "event": "mechanical_diagnostic.completed",
  "timestamp": "2024-01-15T11:00:15Z",
  "data": {
    "diagnostic_id": "mech_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "overall_health": "fair",
    "health_score": 6.8,
    "issues_found": 2,
    "critical_issues": 0,
    "report_url": "https://reports.steerai.autos/mech_1234567890abcdef.pdf"
  }
}

Bewährte Praktiken

Datenschutz: OBD-II-Daten können sensible Fahrzeuginformationen enthalten. Stellen Sie sicher, dass Sie vor dem Erfassen und Übermitteln diagnostischer Daten eine ordnungsgemäße Autorisierung haben.

Regelmäßige Diagnostik: Diagnosen alle 3.000–5.000 Meilen für optimales Monitoring durchführen
Mehrere Datenpunkte: Daten unter verschiedenen Bedingungen erfassen (Leerlauf, Beschleunigung, Autobahn)
Baseline festlegen: Basiswerte für gesunde Fahrzeuge definieren
Trend-Analyse: Veränderungen im Zeitverlauf beobachten, um Ausfälle vorherzusagen
Kombination mit visueller Inspektion: Mechanische und visuelle Inspektion kombinieren

API-Dokumentation

​POST /v1/inspections/mechanical

​Anfrage

​Anfrage-Body

​Live-Data-Parameter

​Antwort

​Antwortfelder

​Fahrzeugsysteme

​Häufige DTCs (Diagnose-Fehlercodes)

​Fehlerantworten

​400 Ungültige Anfrage

​422 Nicht verarbeitbare Entität

​Integration mit Hardware

OBD-II-Adapter

Datenprotokolle

​DeepDiag-Integration

​Webhooks

​Bewährte Praktiken

POST /v1/inspections/mechanical

Anfrage

Anfrage-Body

Live-Data-Parameter

Antwort

Antwortfelder

Fahrzeugsysteme

Häufige DTCs (Diagnose-Fehlercodes)

Fehlerantworten

400 Ungültige Anfrage

422 Nicht verarbeitbare Entität

Integration mit Hardware

DeepDiag-Integration

Webhooks

Bewährte Praktiken