Autenticación
Autenticación
La API de Venflow utiliza API Keys para autenticar las solicitudes.
Tipos de API Keys
| Tipo | Prefijo | Sobre qué actúa |
|---|---|---|
| Clave privada | pvk_ | Tu organización real, con dinero real. Solo desde tu servidor (backend). |
| Clave de prueba | pvtk_ | Tu organización sandbox: mismo código, banco simulado, datos aislados. Se habilita progresivamente, organización por organización. |
Las dos claves viven en el panel, en Desarrolladores → API Keys, y las dos se
usan igual: cambia la clave y cambias de mundo, sin tocar la URL ni el header
Organization. Los objetos del sandbox se reconocen por su campo livemode: false.
El sandbox se está habilitando organización por organización. Mientras tu organización no lo tenga activo, la clave de prueba se acepta igual que la clave privada y actúa sobre tus datos reales. Detalles en Sandbox (modo de prueba).
Headers Requeridos
Todas las solicitudes deben incluir:
Api-Key: pvk_tu_clave_privada
Organization: tu_organization_idEl header Organization siempre lleva el id de tu organización real, incluso cuando
usas la clave de prueba.
Ejemplo
curl -X GET "https://api.venflow.app/v1/products" \
-H "Api-Key: pvk_3f8a2c9d1b0e4a7f6c5d8e9a0b1c2d3e4f5a6b7c8d9e0f1a" \
-H "Organization: org_xyz789..."Errores de Autenticación
| Código | code | Descripción |
|---|---|---|
| 401 | unauthenticated | Falta el header Api-Key, la clave no existe, está revocada, o no corresponde a la organización del header Organization |
| 403 | permission_denied | La clave es válida pero no tiene permiso sobre ese recurso |
Ninguno de los dos se resuelve reintentando. El detalle del cuerpo de respuesta y el resto de los códigos están en Errores.