Webhooks

Business

Real-time notifications

Business plan required

Webhooks are available for B2B Business and Enterprise plans.

Available Events

check.completed

Analysis completed

alert.created

New security alert

quota.warning

Quota near limit (80%)

quota.exceeded

Quota exhausted

Payload Format

{
  "id": "evt_abc123",
  "type": "check.completed",
  "created_at": "2024-01-15T10:30:00Z",
  "data": {
    "check_id": "chk_xyz789",
    "verdict": "dangerous",
    "risk_score": 92
  }
}

Signature Verification

Each webhook includes an HMAC-SHA256 signature in the X-Notron-Signature header.

import hmac, hashlib

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

Questions? api@notron.eu