> ## 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.

# Referencia de API

> Documentacion REST completa para la plataforma de inspeccion y precios de Steer AI

## Bienvenido a la API de Steer AI

La API de Steer AI ofrece acceso programatico a nuestra plataforma de inspeccion vehicular, precios y CRM con IA. Crea integraciones personalizadas, automatiza workflows y desarrolla aplicaciones automotrices potentes.

<CardGroup cols={2}>
  <Card title="Inicio rapido" icon="rocket" href="/es/getting-started/quickstart">
    Obtén tus API keys y haz tu primera solicitud en minutos
  </Card>

  <Card title="Autenticacion" icon="key" href="/es/getting-started/authentication">
    Asegura tus solicitudes con autenticacion adecuada
  </Card>

  <Card title="Guia de integracion" icon="plug" href="/es/integration/api/overview">
    Guia completa de integracion y mejores practicas
  </Card>

  <Card title="Mejores practicas" icon="star" href="/es/guides/best-practices">
    Lineamientos de seguridad, rendimiento y optimizacion
  </Card>
</CardGroup>

## URL base

Todos los endpoints de la API son relativos a la URL base:

**Produccion:** `https://api.steerai.autos/v1`

**Sandbox:** `https://api-sandbox.steerai.autos/v1`

## Autenticacion

Todas las solicitudes requieren autenticacion con tokens Bearer:

```bash theme={null}
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

<Warning>
  **Nota de seguridad:** Nunca expongas tus API keys en codigo del lado del cliente. Usa implementaciones del lado del servidor en produccion.
</Warning>

## Formato de solicitudes y respuestas

### Encabezados de solicitud

Todas las solicitudes deben incluir estos encabezados:

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0
```

### Formato de respuesta

Todas las respuestas siguen esta estructura:

```json theme={null}
{
  "status": "success",
  "data": {
    // Response data here
  },
  "meta": {
    "request_id": "req_1234567890abcdef",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.234,
    "rate_limit": {
      "limit": 1000,
      "remaining": 999,
      "reset": 1640995200
    }
  }
}
```

## Endpoints principales de la API

<CardGroup cols={3}>
  <Card title="Inspeccion de vehiculos" icon="search" href="/es/features/inspection/overview">
    Envia vehiculos para inspeccion con IA y analisis de danos
  </Card>

  <Card title="Precios y valuacion" icon="dollar-sign" href="/es/features/pricing/overview">
    Obten valuaciones en tiempo real y calculos de impacto por danos
  </Card>

  <Card title="Gestion de CRM" icon="users" href="/es/features/crm/overview">
    Gestiona leads, clientes e inventario con nuestras APIs de CRM
  </Card>
</CardGroup>

## Limites de tasa

Los limites de tasa se aplican por API key y varian segun el plan:

| Plan             | Solicitudes/Hora | Concurrentes | Limite de rafaga |
| ---------------- | ---------------- | ------------ | ---------------- |
| **Free**         | 1,000            | 5            | 50               |
| **Starter**      | 10,000           | 20           | 200              |
| **Professional** | 100,000          | 100          | 1,000            |
| **Enterprise**   | Unlimited        | Custom       | Custom           |

## SDKs y librerias

<CardGroup cols={2}>
  <Card title="Python SDK" icon="python">
    ```bash theme={null}
    pip install steer-ai
    ```

    Libreria completa de Python con soporte async
  </Card>

  <Card title="JavaScript SDK" icon="js">
    ```bash theme={null}
    npm install @steerai/sdk
    ```

    SDK listo para TypeScript en Node.js y navegadores
  </Card>
</CardGroup>

## Ejemplos de solicitudes

### Inspeccion vehicular

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "make": "Honda",
      "model": "Civic",
      "year": 2021
    },
    "inspection_type": "full"
  }'
```

### Valuacion de precios

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/pricing/valuate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890",
    "mileage": 50000,
    "condition": "good"
  }'
```

### Creacion de lead en CRM

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "source": "website"
  }'
```

## Manejo de errores

Todas las respuestas siguen un formato de error consistente:

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid VIN format",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890abcdef"
  }
}
```

### Codigos de error comunes

| Code                  | HTTP Status | Descripcion                     |
| --------------------- | ----------- | ------------------------------- |
| `INVALID_API_KEY`     | 401         | La API key es invalida o expiro |
| `RATE_LIMIT_EXCEEDED` | 429         | Demasiadas solicitudes          |
| `VALIDATION_ERROR`    | 400         | Datos de solicitud invalidos    |
| `RESOURCE_NOT_FOUND`  | 404         | Recurso no existe               |
| `INTERNAL_ERROR`      | 500         | Error del servidor, reintenta   |

## Webhooks

Configura webhooks para recibir actualizaciones en tiempo real:

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/steerai",
    "events": ["inspection.completed", "pricing.calculated"]
  }'
```

## Soporte

* **Soporte tecnico:** [support@steerai.autos](mailto:support@steerai.autos)
* **Estado de API:** [status.steerai.autos](https://status.steerai.autos)
* **Registro de cambios:** Revisa nuestro [registro de cambios](/es/support/changelog) para actualizaciones de API