Vismatix
VISMATIX
App
Docs / Developer API v3 / Webhooks & Event Streaming API
Events & Streaming

Webhooks & Event Streaming API واجهة الويب هوك وبث الأحداث

Real-time event subscriptions for post.created, post.published, and task.completed with HMAC validation. اشتراكات فورية في أحداث النشر والمهام مع توقيع أمني واختبار مباشر للتسليم.

Enterprise Event Streaming

Webhooks & Real-Time Event Dispatch

HMAC SHA-256

Subscribe external services, Discord bots, Slack channels, or custom microservices to real-time events triggered inside Vismatix. Every event payload is cryptographically signed using your webhook secret.

اشترك في الأحداث الفورية مثل إنشاء المنشورات ونشرها واكتمال المهام عبر إرسال تنبيهات برمجية فورية إلى خوادمك مع توقيع أمني لمنع التلاعب.

Supported Event Types

post.created

Triggered whenever a post is drafted or scheduled via API or web UI.

post.published

Dispatched when a post is officially published or marked published.

post.scheduled

Fired when a post moves onto an agenda slot or gets rescheduled.

task.completed

Fired whenever a backlog execution task is toggled to finished.

POST /api/v3/webhooks Register Webhook
POST /api/v3/webhooks/{id}/test Live Ping Probe

Sends an immediate test payload with signature header to verify endpoint reachability and latency.

Verifying HMAC-SHA256 Signatures التحقق من توقيع HMAC-SHA256

Every webhook request includes an X-Vismatix-Signature header in the format t=TIMESTAMP,v2=HASH.

# Python HMAC Verification Example:
import hmac, hashlib

def verify_vismatix_webhook(payload_bytes, signature_header, secret):
    # signature_header format: "t=1758837600,v2=abcdef..."
    parts = dict(p.split("=") for p in signature_header.split(","))
    timestamp = parts["t"]
    expected_hash = parts["v2"]
    
    signed_payload = f"{timestamp}.".encode() + payload_bytes
    computed_hash = hmac.new(secret.encode(), signed_payload, hashlib.sha256).hexdigest()
    
    return hmac.compare_digest(computed_hash, expected_hash)
Was this page helpful?