1. Rechner finden
  2. Zahlen und Einheiten eingeben
  3. Ergebnisse lesen und ihnen vertrauen
  4. Speichern, teilen und einbetten
  5. Mit der API entwickeln
  6. Konto und Tarif
  7. Datenschutz und Ihre Daten
  8. Ein Problem beheben

Webhook-Signatur überprüfen

Bilden Sie aus dem Header X-CalcLib-Signature den String t.body, berechnen Sie HMAC-SHA256 mit Ihrem Secret und vergleichen Sie, bevor Sie die Zustellung verarbeiten.

API-Tokens, Nutzung, der MCP-Server für KI-Agenten und Webhooks.

Ein Webhook-Endpunkt, den Sie unter Webhooks hinzufügen, erhält jedes Mal einen signierten POST, wenn jemand Ihre Einbettung verwendet. Jede Zustellung enthält einen X-CalcLib-Signature-Header der Form t=<unix time>,v1=<signature>.

Prüfen, bevor Sie parsen

  1. Lesen Sie den rohen Request-Body. Wenn Sie das JSON parsen und erneut serialisieren, ändern sich die Bytes, und die Signatur stimmt nie überein.
  2. Entnehmen Sie t dem Header und bilden Sie den String t.body: den Zeitstempel, einen Punkt, dann den rohen Body.
  3. Berechnen Sie den HMAC-SHA256 dieses Strings mit dem Secret Ihres Endpunkts, als Hex-Wert.
  4. Vergleichen Sie ihn in konstanter Zeit mit jedem v1-Wert. Während Sie ein Secret rotieren, kann der Header zwei v1-Werte enthalten; jeder von ihnen kann passen.
  5. Weisen Sie die Zustellung ab, wenn t mehr als 5 Minuten von Ihrer Systemzeit abweicht.

Zustellungen, die fehlschlagen

Sie werden nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 8 Stunden erneut versucht. Ein Endpunkt, der 20-mal hintereinander fehlschlägt, wird deaktiviert, und wir senden Ihnen eine E-Mail, sofern der Schalter „Produkt“ unter Benachrichtigungen aktiviert ist.

War dieser Artikel hilfreich?

Immer noch nicht weiter? Support kontaktieren · Hilfecenter