Webhooks

​

Flujo

1. Configuras un endpoint público en tu sistema.
2. En el Panel de Esolbay registras la URL del webhook.
3. Esolbay envía eventos (p. ej. order.create) autenticados por cabecera.
4. Tu servicio valida la cabecera y procesa el evento.

​

Configuración en el Panel

• Label descriptivo
• URL (POST pública)
• Eventos habilitados

​

Encabezados

• x-api-key (string): API Key de tu organización.
• x-esolbay-event-id (string): recomendado para idempotencia.
• x-esolbay-timestamp (ISO8601): recomendado para protección anti-replay.

​

Validación

import express from 'express';

const app = express();
app.post('/webhooks/esolbay', express.text({ type: '*/*' }), (req, res) => {
  const providedKey = req.header('x-api-key');
  const expectedKey = process.env.ESOLBAY_API_KEY;
  if (!providedKey || providedKey !== expectedKey) {
    return res.status(401).send('Unauthorized');
  }
  // Opcional: usar x-esolbay-event-id para idempotencia
  // const eventId = req.header('x-esolbay-event-id');
  return res.status(200).send('ok');
});

​

Reintentos e idempotencia

• Usa x-esolbay-event-id como clave idempotente (no procesar el mismo id dos veces).
• Rechaza eventos con x-esolbay-timestamp muy antiguos (p. ej. > 5 minutos).

​

Catálogo de eventos