انتقل إلى المحتوى
Wbiztool

API التذكيرات

API إلغاء تذكير

أوقف تذكيرًا متكررًا حتى لا يُشغَّل مرة أخرى أبدًا. استخدمه عندما يدفع العميل، أو ينتهي اشتراك، أو لم تعد هناك حاجة إلى عملية أتمتة.

POSThttps://wbiztool.com/api/v1/reminder/cancel/

النص (Body): JSON أو حقول نموذج

تحتاج إلى قيمة reminder_id التي يُرجعها إنشاء تذكير. إذا لم تكن لديك، فاعثر عليها باستخدام عرض التذكيرات.

مثال سريع#

curl -X POST https://wbiztool.com/api/v1/reminder/cancel/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "reminder_id": "3187"
  }'

استبدل 12345 وYOUR_API_KEY بقيمك الخاصة. راجع المصادقة لمعرفة مكان العثور عليها.

معاملات الطلب#

client_idintegerمطلوب

معرّف العميل في API ‏(API Client ID) من Settings → API keys (الإعدادات ← مفاتيح API).

api_keystringمطلوب

مفتاح API الخاص بك من الصفحة نفسها.

reminder_idstringمطلوب

معرّف التذكير المراد إلغاؤه، كما يُرجعه إنشاء تذكير أو عرض التذكيرات. يجب أن ينتمي إلى مساحة العمل نفسها التي ينتمي إليها مفتاح API.

إرسال حقول النموذج يتجنب هذه المشكلة، لأن كل قيمة في النموذج نص:

curl -X POST https://wbiztool.com/api/v1/reminder/cancel/ \
  -d client_id=12345 \
  -d api_key=YOUR_API_KEY \
  -d reminder_id=3187

الاستجابة#

يُرجع الطلب الناجح HTTP 200:

{
  "message": "Reminder cancelled successfully",
  "status": 1
}
الحقلالنوعالوصف
statusinteger‏1 إذا أُلغي التذكير، و0 إذا فشل الطلب.
messagestring‏Reminder cancelled successfully، وإلا نص الخطأ.

الأخطاء#

تُرجع الأخطاء HTTP 400 مع status بقيمة 0، ما لم يُذكر خلاف ذلك:

{ "status": 0, "message": "Reminder not found" }
الرسالةطريقة الإصلاح
Invalid JSON format: …جسم JSON غير صالح. تحصل على هذا الخطأ أيضًا مع طلب نموذج بدون client_id، أو مع أي طلب GET.
Reminder ID cannot be nullأضف reminder_id.
Auth Error - Please send correct API key and Client idأرسل client_id وapi_key كليهما.
Invalid client idأرسل client_id كرقم.
Invalid reminder idيجب أن تكون قيمة reminder_id عددًا صحيحًا، مثل 3187.
Auth Error: invalid api keyالمفتاح ينتمي إلى client_id مختلف.
Auth Error: please check client idالمفتاح غير مرتبط بمساحة عمل. أنشئ مفتاحًا جديدًا في مساحة العمل التي تريد استخدامها.
Demo Account cannot access APIsاستخدم حسابًا عاديًا.
Upgrade your plan to use reminders featureباقتك لا تتضمن التذكيرات. تستمر التذكيرات التي أُنشئت سابقًا في العمل واستهلاك الرصيد، ولا يمكن إلغاؤها أو إيقافها مؤقتًا، لا عبر API ولا من لوحة التحكم، حتى تقوم بالترقية.
Reminder not found ‏(HTTP 404)المعرّف غير موجود، أو موجود في مساحة عمل أخرى، أو أن التذكير أُلغي بالفعل.
Error cancelling reminder: … ‏(HTTP 500)حدث خطأ من جانبنا. حاول مرة أخرى.

إذا كان api_key غير موجود أو حُذف، فستكون الاستجابة صفحة خطأ بصيغة HTML مع HTTP 500 بدلًا من JSON. اختبر مفتاحك باستخدام التحقق من بيانات الاعتماد.

ماذا يفعل الإلغاء#

  • يتوقف التذكير فورًا ولن يُشغَّل مرة أخرى. ويمكن إلغاء التذكيرات الموقوفة مؤقتًا أيضًا.
  • يختفي من عرض التذكيرات ومن صفحة التذكيرات.
  • لا يمكن استعادة التذكير الملغى. للبدء من جديد، أنشئ تذكيرًا جديدًا.
  • الرسالة التي وضعها التذكير في قائمة الانتظار قبل إلغائه لا تُحذف، وقد تُرسَل رغم ذلك.

نصائح#

  • الإلغاء مرتين يُرجع Reminder not found. إذا كنت تعيد محاولة الطلبات، فاعتبر هذه الرسالة بمعنى «أُلغي بالفعل».
  • الإيقاف المؤقت غير متاح عبر API. لإيقاف تذكير مؤقتًا، أوقفه من صفحة التذكيرات بدلًا من ذلك.
  • تغيير الجدول الزمني: لا يوجد API للتحديث. ألغِ التذكير وأنشئ تذكيرًا جديدًا بقيمة cron_expression الجديدة.