وب‌هوک

const endpoint = await client.webhooks.create({
  url: 'https://myapp.com/webhooks/incoming',
  events: ['job.completed', 'job.failed'],
});

// فقط همین یک بار نمایش داده می‌شود — ذخیره‌اش کنید
console.log(endpoint.secret);   // whsec_...

import express from 'express';
import { webhookHandler } from '@aiproxy/sdk/middleware';

// express.raw ضروری است: امضا روی بایت‌های خام محاسبه شده
app.post('/webhooks/incoming',
  express.raw({ type: 'application/json' }),
  webhookHandler(process.env.WEBHOOK_SECRET, async (event) => {
    if (event.type === 'job.completed') {
      await markReady(event.data.id);
    }
  }));

X-Signature: t=1735689600,v1=5257a869e7...

# رشتهٔ امضاشده:
#   "<t>.<بدنهٔ خام>"
# الگوریتم: HMAC-SHA256 با کلید whsec_

{
  "id": "evt_a1b2c3d4e5f6",
  "type": "job.completed",
  "created": 1735689600,
  "data": {
    "id": "job_x7y8z9",
    "tool": "face-swap",
    "status": "completed",
    "credits": 10
  }
}

// ارسال یک رویداد آزمایشی
await client.webhooks.test(endpoint.id);

// دیدن اینکه دقیقاً چه فرستادیم و چه پاسخی گرفتیم
const log = await client.webhooks.deliveries(endpoint.id);
for (const d of log) {
  console.log(d.attempt, d.success, d.status, d.durationMs + 'ms', d.error);
}