حذف رابط Webhook

إزالة رابط Webhook مخصص من نسخة الواتساب. لا يمكن حذف رابط Webhook الخاص بالنظام. (للمشتركين فقط)

DELETE

https://api.wawp.net/v2/webhook/delete?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID&url=https%3A%2F%2Fmy-app.com%2Fwebhook

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/webhook/delete

يدعم

DELETE

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

متطلب الاشتراك المدفوع

يجب أن تكون مشتركاً بأي باقة مدفوعة لتتمكن من إدارة Webhooks عبر API.

حماية Webhook النظام

لا يمكن حذف رابط Webhook الخاص بالنظام. استخدم التعطيل إذا كنت تريد إيقاف أحداث النظام مؤقتاً.

توصيات

تحقق جيداً من الرابط قبل الحذف لتجنب إزالة تكامل نشط بالخطأ.
إذا كنت تحتاج فقط لإيقاف التوصيل، فكر في تعطيل الرابط عبر /v2/webhook/update بدلاً من حذفه.
بعد الحذف، تأكد من قائمة الروابط المتبقية باستخدام /v2/session/webhook (GET).

حذف رابط Webhook: /v2/webhook/delete

تزيل نقطة النهاية /v2/webhook/delete رابط Webhook مخصص واحد من النسخة. Webhook النظام (https://app.wawp.net/api/webhook/{token}) محمي ولا يمكن حذفه؛ استخدم /v2/webhook/update لتعطيله بدلاً من ذلك.

[!IMPORTANT] هذه الميزة متاحة حصرياً للمشتركين في الباقات المدفوعة (Unlimited). محاولة الوصول إليها من حساب مجاني ستُرجع خطأ 403 Forbidden مع رمز subscription_required.

🎯 متى تستخدم هذه النقطة؟

استخدم هذه النقطة عندما تريد:

إزالة رابط Webhook مخصص لم يعد مطلوباً.
تنظيف الروابط القديمة أو المعطلة التي تستمر في فشل التوصيل.
فصل تكامل خارجي دون إعادة تعيين قائمة الروابط بالكامل.

📦 معاملات الطلب

url (مطلوب): رابط Webhook المخصص المطلوب إزالته بالضبط. يمكن إرساله في جسم الطلب أو كباراميتر في الرابط (query).
instance_id و access_token: بيانات الاعتماد المطلوبة، يمكن إرسالها في الجسم أو في الرابط.

📡 عينات الطلبات

cURL (جسم الطلب)

curl -X DELETE "https://api.wawp.net/v2/webhook/delete"   -H "Content-Type: application/json"   -d '{
    "access_token": "YOUR_ACCESS_TOKEN",
    "instance_id": "Your_Instance_ID",
    "url": "https://my-app.com/webhook"
  }'

cURL (باراميتر في الرابط)

curl -X DELETE "https://api.wawp.net/v2/webhook/delete?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID&url=https%3A%2F%2Fmy-app.com%2Fwebhook"

JavaScript (Fetch)

const res = await fetch('https://api.wawp.net/v2/webhook/delete', {
  method: 'DELETE',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    access_token: 'YOUR_ACCESS_TOKEN',
    instance_id: 'Your_Instance_ID',
    url: 'https://my-app.com/webhook'
  })
});
const data = await res.json();
console.log(data);

🛡️ حماية Webhook النظام

يحافظ المحرك على Webhook نظام واحد لمزامنة الصندوق الوارد، والإشعارات، والأتمتة. إذا حاولت حذف هذا الرابط، ستُرجع API رمز الخطأ system_webhook_protected مع HTTP 400.

لإيقاف استقبال أحداث النظام، يمكنك إما:

تعيين is_active إلى 0 عبر /v2/webhook/update.
إزالة جميع الأحداث من قائمة أحداث Webhook النظام.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		معرف النسخة الفريد مثال:
	`string`		مفتاح الوصول الخاص بك مثال:
	`string`		رابط Webhook المخصص المطلوب إزالته بالضبط مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/webhook/delete";
3const params = new URLSearchParams({
4  "instance_id": "Your_Instance_ID",
5  "access_token": "YOUR_ACCESS_TOKEN",
6  "url": "https://my-app.com/webhook"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11  method: "DELETE",
12  headers: { "Content-Type": "application/json" },
13  
14})
15  .then(async (response) => {
16    if (response.ok) {
17      const data = await response.json();
18      console.log("Success:", data);
19      return data;
20    }
21    
22    // Error Handling
23    if (response.status === 400) {
24      console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
25    }
26    if (response.status === 400) {
27      console.error("Error 400: طلب غير صالح (تنسيق XML)");
28    }
29    if (response.status === 400) {
30      console.error("Error 400: طلب غير صالح (نص عادي)");
31    }
32    if (response.status === 401) {
33      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
34    }
35    if (response.status === 401) {
36      console.error("Error 401: غير مصرح (تنسيق XML)");
37    }
38    if (response.status === 404) {
39      console.error("Error 404: غير موجود - الجلسة غير موجودة");
40    }
41    if (response.status === 404) {
42      console.error("Error 404: غير موجود (تنسيق XML)");
43    }
44    if (response.status === 500) {
45      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
46    }
47    if (response.status === 500) {
48      console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
49    }
50    if (response.status === 502) {
51      console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
52    }
53    if (response.status === 502) {
54      console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
55    }
56
57    const errorText = await response.text();
58    console.error(`Error ${response.status}: ${errorText}`);
59  })
60  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 60, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Success - Webhook Deleted

3 نسخ

النوع:

application/json

string *

object *

Example

{
"status": "success",
"message": "Webhook deleted successfully.",
"removed": {
  "url": "https://my-app.com/webhook",
  "events": {
    "0": "message",
    "1": "message.ack"
    },
  "is_active": 1,
  "enabled": true,
  "retries": {
    "delay": 2,
    "attempts": 15
    }
  }
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

غير مصرح - مفتاح الوصول غير صالح أو مفقود

2 نسخ

Command Palette

Search for a command to run...