API de diagnostic mécanique - Steer Autos Documentation

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

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

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

Système moteur

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

Système de transmission

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

Système de freinage

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

Système électrique

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

Système de refroidissement

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

Système d'émissions

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

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

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

Adaptateurs OBD-II

Appareils compatibles• Adaptateurs OBD-II Bluetooth • Adaptateurs OBD-II WiFi • Lecteurs OBD-II USB • Outils de diagnostic professionnels • Applications de diagnostic mobile

Protocoles de données

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 :

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

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

Diagnostics réguliers : Exécutez des diagnostics tous les 3 000 à 5 000 miles pour un suivi optimal
Points de données multiples : Collectez des données dans diverses conditions (ralenti, accélération, autoroute)
Établir une base de référence : Créez des valeurs de référence pour les véhicules en bon état
Analyse des tendances : Surveillez les changements dans le temps pour prédire les pannes
Combiner avec le visuel : Utilisez diagnostics mécaniques et visuels pour une évaluation complète

Documentation API

​POST /v1/inspections/mechanical

​Requête

​Corps de la requête

​Paramètres des données en temps réel

​Réponse

​Champs de réponse

​Systèmes du véhicule

​DTC courants (codes défaut)

​Réponses d’erreur

​400 Bad Request

​422 Unprocessable Entity

​Intégration matérielle

Adaptateurs OBD-II

Protocoles de données

​Intégration DeepDiag

​Webhooks

​Bonnes pratiques

POST /v1/inspections/mechanical

Requête

Corps de la requête

Paramètres des données en temps réel

Réponse

Champs de réponse

Systèmes du véhicule

DTC courants (codes défaut)

Réponses d’erreur

400 Bad Request

422 Unprocessable Entity

Intégration matérielle

Intégration DeepDiag

Webhooks

Bonnes pratiques