Saltar al contenido principal

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.

Beneficios clave

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

Ideal para

• 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

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

# Sign up and get your API keys
curl -X POST "https://api.steerai.autos/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "company": "Your Company Name"
  }'

2. Realiza tu primera llamada a la API

# Test your authentication
curl -X GET "https://api.steerai.autos/v1/auth/test" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Crea tu primera inspeccion

# 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:
{
  "status": "success|error",
  "data": { ... },
  "meta": {
    "request_id": "req_1234567890",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.23
  }
}

Limites de tasa

PlanSolicitudes/HoraConcurrentesLimite de rafaga
Free1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseUnlimitedCustomCustom

Encabezados de limite de tasa

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-Retry-After: 60

Soporte de SDK

Integraciones de ejemplo

Flujo basico de inspeccion

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

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

CodigoDescripcionResolucion
400Bad RequestRevisa el formato de la solicitud y campos requeridos
401UnauthorizedVerifica la API key y permisos
403ForbiddenRevisa limites del plan y acceso a endpoints
404Not FoundVerifica el ID del recurso y la URL del endpoint
429Rate LimitedImplementa backoff exponencial
500Server ErrorReintenta la solicitud o contacta soporte

Formato de respuesta de error

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

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

Aplicaciones de ejemplo

App de inspeccion de vehiculos

App movil completa para inspecciones en campoVer en GitHub →

Integracion para concesionarios

Integracion completa con sistema de gestion de concesionariosVer en GitHub →

Siguientes pasos

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: [email protected]
  • Comunidad: Comunidad de Discord
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.