Oferta Limitada de Lanzamiento
Ahorra 70% de por vidaVer oferta
Volver al inicio

Documentación API

v1.0

Integra el inventario de SIVEC en tu sitio web, CRM o aplicaciones de terceros.

Autenticación

La API de SIVEC utiliza API Keys para autenticar las peticiones. Puedes ver y administrar tus API keys en el Dashboard de Desarrollador.

Nota: Tu API Key debe enviarse en el header X-API-Key. No la compartas en repositorios públicos ni en el código del lado del cliente (frontend).

curl https://api.sivec.com.ar/public/vehicles \
  -H "X-API-Key: sk_live_51Mz..."

Límites & Quotas

Los límites de la API dependen de tu plan de suscripción. Si excedes el límite, recibirás un error 429 Too Many Requests.

PlanRate LimitWebhooks
Profesional1,000 req/horaNo incluido
Enterprise Recomendado10,000 req/hora✅ Incluido

Errores

La API utiliza códigos de respuesta HTTP estándar para indicar el éxito o fracaso de una petición.

CódigoDescripción
200 OKLa petición fue exitosa.
400 Bad RequestFaltan parámetros o son inválidos.
401 UnauthorizedAPI Key inválida o faltante.
403 ForbiddenTu plan no permite acceder a este recurso.
404 Not FoundEl recurso solicitado no existe.
429 Too Many RequestsHas excedido el límite de peticiones de tu plan.
500 Server ErrorError interno del servidor. Intenta nuevamente.

Formato de Error

Todas las respuestas de error siguen un formato estructurado:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key inválida o inactiva",
    "documentation_url": "https://sivec.com.ar/docs#errors"
  },
  "meta": {
    "api_version": "1.1",
    "timestamp": "2026-01-06T17:00:00-03:00",
    "request_id": "req_a1b2c3d4e5f6g7h8"
  }
}
GET

/api/public/vehicles

Obtiene una lista paginada de los vehículos activos en tu inventario. Por defecto, devuelve solo vehículos con estado "En stock".

Parámetros Query

ParámetroTipoDescripción
limitintegerMáx 100. Default 20.
offsetintegerÍndice desde donde empezar. Default 0.
statusstringEn stock, Reservado, Vendido
makestringFiltrar por marca (ej: "Toyota")
modelstringFiltrar por modelo (ej: "Corolla")
year_min / year_maxintegerFiltrar por rango de años
price_min / price_maxintegerFiltrar por rango de precio (USD)

Respuesta Ejemplo

{
  "success": true,
  "data": {
    "vehicles": [
      {
        "id": 123,
        "make": "Toyota",
        "model": "Corolla",
        "version": "2.0 SEG CVT",
        "year": 2023,
        "mileage": 15000,
        "color": "Blanco",
        "price_usd": 25000,
        "description": "Único dueño, service oficial.",
        "image_urls": ["https://..."],
        "status": "En stock",
        "doors": 4,
        "fuel_type": "Nafta",
        "transmission": "Automática"
      }
    ],
    "pagination": {
      "total": 45,
      "limit": 20,
      "offset": 0,
      "has_more": true
    }
  },
  "meta": {
    "api_version": "1.1",
    "timestamp": "2026-01-06T17:00:00-03:00",
    "request_id": "req_a1b2c3d4e5f6g7h8"
  }
}
POST

/api/public/contact

Envía un lead interesado directamente a tu CRM de SIVEC. Si tienes configuradas las notificaciones, recibirás un email/WhatsApp instantáneo.

{
  "name": "Juan Pérez",
  "email": "juan@example.com",
  "phone": "+5491112345678",
  "vehicle_id": 123,  // Opcional: ID del vehículo
  "message": "Hola, me interesa permutar mi auto..."
}
GET

/api/public/dealership

Obtiene la información pública de tu concesionaria para mostrar en tu sitio web.

Respuesta Ejemplo

{
  "name": "Autos del Sur",
  "address": "Av. Corrientes 1234, CABA",
  "phone": "+54 11 4567-8900",
  "email": "ventas@autosdelsur.com.ar",
  "website": "www.autosdelsur.com.ar"
}

Webhooks

Coming Soon

Suscríbete a eventos en tiempo real para mantener tu sitio web sincronizado sin hacer polling constante.

vehicle.updated

Se dispara cuando cambia el precio, estado o fotos de un vehículo.

vehicle.sold

Ideal para poner automáticamente el cartel de "VENDIDO" en tu web.

Integraciones

Beta
ML

MercadoLibre Sync

Sincronización bidireccional de inventario y preguntas.

Actualmente en beta cerrada para Founding Partners. Permite publicar automáticamente tus vehículos en MercadoLibre y recibir las preguntas en el inbox de SIVEC.

GET /api/integrations/mercadolibre/status

¿Necesitas ayuda técnica?

Nuestros desarrolladores están disponibles para ayudarte a integrar SIVEC en tu flujo de trabajo.

Hablar con Soporte Técnico