Configura un SDK

Webhooks tiene SDKs oficiales para Python, TypeScript y Go, todos en la versión 0.7.0. Reintentan los fallos transitorios, verifican las firmas de los webhooks y pueden guardar eventos en buffer mientras la API no está disponible. Elige un lenguaje en la parte superior de la página y todos los ejemplos lo siguen.

Inboxes y códigos QR todavía no tienen SDK; llámalos por REST. La Referencia de la API muestra cada una de sus llamadas con el cliente HTTP habitual de tu lenguaje. Tampoco hay todavía SDKs para Infraestructura (VMs, almacenamiento, bases de datos).

1 · Instalación

pip install nn-webhooks-sdk

Python necesita la 3.11 o posterior, TypeScript necesita Node.js 24 o posterior y Go necesita la 1.25 o posterior. El paquete de Python se instala como nn-webhooks-sdk y se importa como nn_webhooks.

2 · Autenticación

Crea una clave de Webhooks en la consola de tu cuenta, en API keys: los detalles están en Obtén una clave de API. Después crea un cliente con ella. Lee la clave del entorno en lugar de escribirla en tu código.

import os
from nn_webhooks import Client

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

3 · Haz una primera llamada

Lista tus entregas recientes. Solo lee, así que cualquier clave admin o read puede ejecutarlo.

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

Una lista vacía significa que la clave funciona y que todavía no se ha entregado nada. Para publicar tu primer evento, sigue el Inicio rápido de Webhooks.

Próximos pasos

• SDKs de Webhooks: verificación de firmas, publicación, el outbox duradero y la gestión de endpoints.
• Referencia de la API de Webhooks: todas las operaciones, con la llamada del SDK cuando el SDK la tiene.
• CLI: las mismas operaciones desde un shell.