الأحداث
تستقبل خطافات الويب لديك 60 نوعًا من الأحداث حين يتغيّر شيء في مؤسستك. اشترك في أنواع محددة أو في أقنعة مثل card.*.
البطاقات
- card.archivedأُرشفت بطاقة
- card.createdأُنشئت بطاقة
- card.deletedحُذفت بطاقة
- card.index_failedفشلت فهرسة بطاقة
- card.indexedفُهرست بطاقة
- card.movedنُقلت بطاقة
- card.publishedنُشرت مسودة بوصفها بطاقة جديدة
- card.restoredاستُعيدت بطاقة
- card.updatedعُدِّلت بطاقة
التوثيق
- card.unverifiedسُحبت الثقة من بطاقة
- card.verifiedوُثّقت بطاقة
- verification.expiredانتهت صلاحية التوثيق
- verification.requestedطُلب التوثيق
المجموعات والمجلدات
- collection.createdأُنشئت مجموعة
- collection.deletedحُذفت مجموعة
- collection.updatedعُدِّلت مجموعة
- folder.createdأُنشئ مجلد
- folder.deletedحُذف مجلد
- folder.updatedعُدِّل مجلد
التعاون
- announcement.readقُرئ إعلان
- announcement.sentأُرسل إعلان
- comment.createdأُضيف تعليق
- comment.resolvedأُغلقت سلسلة تعليقات
- draft.approvedاعتُمدت مسودة
- draft.createdأُنشئت مسودة
- draft.publish_requestedطُلب اعتماد النشر
الأسئلة والإجابات
- access_request.createdطُلب وصول
- access_request.resolvedبُتّ في طلب وصول
- gap.detectedاكتُشفت ثغرة معرفية
- question.answeredأُجيب عن سؤال
- question.feedback_createdقُيِّمت إجابة
- question.unansweredلم يُجَب عن سؤال
الأشخاص والوصول
- api_key.createdأُنشئ مفتاح API
- api_key.expiringاقترب انتهاء صلاحية مفتاح API
- api_key.revokedأُبطل مفتاح API
- app.authorizedخُوِّل تطبيق
- app.revokedأُبطل تخويل تطبيق
- group.createdأُنشئت مجموعة مستخدمين
- group.deletedحُذفت مجموعة مستخدمين
- group.member_addedأُضيف عضو إلى مجموعة مستخدمين
- group.member_removedأُزيل عضو من مجموعة مستخدمين
- group.updatedعُدِّلت مجموعة مستخدمين
- user.createdأُنشئ مستخدم
- user.deactivatedعُطِّل مستخدم
- user.offboardedأُخرج مستخدم من المؤسسة
- user.updatedعُدِّل مستخدم
المصادر والاستيراد
- import.document_failedفشل استيراد مستند
- import.sync_completedاكتملت مزامنة استيراد
- source.connection_lostانقطع اتصال مصدر
- source.sync_completedاكتملت مزامنة مصدر
- source.sync_failedفشلت مزامنة مصدر
مهام المعالجة والتصدير
- export.readyجُهِّز تصدير
- job.completedاكتملت مهمة معالجة
- job.failedفشلت مهمة معالجة
الفوترة
- credits.lowالرصيد منخفض
- invoice.issuedأُصدرت فاتورة
- invoice.paidدُفعت فاتورة
- subscription.updatedعُدِّل الاشتراك
أحداث خدمة خطافات الويب
- webhook.endpoint_disabledعُطِّل خطاف ويب
- webhook.pingحدث تجريبي
استقبال الأحداث
كل تسليم هو طلب POST بنص JSON كهذا إلى عنوان خطاف الويب لديك. تحقّق من الترويسة webhook-signature (Standard Webhooks) قبل أن تثق بالنص، وأجب بحالة 2xx خلال ثوانٍ قليلة، ثم نفّذ العمل بعد ذلك. تحافظ التسليمات إلى خطاف ويب واحد على ترتيب الأحداث، ويُعاد التسليم الفاشل بفواصل زمنية متزايدة.
قد تظهر أنواع أحداث جديدة وحقول جديدة في أي وقت: تجاهل الأنواع والحقول التي لا تعرفها.