​

Autenticacion

​

Obtener una API Key

1. Inicia sesion en tu Panel de ZenFlow
2. Navega a Configuracion > API Keys
3. Haz clic en Crear API Key
4. Configura tu key:
   • Nombre: Un nombre descriptivo (ej: “Integracion ERP”)
   • Scopes: Selecciona los permisos que tu key necesita
   • Expiracion: Fecha de expiracion opcional
5. Haz clic en Crear
6. Copia tu API key inmediatamente - no se mostrara de nuevo

​

Usar tu API Key

curl -X GET "https://api.zenflow.com.ar/api/v1/orders" \
  -H "X-API-Key: zenflow_live_abc123..."

const response = await fetch("https://api.zenflow.com.ar/api/v1/orders", {
  headers: {
    "X-API-Key": "zenflow_live_abc123...",
  },
});

import requests

response = requests.get(
    'https://api.zenflow.com.ar/api/v1/orders',
    headers={'X-API-Key': 'zenflow_live_abc123...'}
)

​

Formato de API Key

zenflow_live_<cadena_aleatoria>
zenflow_test_<cadena_aleatoria>

• zenflow_live_*: Keys de produccion
• zenflow_test_*: Keys de prueba/sandbox (proximamente)

​

Scopes (Permisos)

​

Presets de Scopes

​

Respuestas de Error

​

API Key Invalida

{
  "success": false,
  "error": {
    "code": "invalid_api_key",
    "message": "La API key proporcionada es invalida o ha sido revocada"
  }
}

​

API Key Faltante

{
  "success": false,
  "error": {
    "code": "missing_api_key",
    "message": "Se requiere API key. Incluyela en el header X-API-Key"
  }
}

​

Permisos Insuficientes

{
  "success": false,
  "error": {
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido: write:orders"
  }
}

​

API Key Expirada

{
  "success": false,
  "error": {
    "code": "expired_api_key",
    "message": "Esta API key ha expirado"
  }
}

​

Mejores Practicas de Seguridad

​

Ejemplo: Variables de Entorno

# archivo .env (nunca hagas commit de esto!)
ZENFLOW_API_KEY=zenflow_live_abc123...

// Node.js
const apiKey = process.env.ZENFLOW_API_KEY;

# Python
import os
api_key = os.environ.get('ZENFLOW_API_KEY')

​

Rotar API Keys

1. Crea una nueva API key con los mismos scopes
2. Actualiza tu aplicacion para usar la nueva key
3. Verifica que la nueva key funciona
4. Revoca la key antigua

​

Lista Blanca de IPs (Opcional)

1. Ve a Configuracion > API Keys
2. Selecciona tu API key
3. Agrega direcciones IP permitidas o rangos CIDR
4. Guarda los cambios

{
  "ip_whitelist": ["192.168.1.100", "10.0.0.0/24"]
}

​

Limites de Tasa