دليل: استقبال الأحداث عبر الويب هوك

import { Videohati } from "@videohati/node";

const client = new Videohati({ apiKey: process.env.VIDEOHATI_API_KEY });

const endpoint = await client.webhooks.register(projectId, {
  url: "https://example.com/webhooks/videohati",
});

console.log(endpoint.secret); // shown once — save it as VIDEOHATI_WEBHOOK_SECRET

{
  "id": "01JZ9WV3N8GQ5T2M7K4C6XBARE",
  "type": "video.encoding.ready",
  "created_at": "2026-07-05T12:00:00Z",
  "project_id": "01JZ9WV3N8GQ5T2M7K4C6XBARP",
  "data": {
    "videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH"
  }
}

import express from "express";
import { verifyWebhookSignature, SIGNATURE_HEADER } from "@videohati/node";

const app = express();

app.post(
  "/webhooks/videohati",
  express.raw({ type: "application/json" }), // keep the raw body
  (req, res) => {
    const header = req.header(SIGNATURE_HEADER);
    const result = verifyWebhookSignature({
      payload: req.body, // Buffer of the raw body
      header,
      secret: process.env.VIDEOHATI_WEBHOOK_SECRET,
    });

    if (!result.valid) return res.status(400).end();

    // result.event is the parsed envelope.
    if (result.event?.type === "video.encoding.ready") {
      // The video is ready — create a playback session, notify a user, etc.
    }

    res.status(200).end();
  },
);

use Illuminate\Http\Request;
use Videohati\Laravel\Webhooks\SignatureVerifier;

Route::post('/webhooks/videohati', function (Request $request) {
    $event = SignatureVerifier::verifyAndParse(
        $request->getContent(), // the raw body
        $request->header(SignatureVerifier::HEADER),
        config('services.videohati.webhook_secret'),
    );

    if ($event === null) {
        abort(400);
    }

    if ($event['type'] === 'video.encoding.ready') {
        // React to the ready video.
    }

    return response()->noContent(); // 204
});

await client.webhooks.reopenCircuit(projectId, endpoint.id);

await client.webhooks.sendTest(projectId, endpoint.id);

const deliveries = await client.webhooks.listDeliveries(projectId, endpoint.id, {
  limit: 20,
});