Webhook
Integration Guide.

{
  "event":     "scrape.completed",
  "timestamp": "2026-05-19T12:00:00.000Z",
  "data": {
    "url":           "https://example.com/article",
    "status":        "success",
    "status_code":   200,
    "response_time": 312,          // milliseconds
    "metadata": {
      "title":      "Example Domain",
      "description":"This domain is for illustrative examples.",
      "image":      "https://example.com/og.png",
      "domain":     "example.com",
      "word_count": 142,
      "scraped_at": "2026-05-19T12:00:00.000Z"
    }
  }
}

{
  "event":     "scrape.failed",
  "timestamp": "2026-05-19T12:01:00.000Z",
  "data": {
    "url":        "https://example.com/blocked-page",
    "status":     "failed",
    "status_code":403,             // HTTP status from target, null if network error
    "error":      "Target returned 403 Forbidden",
    "metadata":   {}
  }
}

// On every incoming webhook request:
incomingSignature = request.headers["x-resilientlink-signature"]
expectedSecret   = ENV["RESILIENTLINK_WEBHOOK_SECRET"]

if incomingSignature != expectedSecret:
    return HTTP 401  // reject — not from ResilientLink

// safe to process
payload = parse_json(request.body)
handle(payload.event, payload.data)

const express = require('express');
const app     = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
  // 1. Verify signature
  const sig    = req.headers['x-resilientlink-signature'];
  const secret = process.env.RESILIENTLINK_WEBHOOK_SECRET;
  if (!sig || sig !== secret) {
    return res.status(401).end();
  }

  // 2. Parse event
  const { event, timestamp, data } = req.body;
  console.log(`[webhook] Received: ${event}`);

  // 3. Route by event type
  if (event === 'scrape.completed') {
    // data.url, data.metadata.title, etc.
    handleScrapeCompleted(data);
  } else if (event === 'scrape.failed') {
    handleScrapeFailed(data);
  } else if (event === 'quota.warning') {
    handleQuotaWarning(data); // data.percent_used, data.threshold
  }

  // 4. MUST return 200 — body is ignored
  res.status(200).end();
});

app.listen(3000);

from flask import Flask, request, abort
import os

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    # 1. Verify signature
    sig    = request.headers.get('X-ResilientLink-Signature')
    secret = os.environ['RESILIENTLINK_WEBHOOK_SECRET']
    if sig != secret:
        abort(401)

    # 2. Parse event
    payload   = request.get_json()
    event     = payload['event']
    data      = payload['data']
    timestamp = payload['timestamp']

    # 3. Route by event type
    if   event == 'scrape.completed': handle_completed(data)
    elif event == 'scrape.failed':    handle_failed(data)
    elif event == 'quota.warning':    handle_quota(data)

    # 4. MUST return 200
    return '', 200

if __name__ == '__main__':
    app.run(port=3000)

<?php
// webhook.php

// 1. Verify signature
$sig    = $_SERVER['HTTP_X_RESILIENTLINK_SIGNATURE'] ?? '';
$secret = getenv('RESILIENTLINK_WEBHOOK_SECRET');
if ($sig !== $secret) {
    http_response_code(401);
    exit();
}

// 2. Parse event
$payload = json_decode(file_get_contents('php://input'), true);
$event   = $payload['event']     ?? '';
$data    = $payload['data']      ?? [];

// 3. Route by event type
match($event) {
    'scrape.completed' => handle_completed($data),
    'scrape.failed'    => handle_failed($data),
    'quota.warning'    => handle_quota($data),
    default            => null,
};

// 4. MUST return 200
http_response_code(200);
exit();

{
  "event":     "quota.warning",
  "timestamp": "2026-05-19T18:42:00.000Z",
  "data": {
    "percent_used":   80,         // 80 or 95
    "requests_used":  800,        // requests consumed this month
    "requests_limit": 1000,       // effective limit (plan + bonus)
    "plan_limit":     1000,       // base plan allowance
    "bonus_requests": 0,          // remaining one-time bonus (referral)
    "threshold":      80,         // which threshold triggered this
    "reset":          "Resets on the 1st of next month."
  }
}

if (event === 'quota.warning') {
  const { percent_used, threshold, requests_used, requests_limit } = data;
  if (threshold === 95) {
    // Critical — switch to cached fallback or pause non-essential scrapes
    enableFallbackMode();
    alertOpsTeam(`CRITICAL: ${percent_used}% quota used`);
  } else {
    // Warning — notify team, consider upgrading
    sendSlackAlert(`Quota at ${percent_used}%: ${requests_used}/${requests_limit} used`);
  }
}