# Cron والمجدول
SUMMARY: جدولة استدعاءات API المتكررة — مهام cron تعمل وفق جدول، مثالية للمزامنة الدورية والتذكيرات.

KEY CONTEXT:
Auth: Mind Key
Create: POST /cron { schedule, endpoint, method?, body?, headers?, enabled? }
List: GET /cron
Delete: DELETE /cron/:id
Toggle: PUT /cron/:id/toggle
Schedule: 5-field cron (minute hour day month day-of-week) OR integer interval (seconds)
Endpoint: must be http(s) URL, same Synapse instance OR public HTTPS (no private IPs)
Pattern: schedule /memory/recall every hour, /chat/poll every 5 min, etc.

Cron والمجدول
تتيح لك Cron API جدولة استدعاءات HTTP متكررة لنقاط نهاية Synapse (أو
نقاط نهاية HTTPS خارجية). مثالية للمزامنة الدورية والتذكيرات ومهام الصيانة.
نقاط النهاية
POST /cron
إنشاء مهمة مجدولة.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
GET /cron
قائمة بجميع المهام المجدولة.
[CODE BLOCK]
DELETE /cron/:id
حذف مهمة مجدولة.
[CODE BLOCK]
PUT /cron/:id/toggle
تمكين أو تعطيل مهمة دون حذفها.
[CODE BLOCK]
صيغة الجدولة
Cron القياسي (5 حقول)
[CODE BLOCK]
أمثلة:
| الجدول | المعنى |
|----------|---------|
|  | كل ساعة |
|  | كل 15 دقيقة |
|  | أيام الأسبوع الساعة 9 صباحًا |
|  | كل أحد منتصف الليل |
|  | أول كل شهر منتصف الليل |
فترة زمنية صحيحة (ثوانٍ)
للفترات البسيطة، مرّر عددًا صحيحًا:
[CODE BLOCK]
قيود نقطة النهاية
> [!WARNING]
> يجب أن تكون نقاط النهاية عناوين URL تبدأ بـ  أو  تشير إلى:
> - نفس نسخة Synapse (مثل )
> - عناوين URL HTTPS عامة (لا عناوين IP خاصة، لا localhost، لا عناوين IP للبيانات الوصفية)
هذا يمنع هجمات SSRF حيث يمكن لعقل مخترق جدولة طلبات إلى
خدمات داخلية.
الأنماط الشائعة
استدعاء الذاكرة كل ساعة (لوكلاء LLM)
[CODE BLOCK]
نسخ احتياطي يومي
[CODE BLOCK]
استطلاع الدردشة الدوري (كل 5 دقائق)
[CODE BLOCK]
مُحفّز التقرير الأسبوعي
[CODE BLOCK]
الخطوات التالية
- Variables API
- Webhooks API