API الأنشطة المباشرة في iOS لكل ما يتحدث HTTP

PushWard هو API لأنشطة Apple المباشرة: أرسل طلب HTTP واحدًا فيظهر مباشرة على شاشة القفل وفي Dynamic Island على iPhone، ويتحدّث في الوقت الفعلي ويختفي من تلقاء نفسه عند انتهاء المهمة. لا كود ActivityKit، ولا Xcode، ولا مراجعة App Store من جانبك.

ما هو النشاط المباشر؟

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

أنشطة Apple المباشرة، من دون ActivityKit

الأنشطة المباشرة ميزة iOS من Apple ظهرت في iOS 16.1: أسطح تُقرأ بلمحة وتتحدّث في الوقت الفعلي، مثبّتة على شاشة القفل وفي Dynamic Island. بناء واحد منها يعني عادةً نشر تطبيق iOS خاص بك مع امتداد أداة ActivityKit، وطلب رموز push-to-start، والتخاطب بنفسك مع APNs. يستبدل PushWard كل ذلك بـ REST API واحدة: يعرض تطبيق PushWard نشاطك المباشر، وطلب HTTP واحد يبدؤه أو يحدّثه أو ينهيه.

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

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

ابدأ نشاطًا مباشرًا وحدّثه وأنهِه عبر HTTP

# 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"
  } }'

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

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

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

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

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

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

الأسئلة الشائعة

هل هذه هي API الأنشطة المباشرة الرسمية من Apple؟

لا. إطار العمل الرسمي من Apple هو ActivityKit، وهو يتطلب بناء تطبيق iOS خاص بك ونشره. PushWard هو API مستقل للأنشطة المباشرة في iOS: يوصل تحديثاتك عبر Apple Push Notification service إلى تطبيق PushWard، الذي يعرضها على شاشة القفل وفي Dynamic Island.

هل يمكنني بدء نشاط مباشر من خادم؟

نعم — هذا هو الهدف بالضبط. أي خادم أو سكربت أو أتمتة قادرة على إرسال طلب HTTP يمكنها إنشاء نشاط مباشر وبدؤه وتحديثه وإنهاؤه. يتولى PushWard عنك مسار push-to-start الخاص بـ Apple، فيظهر النشاط دون أن يفتح المستلم التطبيق.

هل يحتاج المستلمون إلى تطبيق مثبّت؟

نعم — تطبيق PushWard المجاني على iOS هو الذي يعرض النشاط المباشر. لا شيء عليك بناؤه أو توقيعه أو تقديمه إلى App Store؛ يثبّت المستلمون PushWard مرة واحدة وتقود طلباتك شاشة القفل لديهم.

أي أجهزة iPhone تدعم الأنشطة المباشرة؟

يتطلب تطبيق PushWard نظام iOS 26 أو أحدث. على أجهزة iPhone المزوّدة بـ Dynamic Island يستقر النشاط المباشر داخل الجزيرة؛ وعلى الطرازات التي تفتقر إليها يظهر على شاشة القفل وفي وضع الاستعداد.

جرّب API الأنشطة المباشرة في iOS

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