API de evaluacion de danos - Steer Autos Documentation

POST /v1/inspections/damage-assessment

Evaluacion avanzada de danos con IA que combina datos de inspeccion visual con bases de costos de reparacion para entregar severidad precisa y estimaciones de reparacion.

Request

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

Request Body

Field	Type	Required	Description
`vehicle_id`	string	Yes	Identificador del vehiculo
`inspection_id`	string	No	ID de inspeccion visual relacionada
`damages`	array	Yes	Arreglo de danos a evaluar
`damages[].damage_id`	string	Yes	Identificador unico de dano
`damages[].type`	string	Yes	Tipo de dano
`damages[].location`	string	Yes	Parte del vehiculo afectada
`damages[].severity`	string	No	Severidad inicial
`assessment_options.include_repair_timeline`	boolean	No	Incluir tiempos de reparacion (default: true)
`assessment_options.include_part_prices`	boolean	No	Incluir precios OEM/aftermarket (default: true)
`assessment_options.labor_rate_region`	string	No	Region geografica para tarifas
`assessment_options.currency`	string	No	Moneda para precios (default: USD)

Regiones soportadas

Region Code	Description	Avg Labor Rate
`US_CALIFORNIA`	California, USA	$150-200/hr
`US_TEXAS`	Texas, USA	$100-150/hr
`US_NORTHEAST`	Northeast USA	$125-175/hr
`US_MIDWEST`	Midwest USA	$90-140/hr
`EU_GERMANY`	Germany	€80-120/hr
`EU_UK`	United Kingdom	£70-100/hr
`EU_FRANCE`	France	€70-100/hr
`ASIA_JAPAN`	Japan	¥8,000-12,000/hr
`ASIA_CHINA`	China	¥400-800/hr

Response

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

Campos de respuesta

Field	Type	Description
`assessment_id`	string	Identificador unico de evaluacion
`severity_score`	float	Severidad numerica (0-10, 10 = perdida total)
`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	Porcentaje de reduccion del valor
`repair_options[].repair_type`	string	`cosmetic`, `pdr`, `replacement`, `structural`

Puntuacion de severidad

Menor (0-3)

Caracteristicas: • Solo dano de superficie • Sin impacto estructural • Danos cosmeticos • Reparacion facil y barataEjemplos: • Rayones leves • Pequenos chips de pintura • Rozaduras menores

Moderado (3-6)

Caracteristicas: • Dano visible que afecta apariencia • Preocupacion estructural menor • Complejidad de reparacion moderada • Impacto notable en el valorEjemplos: • Abolladuras que requieren PDR • Rayones profundos hasta el primer • Parachoques agrietados • Desalineacion menor de panel

Severo (6-8)

Caracteristicas: • Dano significativo • Integridad estructural afectada • Reparaciones complejas • Reduccion mayor de valorEjemplos: • Secciones de chasis danadas • Reemplazo de multiples paneles • Dano de suspension • Dano mayor por colision

Critico (8-10)

Caracteristicas: • Dano extenso • Sistemas de seguridad comprometidos • Potencial perdida total • Costo de reparacion cercano al valorEjemplos: • Dano severo de chasis • Despliegue de airbag • Dano por inundacion/incendio • Fallas en multiples sistemas

Tipos de reparacion

Type	Description	Typical Cost Range	Timeline
Cosmetic	Reparaciones de superficie, pintura	$100-500	1-2 dias
PDR	Reparacion de abolladuras sin pintura	$200-800	1-2 dias
Panel Repair	Reparacion de paneles y repintado	$500-2000	2-5 dias
Replacement	Reemplazo de piezas	$800-5000+	3-7 dias
Structural	Reparaciones estructurales	$2000-15000+	1-4 semanas

Respuestas de error

400 Bad Request

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

{
  "status": "error",
  "error": {
    "code": "INSPECTION_NOT_FOUND",
    "message": "The specified inspection_id does not exist",
    "type": "not_found_error",
    "field": "inspection_id"
  }
}

Referencia de partes del vehiculo

Paneles exteriores

• 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

Vidrios y luces

• 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

Mecanico

• engine • transmission • suspension_fl • suspension_fr • suspension_rl • suspension_rr • exhaust_system • fuel_system • cooling_system • brake_system

Funcionalidades avanzadas

Optimizacion de costos: Solicita precios OEM y aftermarket para ofrecer opciones a distintos precios. Las piezas aftermarket pueden reducir costos en 30-50%.

Ejemplo de integracion

Combina inspeccion visual con evaluacion de danos:

import requests

# Step 1: Create visual inspection
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"]

# Step 2: Get detected damages
damages = visual_response.json()["data"]["results"]["damages"]

# Step 3: Assess damages with cost estimates
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

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

Precision de estimaciones: Los costos se basan en promedios regionales y bases de partes. Los costos reales pueden variar ±20% segun taller y disponibilidad.

Documentacion de la API

​POST /v1/inspections/damage-assessment

​Request

​Request Body

​Regiones soportadas

​Response

​Campos de respuesta

​Puntuacion de severidad

​Tipos de reparacion

​Respuestas de error

​400 Bad Request

​404 Not Found

​Referencia de partes del vehiculo

Paneles exteriores

Vidrios y luces

Mecanico

​Funcionalidades avanzadas

​Ejemplo de integracion

​Webhooks

POST /v1/inspections/damage-assessment

Request

Request Body

Regiones soportadas

Response

Campos de respuesta

Puntuacion de severidad

Tipos de reparacion

Respuestas de error

400 Bad Request

404 Not Found

Referencia de partes del vehiculo

Funcionalidades avanzadas

Ejemplo de integracion

Webhooks