Webhooks Guide
Set up webhooks to get notified when documentation changes.
Webhooks Guide #
Webhooks allow you to receive real-time notifications when events occur in OpenDocs.
Supported Events #
document.created- New document publisheddocument.updated- Document content changeddocument.deleted- Document removedsubmission.created- New submission receivedsubmission.reviewed- Submission approved/rejected
Register a Webhook #
POST /api/v1/webhooks
Authorization: Bearer YOURAPIKEY
Content-Type: application/json
{
"url": "https://your-site.com/webhook",
"events": ["document.created", "document.updated"],
"secret": "your-webhook-secret"
}
Webhook Payload #
{
"event": "document.created",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"id": "uuid",
"slug": "new-document",
"title": "New Document Title"
}
}
Signature Verification #
All webhooks are signed with HMAC-SHA256. Verify using:
const crypto = require("crypto");
const signature = crypto
.createHmac("sha256", secret)
.update(payload)
.digest("hex");
Compare with the X-Webhook-Signature header.
Canonical source
Unknown
Original source
Unknown
Source domain
opendocs-core
Author
Unknown
Publisher
opendocs-core
License / usage
Unknown. Review the original source terms before republishing beyond public-safe excerpts.
Overall quality score, confidence 71%
3 sentences, 5 headings, 5 list items.
Keep source attribution visible in the rendered document.
Related Documentation
The difficulty of making sure your website is broken - Let's Encrypt
Have you ever needed to make sure your website has a broken certificate? While many tools exist to help run an HTTPS server with valid certificates, there arenβt tools to make sure your certificate is revoked or expired. This is not a problem most people have. Tools to help manage certificates are always focused on avoiding those problems, not creating them. Letβs Encrypt is a Certificate Authority, and so we have unusual problems we need to solve.
7 min read
What is JA4 and JA4+ Fingerprinting?
An overview of JA4 fingerprinting, a passive technique for combatting bots.
4 min read
Media Content
1 min read
URL Ingestion Guide
Learn how to ingest documentation from external URLs automatically.