Webhook Developer Guide

import hmac
import hashlib
import json
import requests
from datetime import datetime
import uuid

def send_webhook(url: str, webhook_id: str, secret_key: str,
                 event: str, data: dict) -> dict:
    """
    Send signeret webhook til CaapBoard.

    Args:
        url: Webhook ingest URL
        webhook_id: Dit webhook endpoint ID
        secret_key: Din hemmelige nøgle
        event: Event type (f.eks. "sensor.temperature")
        data: Din payload data
    """
    payload = {
        "event": event,
        "idempotency_key": str(uuid.uuid4()),
        "timestamp": datetime.utcnow().isoformat() + "Z",
        "data": data
    }

    # Konverter til bytes
    body = json.dumps(payload, separators=(',', ':')).encode('utf-8')

    # Beregn signatur
    signature = hmac.new(
        secret_key.encode('utf-8'),
        body,
        hashlib.sha256
    ).hexdigest()

    # Send request
    response = requests.post(
        url,
        data=body,
        headers={
            'Content-Type': 'application/json',
            'X-Webhook-Id': webhook_id,
            'X-Webhook-Signature': f'sha256={signature}'
        }
    )

    return response.json()

# Eksempel: Send temperaturmåling
result = send_webhook(
    url="https://din-app.dk/webhook/ingest",
    webhook_id="din-webhook-id",
    secret_key="din-secret-key",
    event="sensor.temperature",
    data={
        "value": 22.5,
        "unit": "celsius",
        "location": "stue"
    }
)
print(result)  # {"received": true, "id": "evt_xxx"}

import crypto from 'crypto';

interface WebhookPayload {
  event: string;
  idempotency_key: string;
  timestamp: string;
  data: Record<string, unknown>;
}

async function sendWebhook(
  url: string,
  webhookId: string,
  secretKey: string,
  event: string,
  data: Record<string, unknown>
): Promise<{ received: boolean; id: string }> {
  const payload: WebhookPayload = {
    event,
    idempotency_key: crypto.randomUUID(),
    timestamp: new Date().toISOString(),
    data
  };

  const body = JSON.stringify(payload);

  // Beregn HMAC-SHA256 signatur
  const signature = crypto
    .createHmac('sha256', secretKey)
    .update(body)
    .digest('hex');

  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Webhook-Id': webhookId,
      'X-Webhook-Signature': `sha256=${signature}`
    },
    body
  });

  return response.json();
}

// Eksempel: Send salgsdata
const result = await sendWebhook(
  'https://din-app.dk/webhook/ingest',
  'din-webhook-id',
  process.env.WEBHOOK_SECRET!,
  'sales.new',
  {
    amount: 299.00,
    currency: 'DKK',
    product: 'Premium Abonnement'
  }
);
console.log(result);

#!/bin/bash

# Konfiguration
WEBHOOK_URL="https://din-app.dk/webhook/ingest"
WEBHOOK_ID="din-webhook-id"
SECRET_KEY="din-secret-key"

# Funktion til at sende webhook
send_webhook() {
    local event="$1"
    local data="$2"

    # Opret payload
    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
    local idempotency_key=$(uuidgen)

    local body=$(cat <<EOF
{"event":"$event","idempotency_key":"$idempotency_key","timestamp":"$timestamp","data":$data}
EOF
)

    # Beregn signatur
    local signature=$(echo -n "$body" | openssl dgst -sha256 -hmac "$SECRET_KEY" | cut -d' ' -f2)

    # Send request
    curl -s -X POST "$WEBHOOK_URL" \
        -H "Content-Type: application/json" \
        -H "X-Webhook-Id: $WEBHOOK_ID" \
        -H "X-Webhook-Signature: sha256=$signature" \
        -d "$body"
}

# Eksempel: Send systemstatus
send_webhook "system.status" '{"cpu":45,"memory":62,"disk":78}'

<?php

function sendWebhook(
    string $url,
    string $webhookId,
    string $secretKey,
    string $event,
    array $data
): array {
    $payload = json_encode([
        'event' => $event,
        'idempotency_key' => uniqid('', true),
        'timestamp' => gmdate('Y-m-d\TH:i:s\Z'),
        'data' => $data
    ], JSON_UNESCAPED_SLASHES);

    $signature = hash_hmac('sha256', $payload, $secretKey);

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $payload,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            "X-Webhook-Id: $webhookId",
            "X-Webhook-Signature: sha256=$signature"
        ]
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Eksempel: Send lageroptælling
$result = sendWebhook(
    'https://din-app.dk/webhook/ingest',
    'din-webhook-id',
    $_ENV['WEBHOOK_SECRET'],
    'inventory.update',
    ['sku' => 'PROD-001', 'quantity' => 42]
);
var_dump($result);