curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
وظائف webhook للعملاء المحتملين
إنشاء وظيفة webhook لقائمة عملاء محتملين
POST /lead//webhook/
POST
/
lead
/
{lead_id}
/
webhook
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
يضيف وظيفة webhook إلى قائمة عملاء محتملين، تُستدعى بحمولة الإدخال عند كل إرسال جديد للنموذج.
يُعاد
يُعاد
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_WEBHOOK_CAN_ADD، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
lead_id لقائمة العملاء المحتملين.string
مطلوب
عنوان URL المستهدف لوظيفة webhook، حتى 500 حرف.
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
403 إذا استُنفدت حصة وظائف webhook لكل قائمة عملاء محتملين الخاصة بخطة الحساب:
403
{ "detail": "You have exhausted your limit of 5 webhooks.", "limit": 5 }
404 إذا لم يكن lead_id يملكه هذا الحساب.
ذو صلة
- سرد وظائف webhook لقائمة عملاء محتملين — رؤية ما هو مُهيَّأ بالفعل.
- تحديث وظيفة webhook لقائمة عملاء محتملين — تغيير عنوان URL لوظيفة webhook.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
201
Webhook created.
هل كانت هذه الصفحة مفيدة؟