> ## 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 d'évaluation des dommages

> Analyse complète de la gravité des dommages et estimation des coûts de réparation

## 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

```bash theme={null}
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

```json theme={null}
{
  "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é

<AccordionGroup>
  <Accordion icon="1" title="Mineur (0-3)">
    **Caractéristiques :**
    • Dommages de surface uniquement
    • Aucun impact structurel
    • Préoccupations esthétiques
    • Réparation simple et peu coûteuse

    **Exemples :**
    • Rayures légères
    • Petits éclats de peinture
    • Éraflures mineures
  </Accordion>

  <Accordion icon="2" title="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 valeur

    **Exemples :**
    • Bosses nécessitant du PDR
    • Rayures profondes jusqu'à l'apprêt
    • Pare-chocs fissurés
    • Désalignement mineur de panneau
  </Accordion>

  <Accordion icon="3" title="Sévère (6-8)">
    **Caractéristiques :**
    • Dommages importants
    • Intégrité structurelle affectée
    • Réparations complexes requises
    • Forte baisse de valeur

    **Exemples :**
    • Sections de châssis endommagées
    • Remplacement de plusieurs panneaux
    • Dommages à la suspension
    • Dommages majeurs de collision
  </Accordion>

  <Accordion icon="4" title="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éhicule

    **Exemples :**
    • Dommages sévères au châssis
    • Déploiement d'airbags
    • Dommages eau/feu
    • Défaillances multiples de systèmes
  </Accordion>
</AccordionGroup>

### 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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

<CardGroup cols={3}>
  <Card title="Panneaux extérieurs" icon="car-side">
    • 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
  </Card>

  <Card title="Vitres et éclairage" icon="lightbulb">
    • 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
  </Card>

  <Card title="Mécanique" icon="gears">
    • engine
    • transmission
    • suspension\_fl
    • suspension\_fr
    • suspension\_rl
    • suspension\_rr
    • exhaust\_system
    • fuel\_system
    • cooling\_system
    • brake\_system
  </Card>
</CardGroup>

### Fonctionnalités avancées

<Tip>
  **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 %.
</Tip>

### Exemple d'intégration

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

```python theme={null}
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

```json theme={null}
{
  "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"
  }
}
```

<Warning>
  **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é.
</Warning>