API de diagnostico mecanico - Steer Autos Documentation

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

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

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

Sistema de motor

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

Sistema de transmision

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

Sistema de frenos

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

Sistema electrico

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

Sistema de enfriamiento

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

Sistema de emisiones

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

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

Integracion con hardware

Adaptadores OBD-II

Dispositivos compatibles• Adaptadores OBD-II Bluetooth • Adaptadores OBD-II WiFi • Lectores OBD-II USB • Escaners profesionales • Apps de diagnostico mobile

Protocolos de datos

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:

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

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

Diagnosticos regulares: Corre diagnosticos cada 3,000-5,000 millas para monitoreo optimo
Multiples puntos de datos: Recolecta datos en varias condiciones (ralenti, aceleracion, carretera)
Linea base: Establece lecturas base para vehiculos sanos
Analisis de tendencias: Monitorea cambios para predecir fallas
Combina con visual: Usa inspeccion visual y mecanica para evaluacion completa

Documentacion de la API

​POST /v1/inspections/mechanical

​Request

​Request Body

​Parametros de datos en vivo

​Response

​Campos de respuesta

​Sistemas del vehiculo

​DTCs comunes (codigos de falla)

​Respuestas de error

​400 Bad Request

​422 Unprocessable Entity

​Integracion con hardware

Adaptadores OBD-II

Protocolos de datos

​Integracion DeepDiag

​Webhooks

​Mejores practicas

POST /v1/inspections/mechanical

Request

Request Body

Parametros de datos en vivo

Response

Campos de respuesta

Sistemas del vehiculo

DTCs comunes (codigos de falla)

Respuestas de error

400 Bad Request

422 Unprocessable Entity

Integracion con hardware

Integracion DeepDiag

Webhooks

Mejores practicas