iOS Live Activity API لكل ما يتحدث HTTP

ما هي Live Activity؟

Live Activity هي ميزة في iOS تعرض معلومات حية يمكن قراءتها بلمحة على Lock Screen وفي Dynamic Island وفي StandBy — دون أن يفتح المستلم أي تطبيق. وخلافًا لإشعار الدفع الذي يظهر مرة واحدة ثم يضيع في القائمة، تبقى Live Activity مثبّتة وتتحدّث في الوقت الفعلي: عملية بناء تتقدّم عبر خطواتها، مؤقّت يعدّ تنازليًا، طلب توصيل يقترب. PushWard يحوّل طلب HTTP واحدًا إلى ذلك بالضبط.

كيف تعمل الواجهة البرمجية

أنشئ نشاطًا وابدأه وحدّثه وأنهِه — كل ذلك عبر REST API من PushWard باستخدام مفتاح التكامل الخاص بك. أي خدمة قادرة على إرسال طلب HTTP يمكنها التحكم فيما يراه الناس بلمحة. لا شهادات APNs ولا كود عميل تكتبه؛ إذ يتولى PushWard التسليم عبر Apple Push Notification service.

# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "deploy", "name": "Deploy to production" }'

# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ongoing", "content": {
    "template": "generic", "progress": 0.2,
    "state": "Building...", "accent_color": "cyan"
  } }'

# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ended", "content": {
    "template": "generic", "progress": 1, "state": "Deployed"
  } }'

قالب لكل نوع من التحديثات

اختر من قوالب Live Activity المصممة لمهام مختلفة — شريط تقدم عام، عدّ تنازلي، تسلسل خطوات، تنبيه، مقياس، مخطط sparkline زمني، لوحة بلاطات، أو سجل أحداث مباشر. لكل منها تخطيط مضبوط لـ Lock Screen و Dynamic Island.

تصفّح القوالب →

يعمل مع منظومتك

أرسل Live Activities مباشرة من الأدوات التي تشغّلها بالفعل. جسور جاهزة و relay مُستضاف للـ webhooks تغطي تنبيهات Grafana وأتمتة Home Assistant و GitHub Actions وتنزيلات SABnzbd وطباعات Bambu Lab ومزامنات ArgoCD وأي شيء آخر يمكنه إرسال JSON.

شاهد كل التكاملات →

جرّب iOS Live Activity API

شاهد Live Activity تصل إلى iPhone محاكى في الـ playground، أو اقرأ دليل البدء وأرسل أول واحدة باستخدام curl خلال دقائق.