Saltar al contenido principal

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.

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:
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Nota de seguridad: Nunca expongas tus API keys en codigo del lado del cliente. Usa implementaciones del lado del servidor en produccion.

Formato de solicitudes y respuestas

Encabezados de solicitud

Todas las solicitudes deben incluir estos encabezados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0

Formato de respuesta

Todas las respuestas siguen esta estructura:
{
  "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

Limites de tasa

Los limites de tasa se aplican por API key y varian segun el plan:
PlanSolicitudes/HoraConcurrentesLimite de rafaga
Free1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseUnlimitedCustomCustom

SDKs y librerias

Python SDK

pip install steer-ai
Libreria completa de Python con soporte async

JavaScript SDK

npm install @steerai/sdk
SDK listo para TypeScript en Node.js y navegadores

Ejemplos de solicitudes

Inspeccion vehicular

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

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

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": "[email protected]",
    "phone": "+1234567890",
    "source": "website"
  }'

Manejo de errores

Todas las respuestas siguen un formato de error consistente:
{
  "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

CodeHTTP StatusDescripcion
INVALID_API_KEY401La API key es invalida o expiro
RATE_LIMIT_EXCEEDED429Demasiadas solicitudes
VALIDATION_ERROR400Datos de solicitud invalidos
RESOURCE_NOT_FOUND404Recurso no existe
INTERNAL_ERROR500Error del servidor, reintenta

Webhooks

Configura webhooks para recibir actualizaciones en tiempo real:
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