API a Webhook - różnicę

┌────────┐                      ┌────────┐
│ Klient │ ───── Request ─────> │ Serwer │
│        │ <──── Response ───── │        │
└────────┘                      └────────┘

Przykład: "Czy sa nowe zamowienia?"
- Klient pyta co 5 sekund
- Serwer odpowiada: "Nie" / "Tak, oto dane"

┌────────┐                      ┌────────┐
│ Klient │ <── Webhook POST ─── │ Serwer │
│        │ ──── Ack 200 OK ───> │        │
└────────┘                      └────────┘

Przykład: "Powiadom mnie o nowych zamowieniach"
- Klient rejestruje URL webhooka
- Serwer wysyła POST, gdy pojawi się zamowienie
- Klient przetwarza dane natychmiast

Czas:     0s    5s    10s   15s   20s   25s   30s
Klient:   ?     ?     ?     ?     ?     ?     ?
Serwer:   -     -     -     !     -     -     -
          └─────────────────┴─────────────────┘
          6 pustych zapytan, 1 z danymi

Czas:     0s    5s    10s   15s   20s   25s   30s
Klient:   (czeka)           !
Serwer:   (przetwarza)      └── Wysyła webhook
          Zero pustych zapytan, natychmiastowa reakcja

// Klient odpytuje API co 10 sekund (polling)
async function checkForNewOrders() {
  const response = await fetch('https://api.sklep.pl/orders?status=new', {
    headers: {
      'Authorization': 'Bearer ' + apiKey
    }
  });
  const orders = await response.json();

  if (orders.length > 0) {
    processOrders(orders);
  }
}

// Polling - nieefektywne, ale proste
setInterval(checkForNewOrders, 10000);

// Rejestracja URL webhooka w systemie zewnetrznym
await fetch('https://api.sklep.pl/webhooks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://moja-aplikacja.pl/webhooks/orders',
    events: ['order.created', 'order.paid']
  })
});

// Express.js - endpoint odbierajacy webhooki
app.post('/webhooks/orders', express.json(), (req, res) => {
  const signature = req.headers['x-webhook-signature'];

  // Weryfikacja podpisu (bezpieczeństwo!)
  if (!verifySignature(req.body, signature, webhookSecret)) {
    return res.status(401).send('Invalid signature');
  }

  const event = req.body;
  console.log('Otrzymano event:', event.type);

  // Przetwarzanie zdarzenia
  switch (event.type) {
    case 'order.created':
      handleNewOrder(event.data);
      break;
    case 'order.paid':
      handlePayment(event.data);
      break;
  }

  // Potwierdzenie odbioru (WAZNE!)
  res.status(200).send('OK');
});

{
  "id": "evt_123456789",
  "type": "order.created",
  "created_at": "2024-01-15T10:30:00Z",
  "data": {
    "order_id": "ord_abc123",
    "customer_email": "klient@example.com",
    "total": 199.99,
    "currency": "PLN",
    "items": [
      {
        "product_id": "prod_xyz",
        "name": "Kurs programowania",
        "quantity": 1
      }
    ]
  }
}