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

# Resumen de integracion de API

> APIs REST flexibles para soluciones personalizadas de inspeccion y precios automotrices

## Por que elegir la integracion de API

Ideal para desarrolladores y empresas que necesitan maxima flexibilidad e integraciones personalizadas. Comienza en 48 horas sin costos de configuracion.

<CardGroup cols={2}>
  <Card title="Beneficios clave" icon="check-circle">
    • **Sin costo de configuracion** - Empieza a crear de inmediato
    • **Implementacion en 48 horas** - La integracion de API mas rapida
    • **APIs REST** - Endpoints estandar y predecibles
    • **Maxima flexibilidad** - Crea exactamente lo que necesitas
    • **Precios escalables** - Paga solo por lo que usas
  </Card>

  <Card title="Ideal para" icon="star">
    • Equipos de desarrollo con experiencia en API
    • Integraciones de aplicaciones personalizadas
    • Procesamiento de inspecciones de alto volumen
    • Requisitos de workflow unicos
    • Mejora de aplicaciones existentes
  </Card>
</CardGroup>

## Capacidades principales de la API

### APIs de inspeccion de vehiculos

* **Inspeccion mecanica:** Analisis de diagnostico impulsado por IA
* **Inspeccion visual:** Deteccion y evaluacion de danos 360°
* **Procesamiento de imagenes:** Vision por computadora avanzada para identificar danos
* **Reportes de inspeccion:** Reportes completos en PDF y JSON

### APIs de precios y valuacion

* **Valuacion de mercado:** Analisis de precios en tiempo real
* **Evaluacion de danos:** Calculo del impacto en el valor del vehiculo
* **Estimacion de reparacion:** Predicciones precisas de costos de reparacion
* **Precios regionales:** Ajustes de precios por ubicacion

### APIs de integracion empresarial

* **Gestion de leads:** Capacidades de integracion con CRM
* **Sincronizacion de inventario:** Gestion de inventario en tiempo real
* **Generacion de contratos:** Creacion automatizada de documentos
* **Integracion de marketing:** Herramientas de marketing multiplataforma

## Inicio rapido

### 1. Obtén tus claves de API

```bash theme={null}
# Sign up and get your API keys
curl -X POST "https://api.steerai.autos/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@company.com",
    "company": "Your Company Name"
  }'
```

### 2. Realiza tu primera llamada a la API

```bash theme={null}
# Test your authentication
curl -X GET "https://api.steerai.autos/v1/auth/test" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 3. Crea tu primera inspeccion

```bash theme={null}
# Submit vehicle images for inspection
curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "year": 2021,
      "make": "Honda",
      "model": "Civic"
    },
    "images": [
      "https://your-storage.com/image1.jpg",
      "https://your-storage.com/image2.jpg"
    ]
  }'
```

## Arquitectura de la API

### URLs base

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

### Autenticacion

Todas las solicitudes requieren autenticacion con token Bearer en el encabezado Authorization.

### Formato de respuesta

Todos los endpoints devuelven JSON con una estructura consistente:

```json theme={null}
{
  "status": "success|error",
  "data": { ... },
  "meta": {
    "request_id": "req_1234567890",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.23
  }
}
```

## Limites de tasa

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

### Encabezados de limite de tasa

```http theme={null}
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-Retry-After: 60
```

## Soporte de SDK

<CardGroup cols={2}>
  <Card title="SDK de Python" icon="python" href="/es/sdks/python">
    ```python theme={null}
    pip install steer-ai
    ```

    SDK de Python completo con soporte async
  </Card>

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

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

## Integraciones de ejemplo

### Flujo basico de inspeccion

```python theme={null}
from steer_ai import SteerAI

# Initialize client
client = SteerAI(api_key="YOUR_API_KEY")

# Create inspection
inspection = client.inspections.create({
    "vehicle": {
        "vin": "1HGBH41JXMN109186",
        "year": 2021,
        "make": "Honda",
        "model": "Civic"
    },
    "images": ["image1.jpg", "image2.jpg"]
})

# Get results
result = client.inspections.get(inspection.id)
print(f"Inspection complete: {result.status}")
print(f"Damage detected: {result.damages}")
```

### Integracion con webhooks

```python theme={null}
from flask import Flask, request
import hmac
import hashlib

