API für Schadensbewertung - Steer Autos Documentation

POST /v1/inspections/damage-assessment

Fortschrittliche KI-gestützte Schadensbewertung, die visuelle Inspektionsdaten mit Reparaturkosten-Datenbanken kombiniert, um genaue Schadensschweregrade und Reparaturschätzungen zu liefern.

Anfrage

curl -X POST "https://api.steerai.autos/v1/inspections/damage-assessment" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor"
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate"
      }
    ],
    "assessment_options": {
      "include_repair_timeline": true,
      "include_part_prices": true,
      "labor_rate_region": "US_CALIFORNIA",
      "currency": "USD"
    }
  }'

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`vehicle_id`	string	Ja	Fahrzeugkennung
`inspection_id`	string	Nein	Zugehörige visuelle Inspektions-ID
`damages`	array	Ja	Array der zu bewertenden Schäden
`damages[].damage_id`	string	Ja	Eindeutige Schadenskennung
`damages[].type`	string	Ja	Schadensart
`damages[].location`	string	Ja	Betroffenes Fahrzeugteil
`damages[].severity`	string	Nein	Erste Schweregrad-Schätzung
`assessment_options.include_repair_timeline`	boolean	Nein	Reparatur-Zeitabschätzungen einschließen (Standard: true)
`assessment_options.include_part_prices`	boolean	Nein	OEM-/Aftermarket-Teilepreise einschließen (Standard: true)
`assessment_options.labor_rate_region`	string	Nein	Region für Arbeitslöhne
`assessment_options.currency`	string	Nein	Währung für Preise (Standard: USD)

Unterstützte Regionen

Regionscode	Beschreibung	Ø Arbeitslohn
`US_CALIFORNIA`	Kalifornien, USA	$150-200/Std.
`US_TEXAS`	Texas, USA	$100-150/Std.
`US_NORTHEAST`	Nordosten USA	$125-175/Std.
`US_MIDWEST`	Mittlerer Westen USA	$90-140/Std.
`EU_GERMANY`	Deutschland	€80-120/Std.
`EU_UK`	Vereinigtes Königreich	£70-100/Std.
`EU_FRANCE`	Frankreich	€70-100/Std.
`ASIA_JAPAN`	Japan	¥8.000-12.000/Std.
`ASIA_CHINA`	China	¥400-800/Std.

Antwort

