Cancelar la suscripción a un evento
Solo aplica si usas suscripciones
Este endpoint es parte del esquema de suscripciones por evento (beta). Si usas la URL única del panel (el esquema estándar), no lo necesitas: todos los eventos ya te llegan ahí automáticamente.
Elimina una suscripción por su id.
El id viaja en el cuerpo JSON, no en la ruta ni en el query string. Algunos clientes HTTP
omiten el cuerpo en DELETE, así que verifica que el tuyo sí lo mande.
Autenticación
signmage Cada petición lleva Authorization: signmage {webId}:{firma}, donde firma es el Base64 de
HMAC-SHA256(apiKey, cadenaFirmada).
Qué va dentro de cadenaFirmada depende de la petición:
| Petición | cadenaFirmada |
|---|---|
GET | La URI completa incluyendo el query string, exactamente como se envía |
POST con JSON | El cuerpo JSON, re-serializado compacto (sin espacios ni salto de línea final) |
POST multipart | El SHA-256 en Base64 del archivo, que además se manda en el header Content-SHA256 |
Dos detalles que conviene resolverlos desde el principio:
- En
GET, la URI se firma tal como se envía, así que el orden y el encoding de los parámetros importan. - En
POST, la comparación se hace contra tu JSON re-serializado en forma compacta. Manda JSON compacto y canónico para que las firmas coincidan.
Una firma que no coincide devuelve 401 con el cuerpo vacío. Como la misma respuesta cubre un
web ID desconocido, una llave inactiva y una firma que no coincide, revisa las tres cosas al
diagnosticar.
En: header
Cuerpo de la petición
application/json
Definiciones de TypeScript
Usa el tipo request body en TypeScript.
Cuerpo de la respuesta
application/json
curl -X DELETE "https://example.com/api/v1/webhooks" \ -H "Content-Type: application/json" \ -d '{ "id": "string" }'