app = Flask(__name__)

@app.route('/webhooks/steerai', methods=['POST'])
def handle_webhook():
    # Verify webhook signature
    signature = request.headers.get('X-SteerAI-Signature')
    body = request.get_data()

    if verify_signature(body, signature):
        event = request.json

        if event['type'] == 'inspection.completed':
            # Handle completed inspection
            process_inspection_result(event['data'])

    return '', 200
```

## Manejo de errores

### Codigos de error comunes

| Codigo | Descripcion  | Resolucion                                            |
| ------ | ------------ | ----------------------------------------------------- |
| `400`  | Bad Request  | Revisa el formato de la solicitud y campos requeridos |
| `401`  | Unauthorized | Verifica la API key y permisos                        |
| `403`  | Forbidden    | Revisa limites del plan y acceso a endpoints          |
| `404`  | Not Found    | Verifica el ID del recurso y la URL del endpoint      |
| `429`  | Rate Limited | Implementa backoff exponencial                        |
| `500`  | Server Error | Reintenta la solicitud o contacta soporte             |

### Formato de respuesta de error

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "INVALID_VIN",
    "message": "The provided VIN is invalid",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890"
  }
}
```

## Buenas practicas

<AccordionGroup>
  <Accordion icon="shield" title="Seguridad">
    • Nunca expongas API keys en codigo del lado del cliente
    • Usa variables de entorno para las API keys
    • Implementa validacion adecuada de certificados SSL
    • Rota las API keys regularmente (cada 90 dias)
    • Usa listas blancas de IP cuando sea posible
  </Accordion>

  <Accordion icon="zap" title="Rendimiento">
    • Implementa caching para solicitudes repetidas
    • Usa endpoints por lotes para multiples operaciones
    • Maneja limites de tasa con backoff exponencial
    • Optimiza los tamanos de imagen antes de subirlos
    • Usa compresion para payloads grandes
  </Accordion>

  <Accordion icon="bug" title="Manejo de errores">
    • Siempre verifica los codigos de estado de respuesta
    • Implementa reintentos para fallas temporales
    • Registra detalles de errores para depuracion
    • Maneja timeouts de red de forma adecuada
    • Muestra mensajes de error claros a los usuarios
  </Accordion>

  <Accordion icon="chart-line" title="Monitoreo">
    • Monitorea uso de API y metricas de rendimiento
    • Supervisa tasas de error y tiempos de respuesta
    • Configura alertas para fallas criticas
    • Usa IDs de solicitud para tickets de soporte
    • Implementa health checks para tu integracion
  </Accordion>
</AccordionGroup>

## Aplicaciones de ejemplo

<CardGroup cols={2}>
  <Card title="App de inspeccion de vehiculos" icon="mobile">
    App movil completa para inspecciones en campo

    [Ver en GitHub →](https://github.com/steerautos/mobile-inspector)
  </Card>

  <Card title="Integracion para concesionarios" icon="building">
    Integracion completa con sistema de gestion de concesionarios

    [Ver en GitHub →](https://github.com/steerautos/dealership-demo)
  </Card>
</CardGroup>

## Siguientes pasos

<CardGroup cols={3}>
  <Card title="Configuracion de autenticacion" icon="key" href="/es/integration/api/authentication">
    Configura API keys y seguridad
  </Card>

  <Card title="Limites de tasa" icon="gauge" href="/es/integration/api/rate-limits">
    Comprende limites de uso y optimizacion
  </Card>

  <Card title="Manejo de errores" icon="triangle-exclamation" href="/es/integration/api/error-handling">
    Implementa manejo de errores robusto
  </Card>
</CardGroup>

## Soporte

Necesitas ayuda con tu integracion de API?

* **Documentacion:** Referencia completa de API con ejemplos
* **SDKs:** Librerias oficiales para Python y JavaScript
* **Codigo de ejemplo:** Ejemplos reales de integracion
* **Soporte tecnico:** [support@steerai.autos](mailto:support@steerai.autos)
* **Comunidad:** [Comunidad de Discord](https://discord.gg/steerai)

<Tip>
  **Tip Pro:** Empieza con el entorno sandbox para probar tu integracion antes de ir a produccion. La mayoria de los desarrolladores completan su primera integracion en menos de 4 horas.
</Tip>