{
  "status": "success",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "created_at": "2024-01-15T12:00:00Z",
    "assessed_damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor",
        "severity_score": 2.5,
        "impact_assessment": {
          "structural": "none",
          "cosmetic": "minor",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 1.2
        },
        "repair_options": [
          {
            "option": "paint_touch_up",
            "description": "Professional paint touch-up and blending",
            "recommended": true,
            "repair_type": "cosmetic",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 75,
                "aftermarket_price": 50,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 1.5,
              "rate_per_hour": 150,
              "total": 225,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 75,
              "labor": 225,
              "total": 300,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "Same-day repair possible"
            }
          },
          {
            "option": "bumper_replacement",
            "description": "Complete bumper replacement and paint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "front_bumper_cover",
                "part_number": "52119-12345",
                "type": "body_part",
                "oem_price": 450,
                "aftermarket_price": 250,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 200,
                "aftermarket_price": 150,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 4.0,
              "rate_per_hour": 150,
              "total": 600,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 650,
              "labor": 600,
              "total": 1250,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 3,
              "description": "Includes paint curing time"
            }
          }
        ],
        "recommended_repair": {
          "option": "paint_touch_up",
          "min_cost": 250,
          "max_cost": 350,
          "estimated_cost": 300,
          "currency": "USD"
        }
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate",
        "severity_score": 5.8,
        "impact_assessment": {
          "structural": "minor",
          "cosmetic": "moderate",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 3.5
        },
        "repair_options": [
          {
            "option": "pdr_and_paint",
            "description": "Paintless dent removal with touch-up",
            "recommended": true,
            "repair_type": "pdr",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 150,
                "aftermarket_price": 100,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 3.5,
              "rate_per_hour": 150,
              "total": 525,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 150,
              "labor": 525,
              "total": 675,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "1-day repair typical"
            }
          },
          {
            "option": "panel_replacement",
            "description": "Replace door panel and repaint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "rear_door_shell",
                "part_number": "67003-98765",
                "type": "body_part",
                "oem_price": 850,
                "aftermarket_price": 500,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 250,
                "aftermarket_price": 175,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 6.5,
              "rate_per_hour": 150,
              "total": 975,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 1100,
              "labor": 975,
              "total": 2075,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 5,
              "description": "Includes panel fitting and paint"
            }
          }
        ],
        "recommended_repair": {
          "option": "pdr_and_paint",
          "min_cost": 600,
          "max_cost": 800,
          "estimated_cost": 675,
          "currency": "USD"
        }
      }
    ],
    "summary": {
      "total_damages_assessed": 2,
      "overall_severity": "moderate",
      "overall_severity_score": 4.15,
      "total_value_reduction_percentage": 4.7,
      "repair_cost_summary": {
        "recommended_repairs_total": {
          "min": 850,
          "max": 1150,
          "estimated": 975,
          "currency": "USD"
        },
        "all_repairs_range": {
          "min": 850,
          "max": 3325,
          "currency": "USD"
        }
      },
      "repair_timeline": {
        "estimated_total_days": 2,
        "can_repair_simultaneously": true
      },
      "impact_on_vehicle_value": {
        "estimated_market_value": 25000,
        "value_reduction": 1175,
        "adjusted_value": 23825,
        "currency": "USD"
      }
    },
    "reports": {
      "pdf_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf",
      "json_url": "https://api.steerai.autos/v1/inspections/damage-assessment/asmt_1234567890abcdef/report"
    }
  },
  "meta": {
    "request_id": "req_asmt_xyz123",
    "processing_time": 2.456,
    "labor_rate_used": 150,
    "currency": "USD",
    "region": "US_CALIFORNIA"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`assessment_id`	string	Eindeutige Bewertungskennung
`severity_score`	float	Numerische Schwere (0-10, 10 = Totalschaden)
`impact_assessment.structural`	string	`none`, `minor`, `moderate`, `severe`, `critical`
`impact_assessment.cosmetic`	string	`none`, `minor`, `moderate`, `severe`
`impact_assessment.safety`	string	`none`, `minor`, `moderate`, `severe`, `critical`
`value_reduction_percentage`	float	Prozentuale Wertminderung des Fahrzeugs
`repair_options[].repair_type`	string	`cosmetic`, `pdr`, `replacement`, `structural`

Schweregradbewertung

Gering (0-3)

Merkmale: • Nur oberflächliche Schäden • Keine strukturellen Auswirkungen • Kosmetische Probleme • Einfache und kostengünstige ReparaturBeispiele: • Leichte Kratzer • Kleine Lackabplatzer • Geringe Schrammen

Mittel (3-6)

Merkmale: • Sichtbare Schäden, die das Erscheinungsbild beeinträchtigen • Geringe strukturelle Bedenken • Mittlere Reparaturkomplexität • Spürbare WertminderungBeispiele: • Dellen, die PDR erfordern • Tiefe Kratzer bis zur Grundierung • Gerissene Stoßfänger • Geringe Fehlstellung von Karosserieteilen

Schwer (6-8)

Merkmale: • Erhebliche Schäden • Strukturintegrität betroffen • Komplexe Reparaturen erforderlich • Hohe WertminderungBeispiele: • Beschädigte Rahmenteile • Mehrere Karosserieteile müssen ersetzt werden • Fahrwerksschäden • Schwere Unfallschäden

Kritisch (8-10)

Merkmale: • Umfangreiche Schäden • Sicherheitssysteme beeinträchtigt • Möglicher Totalschaden • Reparaturkosten nähern sich dem FahrzeugwertBeispiele: • Schwere Rahmenschäden • Airbag-Auslösung • Wasser-/Brandschäden • Mehrere Systemausfälle

Reparaturtypen

Typ	Beschreibung	Typischer Kostenbereich	Zeitrahmen
Kosmetisch	Oberflächliche Reparaturen, Lackarbeiten	$100-500	1-2 Tage
PDR	Lackfreie Dellenentfernung	$200-800	1-2 Tage
Panel-Reparatur	Reparatur und Aufbereitung von Karosserieteilen	$500-2000	2-5 Tage
Austausch	Teileaustausch	$800-5000+	3-7 Tage
Strukturell	Rahmen-/Strukturreparaturen	$2000-15000+	1-4 Wochen

Fehlerantworten

400 Bad Request

{
  "status": "error",
  "error": {
    "code": "INVALID_DAMAGE_DATA",
    "message": "Damage location 'invalid_part' is not recognized",
    "type": "validation_error",
    "field": "damages[0].location"
  }
}

404 Not Found

{
  "status": "error",
  "error": {
    "code": "INSPECTION_NOT_FOUND",
    "message": "The specified inspection_id does not exist",
    "type": "not_found_error",
    "field": "inspection_id"
  }
}

Referenz der Fahrzeugteile

Außenkarosserie

• front_bumper • rear_bumper • hood • roof • trunk_lid • front_fender_left • front_fender_right • front_door_left • front_door_right • rear_door_left • rear_door_right • quarter_panel_left • quarter_panel_right

Glas & Beleuchtung

• windshield • rear_window • side_window_fl • side_window_fr • side_window_rl • side_window_rr • headlight_left • headlight_right • taillight_left • taillight_right • fog_light_left • fog_light_right

Mechanik

• engine • transmission • suspension_fl • suspension_fr • suspension_rl • suspension_rr • exhaust_system • fuel_system • cooling_system • brake_system

Erweiterte Funktionen

Kostenoptimierung: Fordern Sie sowohl OEM- als auch Aftermarket-Teilepreise an, um Reparaturoptionen in unterschiedlichen Preisklassen anzubieten. Aftermarket-Teile können die Kosten um 30-50% senken.

Integrationsbeispiel

Kombinieren Sie visuelle Inspektion mit der Schadensbewertung:

import requests

# Step 1: Create visual inspection
visual_response = requests.post(
    "https://api.steerai.autos/v1/inspections/visual",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "images": [...]
    }
)
visual_id = visual_response.json()["data"]["inspection_id"]

