API Pública

Integra Renaska con tus sistemas

Accede a productos, inventario, clientes, pedidos, cotizaciones, pagos y envíos desde cualquier servicio externo. La API es server-to-server: la clave vive en tu servidor, nunca en el navegador.

Solo server-to-serverTu API Key es un secreto. Nunca la incluyas en código frontend, apps móviles ni variables de entorno públicas.
Ir a Configuración → Claves de API

Inicio rápido

Autentícate con tu clave en el header Authorization:

# Ejemplo: listar clientes
curl https://bk.renaska.com/api/external/v1/clients \
  -H "Authorization: Bearer rnk_live_<key>"

URL base: https://bk.renaska.com/api/external/v1

La especificación OpenAPI es pública y no requiere clave — agrega ?lang=es o ?lang=en para obtenerla en tu idioma.

Scopes y permisos

Cada clave otorga uno o más scopes con el formato resource:action (por ejemplo orders:write).

Usa * para acceso total o resource:* para leer y escribir un recurso completo.

Grupos de recursos

Cada grupo se controla con su propio scope.

ProductsSolo lectura
InventorySolo lectura
ClientsLectura y escritura
OrdersLectura y escritura
QuotationsLectura y escritura
PaymentsLectura y escritura
ShippingLectura y escritura

Además: GET /catalog y GET /ping como endpoints de utilidad.

Efectos que debes conocer

  • POST /orders y POST /quotations/:id/convert descuentan stock y generan el asiento contable — no notifican al cliente.
  • POST /shipments no descuenta stock.

Detalles operativos

  • Envía un header Idempotency-Key (opcional, máx. 255 caracteres) en las peticiones POST para evitar duplicados.
  • Límites por clave: 120 lecturas/min y 30 escrituras/min.
  • Las listas se paginan con data + meta (page, limit, total, totalPages) — 20 elementos por página por defecto, máximo 100.
  • Los errores responden con un objeto error (code, message) — por ejemplo 403 insufficient_scope, 429 rate_limited o 409 conflict.

Referencia de endpoints

Explora todos los endpoints y descarga la spec OpenAPI 3.1.

Descargar OpenAPI 3.1 (JSON)