Inicio Rapido
Esta guia te ayudara a hacer tu primera llamada a la API de ZenFlow en menos de 5 minutos.
Paso 1: Obtener tu API Key
- Inicia sesion en tu Panel de ZenFlow
- Navega a Configuracion > API Keys
- Haz clic en Crear API Key
- Dale un nombre a tu key y selecciona los permisos (scopes) necesarios
- Copia y guarda tu API key de forma segura
El secreto de tu API key solo se muestra una vez. Guardalo de forma segura -
no podras verlo de nuevo.
Paso 2: Hacer tu Primera Peticion
Vamos a obtener tus pedidos para asegurarnos de que todo funciona:
curl -X GET "https://api.zenflow.com.ar/api/v1/orders" \
-H "X-API-Key: zenflow_live_tu_api_key_aqui" \
-H "Content-Type: application/json"
{
"success": true,
"data": {
"orders": [],
"pagination": {
"total": 0,
"page": 1,
"limit": 50,
"total_pages": 0
}
}
}
Paso 3: Crear tu Primer Pedido
Ahora vamos a crear un pedido:
curl -X POST "https://api.zenflow.com.ar/api/v1/orders" \
-H "X-API-Key: zenflow_live_tu_api_key_aqui" \
-H "Content-Type: application/json" \
-d '{
"order_tenant_id": "ORD-001",
"assembly_date": "2024-01-15",
"order_detail": [
{
"barcode": "7891234567890",
"quantity": 2
}
]
}'
Paso 4: Configurar Webhooks (Opcional)
Para recibir notificaciones en tiempo real cuando se actualicen los pedidos, configura un webhook:
curl -X POST "https://api.zenflow.com.ar/api/v1/webhooks" \
-H "X-API-Key: zenflow_live_tu_api_key_aqui" \
-H "Content-Type: application/json" \
-d '{
"name": "Actualizaciones de Pedidos",
"url": "https://tu-servidor.com/webhooks/zenflow",
"events": ["order.created", "order.updated", "order.completed"]
}'
Asegurate de guardar el secreto del webhook que se devuelve en la respuesta -
lo necesitaras para verificar las firmas de los webhooks.
Siguientes Pasos
