webhooks RTC
يرسل RTC أحداثًا تتعلق بغرفك والمشاركين والتسجيلات وحسابك إلى webhook نقاط النهاية تقوم بتسجيلها. لكل نقطة نهاية عنوان URL خاص بها، و مرشحات الأحداث، وأسرار التوقيع، وسجل التسليم. التسليم هو مرة واحدة على الأقل: إزالة التكرار في الحدث id قبل اتخاذ أي إجراء.
نقاط النهاية
Section titled “نقاط النهاية”إدارة نقاط النهاية في وحدة التحكم RTC ضمن Webhooks، عبر APIباستخدام جلسة عمل وحدة التحكم الخاصة بك، أو باستخدام APIمفتاح مشروع يحتوي على webhooks:read
أو webhooks:write النطاق. مفتاح المشروع يرى ويدير فقط نقاط النهاية الخاصة بمشروعه.
| الإعداد | المعنى |
|---|---|
| رابط URL | عنوان URL عام عبر HTTPS على المنفذ 443. لا يتم اتباع عمليات إعادة التوجيه ويتم رفض العناوين الخاصة أو المحجوزة، سواء عند الحفظ أو عند كل محاولة. |
| المشروع | مشروع واحد، أو جميع مشاريع المؤسسة (projectId: null). |
| الأحداث | المرشحات: * لكل حدث، مجموعة مثل recording.*، أو نوع واحد مثل room.ended. يتم رفض أي مرشح لا يتطابق مع أي نوع معروف. |
| ممكّن | نقاط النهاية المعطلة لا تتلقى أي شيء. يقوم RTC بتعطيل نقطة النهاية بنفسه عندما تستمر في الفشل (انظر إعادة المحاولة والتعطيل التلقائي). |
| الوصف | تسمية خاصة بك، بحد أقصى 500 حرف. |
يعتمد عدد نقاط النهاية على خطتك. إنشاء نقطة نهاية واحدة أكثر من المحدد في الخطة يسمح بالردود 409 مع الرمز
WEBHOOK_ENDPOINT_LIMIT.
curl --fail-with-body https://api.rtc.champrep.com/v1/webhooks/endpoints \ --header "Authorization: Bearer $RTC_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "url": "https://hooks.example.com/rtc", "description": "Production receiver", "events": ["room.*", "recording.ready"] }'| الطريقة والمسار | النطاق | النتيجة |
|---|---|---|
GET /v1/webhooks/endpoints | webhooks:read | نقاط النهاية، الأحدث أولاً (?projectId, ?limit, ?cursor) |
POST /v1/webhooks/endpoints | webhooks:write | 201، نقطة النهاية وسر التوقيع الخاص بها، يُعرض مرة واحدة |
GET /v1/webhooks/endpoints/{endpointId} | webhooks:read | نقطة نهاية واحدة، مع limit: { used, limit } |
PATCH /v1/webhooks/endpoints/{endpointId} | webhooks:write | تغيير url, description, events أو enabled |
DELETE /v1/webhooks/endpoints/{endpointId} | webhooks:write | { "deleted": true } |
POST /v1/webhooks/endpoints/{endpointId}/rotate-secret | webhooks:write | سر جديد، يُعرض مرة واحدة (التناوب) |
POST /v1/webhooks/endpoints/{endpointId}/test | webhooks:write | يرسل webhook.test الآن ويبلغ عن النتيجة |
POST /v1/webhooks/endpoints/{endpointId}/replay | webhooks:write | 202، إعادة التشغيل الجماعي حسب النطاق الزمني |
GET /v1/webhooks/deliveries | webhooks:read | سجل عمليات التسليم |
GET /v1/webhooks/deliveries/{deliveryId} | webhooks:read | عملية تسليم واحدة، مع كل محاولة |
POST /v1/webhooks/deliveries/{deliveryId}/replay | webhooks:write | 202، يُرسل تلك الرسالة مرة أخرى |
GET /v1/webhooks/event-types | webhooks:read | كتالوج الأحداث |
لا يحتوي كائن نقطة النهاية أبدًا على قيمة سرية. فهو يسرد كل سر نشط
id، باختصار prefix (على سبيل المثال whsec_Ab12), createdAt وأثناء التناوب، expiresAt. كما يقوم أيضًا بالإبلاغ عن status (active أو disabled),
disabledReason (manual, failing, gone أو admin) و health
(consecutiveFailures, lastSuccessAt, lastFailureAt, failingSince).
نقطة نهاية تم إيقاف CHAMPREPدعمها (disabledReason: "admin") لا يمكن تمكينه أو إرسال حدث اختباري إليه (WEBHOOK_ENDPOINT_ADMIN_DISABLED)، ولا يمكن إضافة عنوان URL الخاص بها مرة أخرى كنقطة نهاية جديدة (WEBHOOK_URL_ADMIN_DISABLED). اتصل بالدعم الفني.
تُرجع القوائم مصفوفة JSON. وعند وجود المزيد من العناصر، فإن X-Next-Cursor رأس الاستجابة يحمل المؤشر للصفحة التالية؛ أعده كـ ?cursor.
?limit يقبل من 1 إلى 200.
مساحات العمل التي تم تكوينها باستخدام webhook الفردي السابق (PUT /v1/webhook) احتفظ بها: تظهر الآن كنقطة نهاية لجميع المشاريع وجميع الأحداث، مع وضع علامة
legacy: true، و /v1/webhook تستمر المسارات في العمل.
توقيع الأسرار
Section titled “توقيع الأسرار”يكون شكل السر الخاص بنقطة النهاية الجديدة كما يلي whsec_ متبوعًا بـ base64. يتم عرضه
مرة واحدة، في الرد على طلب الإنشاء أو التناوب، ويقوم RTC بتخزينه مشفرًا. قم بتخزينه في مدير الأسرار الخاص بالمستلم؛ لا يمكن لأحد أن يظهره لك مرة أخرى، بما في ذلك CHAMPREP فريق الدعم. إذا فقدته، فقم بتناوب السر.
لا تقم أبدًا بلصق سر التوقيع في الدردشة أو التذكرة أو السجل. يمكن CHAMPREP AI للمساعد سرد نقاط النهاية وإنشاؤها واختبارها وإعادة تشغيلها نيابة عنك، لكنه لا يرى أو يعرض أي سر أبدًا: احصل على سر من وحدة التحكم (Webhooks، ثم تناوب السر).
تناوب السر دون توقف
Section titled “تناوب السر دون توقف”POST /v1/webhooks/endpoints/{endpointId}/rotate-secret باستخدام
{ "overlapHours": 24 } يُنشئ سرًا جديدًا ويحافظ على صلاحية السرية السابقة خلال فترة التداخل (من 0 إلى 72 ساعة، 24 ساعة بشكل افتراضي). خلال فترة التداخل يتم توقيع كل عملية تسليم باستخدام كل سر نشط، بحيث يمكن للمستلمين التبديل وفقًا لوتيرتهم الخاصة:
- قم بتناوب السر وتخزين السر الجديد بجانب القديم في جهاز الاستقبال الخاص بك.
- قم بنشر مستقبل يقبل أي من السريتين.
- عندما تستخدم كل مثيل السر الجديد، قم بإزالة القديم. يتوقف التوقيع عند انتهاء التداخل (
previousSecretsExpireAt).
الاستخدام overlapHours: 0 عندما لا يستخدم أي مستقبل نقطة النهاية بعد، على سبيل المثال من أجل الحصول على سر لنقطة نهاية أنشأها المساعد الذكي.
غلاف الحدث
Section titled “غلاف الحدث”تستخدم نقاط النهاية الجديدة APIالإصدار 2026-11-01:
{ "id": "0b7c1a52-3d4e-4f5a-9b8c-7d6e5f4a3b2c", "type": "room.ended", "apiVersion": "2026-11-01", "createdAt": "2026-11-08T12:00:00.000Z", "tenantId": "00000000-0000-4000-8000-000000000009", "projectId": "00000000-0000-4000-8000-000000000001", "roomId": "00000000-0000-4000-8000-000000000003", "data": { "roomId": "00000000-0000-4000-8000-000000000003", "endedAt": "2026-11-08T12:00:00.000Z" }}تحتفظ نقطة النهاية القديمة بالمغلف السابق،
{ id, type, createdAt, projectId, data }. نقطة نهاية apiVersion يثبت شكل الحمولة التي يتلقاها؛ انظر إصدارات.
المعرّفات المذكورة أعلاه هي أمثلة توضيحية. تعامل معها id كسلسلة غير شفافة: بعضها عبارة عن معرّفات UUID، وبعضها الآخر مشتق، مثل recording-ready:<uuid>. projectId قد تكون غائبة بالنسبة لحدث على مستوى المؤسسة، و roomId متوفر لأحداث الغرفة.
كتالوج الأحداث
Section titled “كتالوج الأحداث”GET /v1/webhooks/event-types تُرجع القائمة المرجعية، مع تضمين وصف لكل نوع و status: live (أرسل) أو planned (اسم محجوز قد تكون مشتركًا فيه بالفعل؛ لم يتم إرسال أي شيء بعد). لا يتم إرسال بعض الأحداث المباشرة إلا عندما تكون الميزة ذات الصلة ممكّنة في مساحة العمل الخاصة بك.
| الحدث | الحالة | يتم إرسالها عند |
|---|---|---|
room.created | نشط | تم إنشاء غرفة |
room.started | نشط | انضم أول مشارك إلى غرفة |
room.empty | نشط | غادر آخر مشارك غرفة مفتوحة |
room.idle_timeout | نشط | لم يكن هناك أي مشاركين في غرفة مفتوحة خلال فترة الخمول (data.idleSince, data.idleMinutes) |
room.locked | نشط | تم قفل غرفة أو فتحها |
room.ended | نشط | تم إنهاء الغرفة |
participant.joined | نشط | انضم أحد المشاركين إلى غرفة |
participant.left | نشط | غادر أحد المشاركين الغرفة |
participant.updated | نشط | قام أحد المشرفين بتعديل بيانات أحد المشاركين (الدور، الأذونات، الاسم، البيانات الوصفية، كتم صوت المضيف) |
participant.connection_quality | مخطط | تم أخذ عينات من جودة الاتصال (اختياري) |
track.published | نشط | نشر أحد المشاركين مقطعًا |
track.unpublished | نشط | أوقف أحد المشاركين المسار |
track.muted | نشط | قام أحد المشاركين بكتم صوت مسار، أو قام المضيف بكتمه |
track.unmuted | نشط | تم إلغاء كتم صوت مسار |
recording.requested | نشط | تم طلب تسجيل |
recording.started | نشط | بدء التقاط تسجيل |
recording.stopped | نشط | توقف التسجيل، مرة واحدة لكل تسجيل، باستخدام reason (requested, room_ended, max_duration, limit, tenant_inactive, shutdown, allowance عند استنفاد دقائق التسجيل، billing_unavailable أو error) |
recording.ready | نشط | يتم تخزين كل مسار من مسارات التسجيل |
recording.failed | نشط | فشل إنهاء التسجيل (قد يتم الاحتفاظ بالمسارات المسجلة) |
recording.composite.ready | نشط | يتم تخزين ملفات الفيديو والصوت المركبة |
recording.composite.failed | نشط | تعذر إنشاء ملف مركب |
recording.delivered | نشط | تم تسليم ملف التسجيل إلى مساحة التخزين الخاصة بك |
recording.delivery_failed | نشط | تعذر تسليم ملف التسجيل إلى مساحة التخزين الخاصة بك |
recording.deleted | نشط | تم إرسال تسجيل إلى سلة المهملات: data هو { recordingId, roomId, reason, deletedAt, purgeAt }، مع reason customer (قمت بحذفه) أو retention (انتهت مدة الاحتفاظ به)، و purgeAt عندما يتم حذفه تلقائيًا (بعد 30 يومًا؛ يتم تحديد ذلك عند إرساله إلى سلة المهملات، null في حين أن ميزة الحذف التلقائي من سلة المهملات معطلة). يمكن استعادته حتى ذلك الحين. |
recording.restored | نشط | تمت استعادة تسجيل من سلة المهملات: data هو { recordingId, roomId, restoredAt, by }، مع by customer أو admin |
recording.purged | نشط | تم حذف التسجيل نهائيًا من سلة المهملات: data هي { recordingId, roomId, reason, purgedAt }، مع reason customer (قمت بحذفه من سلة المهملات)، expired (يتم حذفه تلقائيًا بعد 30 يومًا) أو admin (CHAMPREPالدعم) |
transcript.queued | نشط | تم حجز دقائق نص التسجيل ووضعه في قائمة الانتظار: data هي { recordingId, roomId, reservedMinutes } (النسخ) |
transcript.completed | نشط | نص التسجيل جاهز: data هي { recordingId, roomId, segments, durationMs, billedMinutes, truncated }، مع truncated true عندما نفد الحجم المخصص أثناء التداخل الشديد. لا يُذكر النص أبدًا. |
transcript.failed | نشط | فشل نسخ التسجيل ولم يتم فرض أي رسوم: data هي { recordingId, roomId, error }، بالإضافة إلى code (RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE, CANCELLED أو RECORDING_LENGTH_UNKNOWN) و offers عندما يكون الحد المسموح به هو السبب |
transcript.segment | مخطط | غير متاح للعملاء بعد (التعليقات المباشرة) |
captions.started | مخطط | غير متاح للعملاء حتى الآن |
captions.stopped | مخطط | غير متاح للعملاء حتى الآن |
whiteboard.created | نشط | تم إنشاء لوحة بيضاء في غرفة |
whiteboard.archived | نشط | تم أرشفة أو حذف لوحة بيضاء |
whiteboard.opened, whiteboard.closed, whiteboard.snapshot.ready | مخطط | نشاط السبورة البيضاء |
key.created | نشط | تم إنشاء مفتاحAPI |
key.revoked | نشط | تم إلغاء مفتاحAPI |
quota.warning | نشط | تجاوزت حصة RTC نسبة التحذير (80% ما لم تحددCHAMPREP نسبًا أخرى)؛ مرة واحدة لكل حصة وفترة فوترة ونسبة مئوية |
quota.exhausted | نشط | يتم استنفاد رصيد RTC (الاشتراك، الفترة التجريبية والحزم)؛ مرة واحدة لكل رصيد وفترة فوترة |
subscription.changed | مخطط | تغير اشتراك RTC (المستوى، الفترة التجريبية، مشكلة في الدفع) |
webhook.test | نشط | حدث اختباري مرسل من وحدة التحكم أو من API |
webhook.endpoint_disabled | نشط | تم تعطيل إحدى نقاط النهاية الخاصة بك بعد الفشل أو الرد 410: data هو { endpointId, url, host, reason }. url هي المخطط والمضيف والمسار فقط، وليست أبدًا سلسلة الاستعلام؛ host هو المضيف بحد ذاته؛ reason هو failing أو gone. |
egress.started, egress.ended, ingress.started, ingress.ended | مخطط | البث والاستيعاب (غير متاح بعد) |
تحمل الأحداث معرّفات، وليس أسماء العرض أو الرموز المميزة أو عناوين IP أو الوسائط. قم بمطابقة الحالة المهمة مع APIبدلاً من الاعتماد على حدث واحد.
التحقق من كل طلب
Section titled “التحقق من كل طلب”يحتوي كل تسليم على نظامي توقيع مستقلين. تحقق واحد من الأسرار، عبر بايت نص الطلب الخام الدقيق، قبل تحليل JSON أو تنفيذ الإجراء. لا تقم أبدًا بتحليل النص الأساسي وإعادة تسلسله للتحقق.
X-RTC-Timestamp: 1794139200X-RTC-Signature: v1=<hex>X-RTC-Signatures: v1=<hex> v1=<hex>webhook-id: 0b7c1a52-3d4e-4f5a-9b8c-7d6e5f4a3b2cwebhook-timestamp: 1794139200webhook-signature: v1,<base64> v1,<base64>| المخطط | المحتوى الموقّع | مفتاح HMAC-SHA256 | التوقيع |
|---|---|---|---|
| Webhooks القياسية (موصى به) | <webhook-id>.<webhook-timestamp>.<raw body> | whsec_… الأسرار: الجزء الذي تم فك تشفيره باستخدام base64 بعد whsec_ البادئة. الأسرار القديمة التي تم ترحيلها rtc_… الأسرار: بايتات UTF-8 للسر بأكمله | webhook-signature: مفصولة بمسافات v1,<base64>، واحد لكل سر نشط |
| RTC (قديم) | <X-RTC-Timestamp>.<raw body> | بايتات UTF-8 لسلسلة السر بأكملها، بما في ذلك أي whsec_ أو rtc_ البادئة | X-RTC-Signature: v1=<hex> للسر الأحدث؛ X-RTC-Signatures: كل سر نشط، مفصول بمسافة |
بالنسبة لكلا النظامين:
- ارفض أي طابع زمني يزيد عن خمس دقائق عن ساعتك.
- قارن التوقيعات في وقت ثابت، وقبل الطلب عندما أي التوقيع المدرج يطابق أحد أسرارك.
- أثناء تداخل الدوران,
X-RTC-Signatureيحمل فقط السر الأحدث. يجب على جهاز الاستقبال القديم الذي لا يزال يحتفظ بالسر السابق التحقق منX-RTC-Signatures. - تقبل مكتبات Webhooks القياسية الجاهزة
whsec_الأسرار مباشرةً. بالنسبة إلى نقطة النهاية التي تم ترحيلهاrtc_…السر، قم بتزويد المكتبةwhsec_متبوعًا بـ ترميز base64 لبايتات UTF-8 الخاصة بالسر بأكمله.
Node.js
Section titled “Node.js”الـ مثال على التحقق يُنفذ كلا النظامين دون تبعيات:
import { verifyStandardWebhook, verifyRtcWebhook } from './verify-webhook.mjs';
// rawBody: the Buffer captured before any JSON middleware.const valid = verifyStandardWebhook({ rawBody, id: request.headers['webhook-id'], timestamp: request.headers['webhook-timestamp'], signature: request.headers['webhook-signature'], secret: process.env.RTC_WEBHOOK_SECRET,}) || verifyRtcWebhook({ rawBody, timestamp: request.headers['x-rtc-timestamp'], signatures: request.headers['x-rtc-signatures'], signature: request.headers['x-rtc-signature'], secret: process.env.RTC_WEBHOOK_SECRET,});if (!valid) return rejectWebhook(); // 401, without applying the eventconst event = JSON.parse(rawBody.toString('utf8'));// Validate the envelope, then atomically deduplicate event.id in durable storage.أثناء عملية التناوب، اتصل بالمدقق مرة واحدة لكل سر تحتفظ به.
Python
Section titled “Python”import base64import hashlibimport hmacimport reimport time
TOLERANCE_SECONDS = 300
def _fresh(timestamp, now=None): if not timestamp or not re.fullmatch(r"[0-9]{1,12}", timestamp): return False return abs((now or time.time()) - int(timestamp)) <= TOLERANCE_SECONDS
def _any_match(expected, header, prefix): entries = header.split(" ") if header else [] matched = False for entry in entries[:16]: if entry.startswith(prefix) and hmac.compare_digest(entry[len(prefix):], expected): matched = True return matched
def standard_webhook_key(secret): """whsec_ secrets: the base64 part after the prefix. Legacy rtc_ secrets: the whole secret.""" if secret.startswith("whsec_"): return base64.b64decode(secret[len("whsec_"):], validate=True) return secret.encode("utf-8")
def verify_standard_webhook(raw_body: bytes, headers, secret: str) -> bool: msg_id = headers.get("webhook-id") timestamp = headers.get("webhook-timestamp") if not msg_id or not _fresh(timestamp): return False signed = f"{msg_id}.{timestamp}.".encode() + raw_body digest = hmac.new(standard_webhook_key(secret), signed, hashlib.sha256).digest() return _any_match(base64.b64encode(digest).decode(), headers.get("webhook-signature"), "v1,")
def verify_rtc_webhook(raw_body: bytes, headers, secret: str) -> bool: timestamp = headers.get("x-rtc-timestamp") if not _fresh(timestamp): return False signed = timestamp.encode() + b"." + raw_body digest = hmac.new(secret.encode("utf-8"), signed, hashlib.sha256).hexdigest() header = headers.get("x-rtc-signatures") or headers.get("x-rtc-signature") return _any_match(digest, header, "v1=")headers يجب أن يكون التعيين غير حساس لحالة الأحرف، مثل request.headers في Flask أو Django أو Starlette، و raw_body النص الأساسي غير المُحلل (request.get_data() في Flask، request.body في Django، await request.body()
في Starlette).
هذه الأمثلة هي إرشادات لتكامل المستقبل، وليست خوادم كاملة. قم بتعيين حد لنص الطلب، وتعامل مع JSON غير الصحيح، وتحقق من صحة الغلاف.
الاستجابة وإزالة التكرار والترتيب
Section titled “الاستجابة وإزالة التكرار والترتيب”إرجاع 2xx الاستجابة على الفور بعد القبول الدائم لحدث تم التحقق منه، و القيام بالأعمال الأطول بشكل غير متزامن. تنتهي صلاحية كل محاولة بعد 5 ثوانٍ. أي حالة أخرى، أو إعادة توجيه، أو انتهاء المهلة تُعتبر محاولة فاشلة.
الاستمرار event.id بشكل متكامل ومعالجة كل حدث مرة واحدة؛ فالمجموعة الموجودة في الذاكرة لا تكفي عبر عمليات إعادة التشغيل أو عدة مثيلات للمستقبل. فالتحقق من الطابع الزمني بمفرده لا يمنع إعادة التشغيل ضمن النافذة المقبولة. الترتيب غير مضمون: استخدم الطوابع الزمنية في data و APIلحل الحالة الحالية.
إعادة المحاولة والتعطيل التلقائي
Section titled “إعادة المحاولة والتعطيل التلقائي”يتم إعادة محاولة التسليم الفاشل باستخدام التراجع الأسي والتذبذب لمدة حوالي 24 ساعة (12 محاولة)، ثم يتم وضع علامة dead. يتم توقيع كل محاولة من جديد باستخدام الأسرار السارية لنقطة النهاية وطابع زمني جديد.
تنتهي كل محاولة بعد 5 ثوانٍ. يقوم RTC بتعطيل نقطة نهاية (disabledReason: "failing") عندما يتحقق أي من الشرطين التاليين:
- انتهت مهلة الانتظار 25 مرة متتالية، كما استمر الفشل لمدة ساعة على الأقل؛
- استمرت المحاولات في الفشل لمدة 24 ساعة (CHAMPREPيمكن تحديد فترة أخرى).
ويتم تعطيلها على الفور ("gone") عندما تستجيب 410 Gone. يتم إخطار مالك المؤسسة، و webhook.endpoint_disabled يتم إرسال الحدث إلى نقاط النهاية الأخرى الخاصة بك. قم بإصلاح جهاز الاستقبال، ثم قم بتمكين نقطة النهاية مرة أخرى (PATCH مع { "enabled": true })؛ يؤدي التمكين إلى مسح حالة الفشل الخاصة به.
الاختبار وسجل التسليم وإعادة التشغيل
Section titled “الاختبار وسجل التسليم وإعادة التشغيل”- اختبار:
POST /v1/webhooks/endpoints/{endpointId}/testيرسلwebhook.testالحدث على الفور والإجابات{ deliveryId, eventId, ok, status, latencyMs, error }. - سجل التسليم:
GET /v1/webhooks/deliveriesتسرد عمليات التسليم، الأحدث أولاً، معstate(pending,retry,delivered,dead,cancelled),attempts,lastStatus,lastErrorوlastLatencyMs. قم بالتصفية باستخدام?endpointId,?state,?typeو?eventId. عملية تسليم واحدة (GET /v1/webhooks/deliveries/{deliveryId}) يضيف كل محاولة مع حالتها، وزمن الاستجابة، وأول 1 كيلوبايت من استجابة جهاز الاستقبال الخاص بك، و الحدث نفسه. يتم الاحتفاظ بالسجل لفترة محدودة. - إعادة التشغيل الأولى:
POST /v1/webhooks/deliveries/{deliveryId}/replayضع التسليم في قائمة الانتظار مرة أخرى. عدد عمليات إعادة التشغيل لكل عملية تسليم ولكل يوم محدود (REPLAY_LIMIT,REPLAY_QUOTA)؛ يتم إرسال إجابة عند إتمام التسليمDELIVERY_IN_PROGRESS. - إعادة التشغيل الجماعي:
POST /v1/webhooks/endpoints/{endpointId}/replayمع{ "from": "2026-11-08T00:00:00Z", "to": "2026-11-08T06:00:00Z", "types": ["recording.*"], "onlyFailed": true }تُدرج الأحداث المطابقة لتلك الفترة الزمنية لنقطة النهاية، بحد أقصى 1000 لكل طلب، وتُقدم الإجابات202 { "queued": n }.
استكشاف الأخطاء وإصلاحها
Section titled “استكشاف الأخطاء وإصلاحها”- أرسل حدثًا تجريبيًّا واقرأ
statusوerror. - اقرأ سجل التسليم
lastStatusومقتطف استجابة المحاولة. - تأكد من التحقق من البايتات الأولية باستخدام المفتاح الصحيح للنظام (الجزء الذي تم فك تشفيره
whsec_الجزء الخاص بـ Standard Webhooks، والسلسلة بأكملها لـX-RTC-Signature). - تحقق من انحراف التوقيت، وعمليات إعادة التوجيه، ومن أن نقطة النهاية ممكّنة.
لا تقم أبدًا بتسجيل سر التوقيع أو الطلبات الأولية التي تحمل التوقيع أو بيانات اعتماد المشاركين أثناء استكشاف الأخطاء وإصلاحها.