Webhooks
Los webhooks te permiten recibir notificaciones en tiempo real cuando ocurren eventos en tu cuenta de pey. En lugar de consultar nuestra API periódicamente en busca de actualizaciones, los webhooks envían los datos a tu servidor conforme suceden los eventos.
Autenticación
Usamos Standard Webhooks para firmar todas las solicitudes. Esto garantiza que puedas verificar la autenticidad de los webhooks entrantes y confiar en que provienen de pey.
Para validar las firmas de los webhooks, recomendamos usar los SDKs oficiales de Standard Webhooks, disponibles para varios lenguajes de programación.
Ejemplo de validación
Aquí tienes un ejemplo en Python usando AWS Lambda invocada desde AWS API Gateway.
import json
from standardwebhooks.webhooks import Webhook
def handler(event, context):
try:
headers = event.get('headers', {})
webhook_id = headers.get('webhook-id', None) # TODO: Esta es la clave de idempotencia, puedes usarla para deduplicar solicitudes
body = json.loads(event['body'])
except Exception as e:
print(f'Error parsing request info: {str(e)}')
return { "statusCode": 400, "body": json.dumps({"message": f"Error parsing request info: {str(e)}"}) }
try:
webhook_secret = "whsec_123456789" # TODO: No pongas tu secreto en el código, obtenlo de una variable de entorno o de un gestor de secretos
wh = Webhook(webhook_secret) # Inicializa el validador de webhooks con tu secreto
wh.verify(event['body'], headers) # Pasa el cuerpo como string sin procesar, no el body parseado
print(f"Webhook validated successfully: {webhook_id}")
return { "statusCode": 200 }
except Exception as e:
print(f"Error validating webhook: {e}")
return { "statusCode": 500, "body": json.dumps({"message": f"Error validating webhook: {e}"}) }
Historial de entregas de webhooks
Puedes ver el historial de entregas de tus webhooks en la sección Desarrollador. Haz clic en el ícono de engrane de la API key y luego en el botón "Webhook Logs".
Verás todos los intentos de entrega que se han hecho a tu endpoint, el payload que enviamos, la respuesta que recibimos de tu endpoint y otra información relevante.