Webhook-Guide

Webhooks einrichten und nutzen

Automatisieren Sie Ihre Workflows durch Echtzeit-Benachrichtigungen. Erhalten Sie sofort Updates über abgeschlossene Analysen.

~12 Minuten

Entwickler

Automatisierung

Voraussetzungen

Was Sie für diesen Guide benötigen

Einen öffentlich erreichbaren Server/Endpoint

HTTPS-Unterstützung (SSL-Zertifikat)

Grundkenntnisse in HTTP/JSON

Webhook-Bereich öffnen

Navigieren Sie zu "Entwickler" → "Webhooks"im Dashboard.

Webhook konfigurieren

Klicken Sie auf "Neuen Webhook erstellen"und konfigurieren Sie die Einstellungen.

Konfigurationsoptionen

URL

HTTPS-Endpoint Ihres Servers (z.B. https://ihr-server.de/webhooks/resell-scan)

Events

Wählen Sie die Ereignisse aus (analysis.completed)

Secret

Optional: Geheimer Schlüssel zur Signaturverifikation

Endpoint implementieren

Implementieren Sie einen HTTP-Endpoint, der die Webhook-Nachrichten empfängt.

Node.js/Express Beispiel

const express = require('express');
const app = express();

app.use(express.json());

app.post('/webhooks/resell-scan', (req, res) => {
  const event = req.body;
  
  // Event verarbeiten
  switch (event.event) {
    case 'analysis.completed':
      console.log('Batch abgeschlossen:', event.data);
      break;
  }
  
  res.status(200).send('OK');
});

Webhook Payload Struktur

{
  "id": "evt_550e8400-e29b-41d4-a716-446655440000",
  "event": "analysis.completed",
  "created_at": "2024-01-15T10:30:00Z",
  "data": {
    "batch_id": "550e8400-e29b-41d4-a716-446655440001",
    "collection_id": "550e8400-e29b-41d4-a716-446655440002",
    "status": "completed"
  }
}

Webhook testen

Testen Sie Ihren Webhook mit der Test-Funktion im Dashboard.

Sicherheit & Verifikation

• Webhook-Signaturen verifizieren (HMAC-SHA256)
• Idempotenz-Keys für doppelte Nachrichten prüfen
• IP-Whitelist für zusätzliche Sicherheit
• Retry-Logik für fehlgeschlagene Zustellungen

🔔 Verfügbare Webhook-Events

analysis.completed

Eine Batch-Analyse wurde abgeschlossen

Payload: batch_id, collection_id, status, total_products, successful_products, failed_products, products[]

Weitere Guides entdecken

Zur Guides-Übersicht

Guide abgeschlossen