API REST de Klovio.

URL base

https://api.klovio.app/v1

Autenticación

Todas las peticiones requieren un token Bearer. Genera claves de API en Ajustes → Desarrolladores → Claves de API. Las claves están limitadas por entorno (sandbox / producción) y por rol.

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************"

Límites de tasa

• Estándar: 1.000 peticiones / minuto / clave de API
• Endpoints en bulk: 100 peticiones / minuto
• Webhooks: Sin límite saliente; reintentamos entregas fallidas con backoff exponencial hasta 24 horas

Los headers de límite se incluyen en cada respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Recursos

Inventario

• GET /inventory — lista todos los SKUs con cantidades actuales
• GET /inventory/:sku — obtén un SKU específico
• POST /inventory — crea un nuevo SKU
• PATCH /inventory/:sku — actualiza campos de SKU
• DELETE /inventory/:sku — archiva un SKU

Ubicaciones

• GET /locations — lista almacenes, pasillos, estantes, bandejas
• POST /locations — crea una nueva ubicación
• POST /locations/:id/transfer — transfiere stock entre ubicaciones

Pedidos

• GET /orders — lista pedidos, filtrados por estado
• POST /orders — crea un pedido (desde sistema externo)
• POST /orders/:id/pack — marca pedido como empaquetado
• POST /orders/:id/ship — marca como enviado, descuenta inventario

Escaneos

• POST /scans — registra un evento de escaneo (avanzado)
• GET /scans — historial paginado de escaneos

Petición de ejemplo

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "OOL-001-1L",
    "name": "Aceite de oliva orgánico 1L",
    "on_hand": 248,
    "reorder_point": 50,
    "location": "pasillo-a/estante-3"
  }'

Webhooks

Suscríbete a eventos vía Ajustes → Desarrolladores → Webhooks. Eventos disponibles:

• inventory.updated — se dispara con cualquier cambio de cantidad
• inventory.low_stock — cuando un SKU cae bajo su punto de pedido
• order.created · order.packed · order.shipped
• scan.completed — en cada escaneo (alto volumen — filtra con cuidado)

Los payloads están firmados con HMAC-SHA256. Verifica el header Klovio-Signature contra tu webhook secret.

SDKs

• Node.js: npm install @klovio/node
• Python: pip install klovio
• Ruby: gem install klovio
• Go: go get github.com/klovio/go-sdk