> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steerai.autos/llms.txt
> Use this file to discover all available pages before exploring further.
# API für mechanische Diagnostik
> OBD-II-Integration und umfassende Analyse der mechanischen Fahrzeuggesundheit
## 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
```bash theme={null}
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
```json theme={null}
{
"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
**Analysierte Komponenten:**
• Motorleistung und Effizienz
• Kraftstoffsystem und Einspritzdüsen
• Ansaugsystem und MAF-Sensor
• Zündanlage und Zündzeitpunkt
• Öldruck und Ölzustand
• Kompression und Zylinderzustand
**Analysierte Komponenten:**
• Schaltverhalten
• Zustand des Getriebeöls
• Kupplungsverschleiß (manuell)
• Drehmomentwandler (automatisch)
• Übersetzungen und Synchronringe
• Elektronische Steuerung
**Analysierte Komponenten:**
• Bremsbelag-/Backenstärke
• Zustand von Scheiben/Trommeln
• Bremsflüssigkeitsstand und -qualität
• ABS-Funktionalität
• Bremsdruck und Reaktion
• Elektronische Stabilitätskontrolle
**Analysierte Komponenten:**
• Batteriespannung und -zustand
• Lichtmaschinenleistung
• Starterfunktion
• Beleuchtungssysteme
• Elektronische Steuergeräte
• Sensor-Diagnostik
**Analysierte Komponenten:**
• Kühlmittelstand und -zustand
• Kühler und Schläuche
• Wasserpumpenbetrieb
• Thermostatfunktion
• Lüfterbetrieb
• Temperaturregelung
**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
```json theme={null}
{
"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
```json theme={null}
{
"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
**Kompatible Geräte**
• Bluetooth-OBD-II-Adapter
• WiFi-OBD-II-Adapter
• USB-OBD-II-Leser
• Professionelle Diagnosegeräte
• Mobile Diagnose-Apps
**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:
```bash theme={null}
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
```json theme={null}
{
"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.
1. **Regelmäßige Diagnostik:** Diagnosen alle 3.000–5.000 Meilen für optimales Monitoring durchführen
2. **Mehrere Datenpunkte:** Daten unter verschiedenen Bedingungen erfassen (Leerlauf, Beschleunigung, Autobahn)
3. **Baseline festlegen:** Basiswerte für gesunde Fahrzeuge definieren
4. **Trend-Analyse:** Veränderungen im Zeitverlauf beobachten, um Ausfälle vorherzusagen
5. **Kombination mit visueller Inspektion:** Mechanische und visuelle Inspektion kombinieren