Webhooks

Événement KENN HOSTING → POST vers votre URL → Votre app traite l'événement

POST /v1/webhooks
Content-Type: application/json

{
  "url": "https://votre-app.com/webhooks/kennhosting",
  "events": [
    "service.activated",
    "payment.completed",
    "domain.registered"
  ]
}

{
  "event": "service.activated",
  "created_at": "2026-04-13T10:30:00+00:00",
  "data": {
    "message": "payload dépendant de l'événement"
  }
}

X-KennHosting-Signature: sha256=abc123def456...

use Illuminate\Http\Request;

public function handle(Request $request): JsonResponse
{
    $signature = $request->header('X-KennHosting-Signature');
    $secret    = config('services.kennhosting.webhook_secret');
    
    $expected = 'sha256=' . hash_hmac('sha256', $request->getContent(), $secret);

    if (!hash_equals($expected, $signature)) {
        return response()->json(['error' => 'Signature invalide'], 401);
    }

    $event = $request->json('event');
    $data  = $request->json('data');

    match ($event) {
        'service.activated' => $this->handleServiceActivated($data),
        'payment.completed' => $this->handlePaymentCompleted($data),
        'domain.registered' => $this->handleDomainRegistered($data),
        default             => null,
    };

    return response()->json(['received' => true]);
}

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

app.post('/webhooks/kennhosting', (req, res) => {
  const sig = req.headers['x-kennhosting-signature'];
  if (!verifySignature(req.rawBody, sig, process.env.WEBHOOK_SECRET)) {
    return res.status(401).json({ error: 'Signature invalide' });
  }

  const { event, data } = req.body;
  // Traiter l'événement...
  res.json({ received: true });
});

POST /v1/webhooks/{id}/test
Content-Type: application/json

{
  "event": "test"
}

GET /v1/webhooks/{id}/deliveries

{
  "data": [
    {
      "delivery_id": "del_01HXYZ001",
      "event": "service.activated",
      "status": "success",
      "http_status": 200,
      "duration_ms": 245,
      "attempted_at": "2024-06-15T10:30:00Z"
    },
    {
      "delivery_id": "del_01HXYZ002",
      "event": "payment.completed",
      "status": "failed",
      "http_status": 500,
      "error": "Connection timeout",
      "retries": 3,
      "attempted_at": "2024-06-15T11:00:00Z"
    }
  ]
}