# Step 2: Get detected damages
damages = visual_response.json()["data"]["results"]["damages"]

# Step 3: Assess damages with cost estimates
assessment_response = requests.post(
    "https://api.steerai.autos/v1/inspections/damage-assessment",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "inspection_id": visual_id,
        "damages": damages,
        "assessment_options": {
            "include_part_prices": True,
            "labor_rate_region": "US_CALIFORNIA"
        }
    }
)

print(f"Total repair cost: ${assessment_response.json()['data']['summary']['repair_cost_summary']['recommended_repairs_total']['estimated']}")

Webhooks

{
  "event": "damage_assessment.completed",
  "timestamp": "2024-01-15T12:00:05Z",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "damages_assessed": 2,
    "overall_severity": "moderate",
    "estimated_repair_cost": 975,
    "value_reduction_percentage": 4.7,
    "report_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf"
  }
}

Schätzgenauigkeit: Reparaturkostenschätzungen basieren auf regionalen Durchschnittswerten und Teile-Datenbanken. Die tatsächlichen Kosten können je nach Werkstattsatz und Teileverfügbarkeit um ±20% variieren.

API-Dokumentation

​POST /v1/inspections/damage-assessment

​Anfrage

​Anfrage-Body

​Unterstützte Regionen

​Antwort

​Antwortfelder

​Schweregradbewertung

​Reparaturtypen

​Fehlerantworten

​400 Bad Request

​404 Not Found

​Referenz der Fahrzeugteile

Außenkarosserie

Glas & Beleuchtung

Mechanik

​Erweiterte Funktionen

​Integrationsbeispiel

​Webhooks

POST /v1/inspections/damage-assessment

Anfrage

Anfrage-Body

Unterstützte Regionen

Antwort

Antwortfelder

Schweregradbewertung

Reparaturtypen

Fehlerantworten

400 Bad Request

404 Not Found

Referenz der Fahrzeugteile

Erweiterte Funktionen

Integrationsbeispiel

Webhooks