> ## 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 diagnostico mecanico
> Integracion OBD-II y analisis completo de salud mecanica
## POST /v1/inspections/mechanical
Realiza diagnosticos mecanicos completos con datos OBD-II, lecturas de sensores y analisis con IA. Detecta problemas de motor, transmision, desgaste de frenos y mas.
### Request
```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"
}
}'
```
### Request Body
| Field | Type | Required | Description |
| --------------------------------- | ------- | -------- | ------------------------------------------------------------------ |
| `vehicle_id` | string | Yes | Identificador del vehiculo |
| `obd_data` | object | Yes | Datos de diagnostico OBD-II |
| `obd_data.dtcs` | array | No | Codigos de falla (DTCs) |
| `obd_data.live_data` | object | Yes | Lecturas de sensores en tiempo real |
| `test_results` | object | No | Resultados de inspeccion manual |
| `options.include_recommendations` | boolean | No | Incluir recomendaciones (default: true) |
| `options.severity_threshold` | string | No | Severidad minima: `minor`, `moderate`, `severe` (default: `minor`) |
### Parametros de datos en vivo
| Parameter | Unit | Description |
| ------------------- | ---- | ------------------------------- |
| `engine_rpm` | RPM | Revoluciones por minuto |
| `coolant_temp` | °C | Temperatura de refrigerante |
| `intake_temp` | °C | Temperatura de admision |
| `maf_rate` | g/s | Flujo de aire masico |
| `throttle_position` | % | Posicion del acelerador (0-100) |
| `fuel_pressure` | kPa | Presion del riel de combustible |
| `o2_sensor_voltage` | V | Voltaje del sensor O2 |
| `timing_advance` | ° | Avance de encendido |
| `vehicle_speed` | km/h | Velocidad del vehiculo |
| `engine_load` | % | Carga calculada del motor |
### Response
```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"]
}
}
```
### Campos de respuesta
| Field | Type | Description |
| ------------------------ | ------ | ----------------------------------------------- |
| `diagnostic_id` | string | Identificador unico de diagnostico |
| `results.overall_health` | string | `excellent`, `good`, `fair`, `poor`, `critical` |
| `results.health_score` | float | Puntaje de salud (0-10) |
| `systems[].system` | string | Nombre del sistema |
| `systems[].status` | string | `good`, `needs_attention`, `critical` |
| `issues[].severity` | string | `minor`, `moderate`, `severe`, `critical` |
| `issues[].urgency` | string | `immediate`, `high`, `medium`, `low` |
| `issues[].dtc` | string | Codigo de falla OBD-II |
### Sistemas del vehiculo
**Componentes analizados:**
• Rendimiento y eficiencia del motor
• Sistema de combustible e inyectores
• Admision de aire y sensor MAF
• Sistema de encendido y timing
• Presion y condicion de aceite
• Compresion y salud de cilindros
**Componentes analizados:**
• Rendimiento de cambios
• Condicion de fluido de transmision
• Desgaste de clutch (manual)
• Convertidor de torque (automatico)
• Relacion de cambios y sincronizadores
• Controles electronicos
**Componentes analizados:**
• Espesor de pastillas/zapatas
• Condicion de discos/tambores
• Nivel y calidad del liquido de frenos
• Funcionamiento de ABS
• Presion y respuesta de frenado
• Control de estabilidad
**Componentes analizados:**
• Voltaje y salud de bateria
• Salida del alternador
• Funcion del motor de arranque
• Sistemas de iluminacion
• Modulos de control electronico
• Diagnostico de sensores
**Componentes analizados:**
• Nivel y condicion de refrigerante
• Radiador y mangueras
• Funcion de la bomba de agua
• Funcion del termostato
• Operacion del ventilador
• Regulacion de temperatura
**Componentes analizados:**
• Eficiencia del catalizador
• Sensores de oxigeno
• Integridad del sistema EVAP
• Funcion de la valvula EGR
• Sistema PCV
• Cumplimiento de emisiones
### DTCs comunes (codigos de falla)
| Code | System | Description | Typical Cause |
| ----- | --------- | ----------------------------------- | -------------------------- |
| P0420 | Emissions | Catalyst efficiency below threshold | Failed catalytic converter |
| P0171 | Engine | System too lean (Bank 1) | Vacuum leak, dirty MAF |
| P0300 | Engine | Random/multiple cylinder misfire | Spark plugs, coils, fuel |
| P0401 | Emissions | EGR flow insufficient | Clogged EGR valve |
| P0456 | Emissions | EVAP small leak detected | Loose gas cap, leak |
| P0442 | Emissions | EVAP medium leak detected | Cracked hoses, purge valve |
### Respuestas de error
#### 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
}
}
}
```
### Integracion con hardware
**Dispositivos compatibles**
• Adaptadores OBD-II Bluetooth
• Adaptadores OBD-II WiFi
• Lectores OBD-II USB
• Escaners profesionales
• Apps de diagnostico mobile
**Protocolos soportados**
• ISO 15765-4 (CAN)
• ISO 14230-4 (KWP2000)
• ISO 9141-2
• SAE J1850 PWM
• SAE J1850 VPW
### Integracion DeepDiag
Para diagnosticos avanzados mas alla de OBD-II, integra con **DeepDiag**, nuestra plataforma de diagnostico:
```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
}'
```
**Tip Pro:** Combina diagnostico mecanico con inspeccion visual para una evaluacion completa. Agrupa ambas llamadas para precios con descuento.
### 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"
}
}
```
### Mejores practicas
**Privacidad de datos:** Los datos OBD-II pueden contener informacion sensible del vehiculo. Asegura contar con autorizacion antes de recopilar y enviar datos de diagnostico.
1. **Diagnosticos regulares:** Corre diagnosticos cada 3,000-5,000 millas para monitoreo optimo
2. **Multiples puntos de datos:** Recolecta datos en varias condiciones (ralenti, aceleracion, carretera)
3. **Linea base:** Establece lecturas base para vehiculos sanos
4. **Analisis de tendencias:** Monitorea cambios para predecir fallas
5. **Combina con visual:** Usa inspeccion visual y mecanica para evaluacion completa