Skip to main content
This is a test version of the page. To contact the owner, email [email protected]
CarsKeep
🇪🇸 es
🔌 API REST V1 Y WEBHOOKS PARA DESARROLLADORES

Plataforma Abierta CarsKeep API v1

Conecte su sistema de gestión, aplicaciones móviles, telemetría y contabilidad con tokens Bearer JWT y garantía Zero Lock-in.

Ver documentación API

Arquitectura API y Autenticación

Pasarela API Gateway de alto rendimiento con autorización Bearer JWT

API Base URL Production HTTPS Gateway
https://api.carskeep.com/api/v1/

Todas las peticiones se transmiten mediante HTTPS seguro. Los tokens de servicio se configuran con permisos granulares. 

curl -X POST "https://api.carskeep.com/api/v1//orders" \
  -H "Authorization: Bearer ck_live_9f8a2e1d4c..." \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "JTDKN36U901234567",
      "plate": "10-AB-420",
      "model": "Toyota Camry 2.5 AT"
    },
    "bayNumber": 2,
    "mileageKm": 68420,
    "customer": {
      "name": "Alexei Ivanov",
      "phone": "+77014205566"
    },
    "services": [
      { "code": "SRV-OIL-01", "name": "Замена масла и фильтра", "hours": 0.8 },
      { "code": "SRV-BRK-02", "name": "Замена передних колодок", "hours": 1.2 }
    ]
  }'
HTTPS 201 Created
auth: bearer_tokengzip: 240b

Endpoints Principales de la API v1

Operaciones CRUD estandarizadas para automatizar el taller mecánico

1. Citas Online y Captación

3 routes
POST /api/v1/bookings/slots
Consultar huecos libres de elevadores y mecánicos
POST /api/v1/bookings/create
Crear reservas desde la web o mapas
POST /api/v1/leads
Captación de solicitudes con filtro antibot

2. Gestión de Órdenes de Reparación

3 routes
GET /api/v1/repair-orders
Listar órdenes con filtros de estado y fechas
GET /api/v1/repair-orders/:id
Detalle de la orden, mano de obra y fotos DVI
POST /api/v1/repair-orders/:id/status
Cambiar orden de columna en el tablero Kanban

3. Almacén de Recambios FIFO

3 routes
GET /api/v1/inventory/items
Búsqueda de piezas por código OEM y bastidor VIN
POST /api/v1/inventory/batch-receive
Entrada de albaranes de proveedores por partidas FIFO
POST /api/v1/inventory/reserve
Reserva de recambios para una orden de trabajo

4. Libertad de Datos y Exportación Total

1 routes
GET /api/v1/tenants/export/full
Descarga criptográfica completa en JSON en 1 clic

Eventos y Webhooks en Tiempo Real

Notificaciones instantáneas para CRM externos y sistemas de alerta

Ejemplo de Carga Útil JSON:

event: ro.status_changed 
{
  "event": "repair_order.estimate_approved",
  "timestamp": "2026-09-30T10:14:22Z",
  "tenant_id": "ten_baku_4021",
  "data": {
    "repair_order_id": "ro_94021",
    "customer": {
      "name": "Рамиль Мамедов",
      "phone": "+994502000000"
    },
    "vehicle": {
      "vin": "KMHD381UBJU194021",
      "license_plate": "10-AB-402",
      "model": "Kia Sportage 2021"
    },
    "approved_amount": 155.00,
    "currency": "AZN",
    "approved_items": [
      { "type": "part", "code": "54813-2S000", "title": "Втулка стабилизатора", "qty": 2, "price": 20.00 },
      { "type": "labor", "code": "L-SU-04", "title": "Замена втулок стабилизатора", "hours": 0.8, "price": 35.00 }
    ]
  }
}
booking.created

Nueva reserva creada mediante widget web

Cita de cliente
vehicle.checked_in

Recepción DVI completada al entrar el vehículo

Recepción del taller
repair_order.estimate_approved

Cliente aprueba el presupuesto en WhatsApp

Aprobación de cliente
repair_order.completed

Vehículo reparado y listo para entrega

Fin de trabajo
payment.fiscalized

Cobro registrado y factura emitida

Cobro en caja

Integración de Telemetría y OBD-II

Recepción directa de datos de flotas comerciales conectadas

Sincronización Automática de Kilometraje

El odómetro de cada vehículo se actualiza diariamente vía satélite GPS sin anotaciones manuales.

Alertas de Códigos de Falla DTC

Si se detecta una anomalía en el motor (ej. P0300), se genera una tarea preventiva para avisar al cliente.

Dispositivos compatibles: Teltonika, Galileosky, StarLine, Ruptela, Navtelecom

SDK Oficiales para Desarrolladores

Librerías con tipado estricto y manejo de errores integrado

v1.4.0 • Zero DB Import

Node.js / TypeScript

npm install @carskeep/api-sdk
v1.2.0 • Asyncio ready

Python

pip install carskeep-sdk
REST OpenAPI 3.0

cURL / HTTP

curl -H "Authorization: Bearer token" https://api.carskeep.com
Catálogo de más de 45 integraciones listas