> ## 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 de diagnostic mécanique
> Intégration OBD-II et analyse complète de l'état mécanique
## POST /v1/inspections/mechanical
Effectuez un diagnostic mécanique complet à partir des données OBD-II, des relevés de capteurs et d'une analyse IA. Détectez les problèmes moteur, de transmission, l'usure des freins, et plus encore.
### Requête
```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"
}
}'
```
### Corps de la requête
| Champ | Type | Requis | Description |
| --------------------------------- | ------- | ------ | ---------------------------------------------------------------------------------- |
| `vehicle_id` | string | Oui | Identifiant du véhicule |
| `obd_data` | object | Oui | Données de diagnostic OBD-II |
| `obd_data.dtcs` | array | Non | Codes défaut (DTC) |
| `obd_data.live_data` | object | Oui | Relevés de capteurs en temps réel |
| `test_results` | object | Non | Résultats d'inspection manuelle |
| `options.include_recommendations` | boolean | Non | Inclure les recommandations de réparation (par défaut : true) |
| `options.severity_threshold` | string | Non | Gravité minimale à signaler : `minor`, `moderate`, `severe` (par défaut : `minor`) |
### Paramètres des données en temps réel
| Paramètre | Unité | Description |
| ------------------- | ----- | ----------------------------------------- |
| `engine_rpm` | RPM | Régime moteur (tours/minute) |
| `coolant_temp` | °C | Température du liquide de refroidissement |
| `intake_temp` | °C | Température d'admission d'air |
| `maf_rate` | g/s | Débit massique d'air (MAF) |
| `throttle_position` | % | Position du papillon (0-100) |
| `fuel_pressure` | kPa | Pression de la rampe d'injection |
| `o2_sensor_voltage` | V | Tension de la sonde O2 |
| `timing_advance` | ° | Avance à l'allumage |
| `vehicle_speed` | km/h | Vitesse du véhicule |
| `engine_load` | % | Charge moteur calculée |
### Réponse
```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"]
}
}
```
### Champs de réponse
| Champ | Type | Description |
| ------------------------ | ------ | ----------------------------------------------- |
| `diagnostic_id` | string | Identifiant unique de diagnostic |
| `results.overall_health` | string | `excellent`, `good`, `fair`, `poor`, `critical` |
| `results.health_score` | float | Score global d'état (0-10) |
| `systems[].system` | string | Nom du système du véhicule |
| `systems[].status` | string | `good`, `needs_attention`, `critical` |
| `issues[].severity` | string | `minor`, `moderate`, `severe`, `critical` |
| `issues[].urgency` | string | `immediate`, `high`, `medium`, `low` |
| `issues[].dtc` | string | Code défaut OBD-II |
### Systèmes du véhicule
**Composants analysés :**
• Performances et rendement du moteur
• Système d'alimentation et injecteurs
• Admission d'air et capteur MAF
• Système d'allumage et calage
• Pression et état de l'huile
• Compression et santé des cylindres
**Composants analysés :**
• Performance des changements de vitesse
• État du fluide de transmission
• Usure de l'embrayage (manuel)
• Convertisseur de couple (automatique)
• Rapports de boîte et synchroniseurs
• Contrôles électroniques
**Composants analysés :**
• Épaisseur des plaquettes/mâchoires
• État des disques/tambours
• Niveau et qualité du liquide de frein
• Fonctionnement ABS
• Pression et réponse de freinage
• Contrôle de stabilité électronique
**Composants analysés :**
• Tension et santé de la batterie
• Sortie de l'alternateur
• Fonctionnement du démarreur
• Systèmes d'éclairage
• Modules de contrôle électroniques
• Diagnostics des capteurs
**Composants analysés :**
• Niveau et état du liquide de refroidissement
• Radiateur et durites
• Fonctionnement de la pompe à eau
• Fonction du thermostat
• Ventilateur de refroidissement
• Régulation de température
**Composants analysés :**
• Efficacité du catalyseur
• Sondes oxygène
• Intégrité du système EVAP
• Fonction de la vanne EGR
• Système PCV
• Conformité aux émissions
### DTC courants (codes défaut)
| Code | Système | Description | Cause typique |
| ----- | --------- | ----------------------------------- | --------------------------- |
| P0420 | Émissions | Efficacité catalyseur sous le seuil | Catalyseur défaillant |
| P0171 | Moteur | Mélange trop pauvre (Bank 1) | Fuite de vide, MAF sale |
| P0300 | Moteur | Ratés aléatoires/multiples | Bougies, bobines, carburant |
| P0401 | Émissions | Débit EGR insuffisant | Vanne EGR encrassée |
| P0456 | Émissions | Petite fuite EVAP détectée | Bouchon mal fermé, fuite |
| P0442 | Émissions | Fuite EVAP moyenne détectée | Durites fissurées, purge |
### Réponses d'erreur
#### 400 Bad Request
```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 Unprocessable Entity
```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
}
}
}
```
### Intégration matérielle
**Appareils compatibles**
• Adaptateurs OBD-II Bluetooth
• Adaptateurs OBD-II WiFi
• Lecteurs OBD-II USB
• Outils de diagnostic professionnels
• Applications de diagnostic mobile
**Protocoles supportés**
• ISO 15765-4 (CAN)
• ISO 14230-4 (KWP2000)
• ISO 9141-2
• SAE J1850 PWM
• SAE J1850 VPW
### Intégration DeepDiag
Pour des diagnostics avancés au-delà d'OBD-II, intégrez **DeepDiag**, notre plateforme de diagnostic complète :
```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
}'
```
**Astuce :** Combinez le diagnostic mécanique avec l'inspection visuelle pour une évaluation complète du véhicule. Regroupez les deux appels API pour des tarifs réduits.
### 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"
}
}
```
### Bonnes pratiques
**Confidentialité des données :** Les données OBD-II peuvent contenir des informations sensibles. Assurez-vous d'avoir l'autorisation nécessaire avant de collecter et transmettre ces données.
1. **Diagnostics réguliers :** Exécutez des diagnostics tous les 3 000 à 5 000 miles pour un suivi optimal
2. **Points de données multiples :** Collectez des données dans diverses conditions (ralenti, accélération, autoroute)
3. **Établir une base de référence :** Créez des valeurs de référence pour les véhicules en bon état
4. **Analyse des tendances :** Surveillez les changements dans le temps pour prédire les pannes
5. **Combiner avec le visuel :** Utilisez diagnostics mécaniques et visuels pour une évaluation complète