API d'évaluation des dommages - Steer Autos Documentation

POST /v1/inspections/damage-assessment

Évaluation avancée des dommages pilotée par l’IA qui combine les données d’inspection visuelle avec des bases de coûts de réparation pour fournir des notes de gravité et des estimations précises.

Requête

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"
    }
  }'

Corps de la requête

Champ	Type	Requis	Description
`vehicle_id`	string	Oui	Identifiant du véhicule
`inspection_id`	string	Non	ID d’inspection visuelle associée
`damages`	array	Oui	Tableau d’objets de dommages à évaluer
`damages[].damage_id`	string	Oui	Identifiant unique du dommage
`damages[].type`	string	Oui	Type de dommage
`damages[].location`	string	Oui	Élément du véhicule affecté
`damages[].severity`	string	Non	Gravité initiale estimée
`assessment_options.include_repair_timeline`	boolean	Non	Inclure les délais de réparation (par défaut : true)
`assessment_options.include_part_prices`	boolean	Non	Inclure le prix OEM/aftermarket (par défaut : true)
`assessment_options.labor_rate_region`	string	Non	Région géographique pour taux de main-d’œuvre
`assessment_options.currency`	string	Non	Devise (par défaut : USD)

Régions supportées

Code région	Description	Taux moyen
`US_CALIFORNIA`	Californie, USA	$150-200/hr
`US_TEXAS`	Texas, USA	$100-150/hr
`US_NORTHEAST`	Nord-Est USA	$125-175/hr
`US_MIDWEST`	Midwest USA	$90-140/hr
`EU_GERMANY`	Allemagne	€80-120/hr
`EU_UK`	Royaume-Uni	£70-100/hr
`EU_FRANCE`	France	€70-100/hr
`ASIA_JAPAN`	Japon	¥8,000-12,000/hr
`ASIA_CHINA`	Chine	¥400-800/hr

Réponse

{
  "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"
  }
}

Champs de réponse

Champ	Type	Description
`assessment_id`	string	Identifiant unique d’évaluation
`severity_score`	float	Gravité numérique (0-10, 10 = perte totale)
`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	Pourcentage de réduction de valeur
`repair_options[].repair_type`	string	`cosmetic`, `pdr`, `replacement`, `structural`

Barème de gravité

Mineur (0-3)

Caractéristiques : • Dommages de surface uniquement • Aucun impact structurel • Préoccupations esthétiques • Réparation simple et peu coûteuseExemples : • Rayures légères • Petits éclats de peinture • Éraflures mineures

Modéré (3-6)

Caractéristiques : • Dommages visibles affectant l’apparence • Préoccupation structurelle mineure • Complexité de réparation modérée • Impact notable sur la valeurExemples : • Bosses nécessitant du PDR • Rayures profondes jusqu’à l’apprêt • Pare-chocs fissurés • Désalignement mineur de panneau

Sévère (6-8)

Caractéristiques : • Dommages importants • Intégrité structurelle affectée • Réparations complexes requises • Forte baisse de valeurExemples : • Sections de châssis endommagées • Remplacement de plusieurs panneaux • Dommages à la suspension • Dommages majeurs de collision

Critique (8-10)

Caractéristiques : • Dommages étendus • Systèmes de sécurité compromis • Perte totale potentielle • Coût de réparation proche de la valeur du véhiculeExemples : • Dommages sévères au châssis • Déploiement d’airbags • Dommages eau/feu • Défaillances multiples de systèmes

Types de réparation

Type	Description	Plage de coût typique	Délai
Cosmetic	Réparations de surface, peinture	$100-500	1-2 jours
PDR	Débosselage sans peinture	$200-800	1-2 jours
Panel Repair	Réparation et finition de panneaux	$500-2000	2-5 jours
Replacement	Remplacement de pièces	$800-5000+	3-7 jours
Structural	Réparations de châssis/structure	$2000-15000+	1-4 semaines

Réponses d’erreur

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"
  }
}

Référence des pièces véhicule

Panneaux extérieurs

• 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

Vitres et éclairage

• 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

Mécanique

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

Fonctionnalités avancées

Optimisation des coûts : Demandez les prix OEM et aftermarket pour proposer des options de réparation à différents niveaux. Les pièces aftermarket peuvent réduire les coûts de 30 à 50 %.

Exemple d’intégration

Combinez l’inspection visuelle avec l’évaluation des dommages :

import requests

# Étape 1 : Créer une inspection visuelle
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"]

# Étape 2 : Récupérer les dommages détectés
damages = visual_response.json()["data"]["results"]["damages"]

# Étape 3 : Évaluer les dommages avec estimations
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"
  }
}

Précision des estimations : Les coûts sont basés sur des moyennes régionales et des bases de pièces. Les coûts réels peuvent varier de ±20 % selon les tarifs et la disponibilité.

Documentation API

​POST /v1/inspections/damage-assessment

​Requête

​Corps de la requête

​Régions supportées

​Réponse

​Champs de réponse

​Barème de gravité

​Types de réparation

​Réponses d’erreur

​400 Bad Request

​404 Not Found

​Référence des pièces véhicule

Panneaux extérieurs

Vitres et éclairage

Mécanique

​Fonctionnalités avancées

​Exemple d’intégration

​Webhooks

POST /v1/inspections/damage-assessment

Requête

Corps de la requête

Régions supportées

Réponse

Champs de réponse

Barème de gravité

Types de réparation

Réponses d’erreur

400 Bad Request

404 Not Found

Référence des pièces véhicule

Fonctionnalités avancées

Exemple d’intégration

Webhooks