Help Center / api

Webhooks einrichten

Webhooks einrichten

Webhooks benachrichtigen Ihre Anwendung, wenn Ereignisse in Ihrem Konto auftreten. Erhalten Sie Echtzeit-Updates ohne Polling.

So funktionieren Webhooks

1. Ein Ereignis tritt auf (z. B. eine Domain wird registriert)
2. Wir senden einen HTTP-POST an Ihren Endpunkt
3. Ihr Server verarbeitet das Ereignis
4. Er antwortet mit 200 OK

Einen Webhook erstellen

1. Gehen Sie zu Einstellungen > Webhooks
2. Klicken Sie auf Endpunkt hinzufügen
3. Geben Sie Ihre URL ein (muss HTTPS sein)
4. Wählen Sie die zu empfangenden Ereignisse aus
5. Speichern

Webhook-Ereignisse

Domain-Ereignisse

VPS-Ereignisse

Abrechnungs-Ereignisse

Webhook-Payload

{
  "id": "evt_1234567890",
  "type": "domain.registered",
  "created": 1640000000,
  "data": {
    "domain": "example.com",
    "registrant": "user@email.com",
    "expiration": "2025-01-01"
  }
}

Webhooks verifizieren

Verifizieren Sie mithilfe von Signaturen, dass Anfragen von uns stammen:

const crypto = require('crypto')

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex')

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  )
}

// In your endpoint
app.post('/webhook', (req, res) => {
  const signature = req.headers['x-osir-signature']
  const isValid = verifyWebhook(req.rawBody, signature, webhookSecret)

  if (!isValid) {
    return res.status(401).send('Invalid signature')
  }

  // Process event
  res.status(200).send('OK')
})

Wiederholungsrichtlinie

Wenn Ihr Endpunkt fehlschlägt, wiederholen wir den Versuch:

Nach 5 Fehlversuchen wird der Webhook deaktiviert.

Webhooks testen

1. Gehen Sie zu Ihren Webhook-Einstellungen
2. Klicken Sie auf Testereignis senden
3. Wählen Sie den Ereignistyp aus
4. Sehen Sie sich die Anfrage/Antwort an

Webhook-Protokolle

Zeigen Sie den Zustellverlauf an:

1. Gehen Sie zu Webhooks > Endpunkt auswählen
2. Klicken Sie auf Protokolle
3. Sehen Sie alle Versuche und Antworten
4. Wiederholen Sie fehlgeschlagene Ereignisse

Bewährte Vorgehensweisen

• Antworten Sie schnell - Geben Sie innerhalb von 30 Sekunden 200 zurück
• Verarbeiten Sie asynchron - Reihen Sie Ereignisse für die Hintergrundverarbeitung in eine Warteschlange ein
• Verifizieren Sie Signaturen - Validieren Sie Anfragen immer
• Behandeln Sie Duplikate - Ereignisse können mehrfach gesendet werden
• Protokollieren Sie alles - Bewahren Sie Aufzeichnungen zur Fehlersuche auf