SDK einrichten

Webhooks hat offizielle SDKs für Python, TypeScript und Go, alle in Version 0.7.0. Sie wiederholen Aufrufe bei vorübergehenden Fehlern, prüfen Webhook-Signaturen und können Events puffern, während die API nicht erreichbar ist. Wählen Sie oben auf der Seite eine Sprache, und jedes Beispiel folgt ihr.

Inboxes und QR-Codes haben noch kein SDK; rufen Sie sie über REST auf. Die API-Referenz zeigt jeden ihrer Aufrufe mit dem üblichen HTTP-Client Ihrer Sprache. SDKs für Infrastruktur (VMs, Speicher, Datenbanken) gibt es ebenfalls noch nicht.

1 · Installation

pip install nn-webhooks-sdk

Python benötigt 3.11 oder neuer, TypeScript benötigt Node.js 24 oder neuer und Go benötigt 1.25 oder neuer. Das Python-Paket wird als nn-webhooks-sdk installiert und als nn_webhooks importiert.

2 · Authentifizieren

Erstellen Sie einen Webhooks-Key in Ihrer Kontokonsole unter API keys: Details finden Sie unter API-Key erstellen. Bauen Sie dann damit einen Client. Lesen Sie den Key aus der Umgebung, statt ihn in Ihren Code zu schreiben.

import os
from nn_webhooks import Client

wh = Client("https://webhooks.nimbusnexus.net", api_key=os.environ["WEBHOOKS_API_KEY"])

3 · Ersten Aufruf senden

Listen Sie Ihre letzten Zustellungen auf. Der Aufruf liest nur, daher kann ihn jeder Key mit dem Scope admin oder read ausführen.

page = wh.list_deliveries()
for d in page["items"]:
    print(d["id"], d["status"], d["attempts"])

Eine leere Liste bedeutet, dass der Key funktioniert und noch nichts zugestellt wurde. Um Ihr erstes Event zu veröffentlichen, folgen Sie dem Schnellstart für Webhooks.

Nächste Schritte

• SDKs für Webhooks: Signaturen prüfen, veröffentlichen, die dauerhafte Outbox, Endpoints verwalten.
• Referenz für die Webhooks-API: jede Operation, mit dem SDK-Aufruf, wo das SDK einen hat.
• CLI: dieselben Operationen aus einer Shell.