REST API

أدِر مهام cron برمجيًا بصيغة JSON.

المصادقة

أنشئ مفتاحًا من الحساب › مفتاح API وأرسله في الترويسة Authorization: Bearer (أو X-API-Key).

curl -H "Authorization: Bearer 7c_xxxxxxxx…" https://7cron.com/api/v1/me

الحد: 120 طلبًا في الدقيقة. التواريخ بتوقيت UTC (ISO 8601). قد يكون الوصول إلى API خيارًا حسب خطتك.

نقاط الوصول

GET /meحسابك وحدودك
GET /jobsعرض مهامك
POST /jobsإنشاء مهمة (HTTP أو نبض الحياة)
GET /jobs/{id}تفاصيل المهمة
PATCH /jobs/{id}تعديل مهمة (الحقول المرسلة فقط)
DELETE /jobs/{id}حذف مهمة وسجلها
POST /jobs/{id}/runتشغيل مهمة HTTP الآن
POST /jobs/{id}/pauseإيقاف مهمة مؤقتًا
POST /jobs/{id}/resumeاستئناف مهمة
GET /jobs/{id}/logs?limit=50آخر عمليات التنفيذ (500 كحد أقصى)

Base URL : https://7cron.com/api/v1

مثال والحقول

الحقول والقواعد نفسها كما في نموذج الويب:

curl -X POST https://7cron.com/api/v1/jobs \
  -H "Authorization: Bearer 7c_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{"name":"Nightly backup","url":"https://example.com/cron/backup",
       "method":"POST","cron_expr":"0 3 * * *","timezone":"Europe/Zurich",
       "timeout":30,"retries":1,"alert_threshold":3,"success_keyword":"OK"}'

# Heartbeat
curl -X POST https://7cron.com/api/v1/jobs -H "Authorization: Bearer 7c_…" -H "Content-Type: application/json" \
  -d '{"type":"heartbeat","name":"Backup script","hb_period_min":1440,"hb_grace_min":30}'

type, name, url, method, headers, body, cron_expr, timezone, timeout, enabled, notify_on_failure, notify_chat, alert_threshold, webhook_url, success_keyword, keyword_mode (contains|absent), retries, hb_period_min, hb_grace_min, on_status_page

الأخطاء

{"error": {"code": 422, "message": "Validation failed.", "fields": {"cron_expr": "…"}}}

الرموز: 400 JSON غير صالح، 401 المفتاح مفقود، 403 غير مسموح، 404 غير موجود، 405 الطريقة، 422 التحقق، 429 تجاوز الحد.