API أدوات iOS لكل ما يتحدث HTTP

PushWard هو API لأدوات iOS من Apple: عرّف الأداة مرة واحدة، ثم قُد الشاشة الرئيسية وشاشة القفل ووضع الاستعداد على iPhone بطلبات HTTP بسيطة. كل تحديث يطلق تحديث WidgetKit مدفوعًا بالإشعارات — لا استطلاع دوري، ولا كود WidgetKit، ولا Xcode، ولا مراجعة App Store من جانبك.

ما هي أداة الشاشة الرئيسية في iOS؟

الأدوات هي أسطح Apple التي تُقرأ بلمحة: بلاطات صغيرة دائمة الظهور على الشاشة الرئيسية وشاشة القفل ووضع الاستعداد في iPhone، تعرض المعلومات دون فتح أي تطبيق. تُبنى بـ WidgetKit، إطار عمل Apple على الجهاز، وعادةً تنتمي كل واحدة إلى تطبيق عليك بناؤه وتوقيعه ونشره بنفسك. أدوات PushWard مختلفة: يعرضها تطبيق PushWard، ويأتي محتواها من استدعاءات API الخاصة بك — قراءة مستشعر، فحص صحة خادم، عدّاد نشرات، أي شيء يمكن إرساله بصيغة JSON.

كيف تعمل الـ API

سجّل أداة بطلب POST، ثم حدّثها بطلب PATCH — هذه هي الدورة كلها. يرسل كل تحديث إشعارًا خفيفًا عبر Apple Push Notification service يطلب من WidgetKit إعادة تحميل الخط الزمني للأداة، فتظهر القيمة الجديدة دون أن تستطلع الأداة أبدًا. ويوجد مثبّط إشعارات اختياري لكل أداة يجمع المصادر التي ترسل على دفعات.

سجّل أداة وحدّثها عبر HTTP

# 1. Register a widget
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "cpu-load", "name": "CPU Load", "content": {
    "template": "progress", "value": 0.42,
    "label": "load avg", "icon": "cpu", "accent_color": "cyan"
  } }'

# 2. Update it - WidgetKit refreshes the widget
curl -X PATCH https://api.pushward.app/widgets/cpu-load \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "content": { "value": 0.78, "accent_color": "orange" } }'

عشرة قوالب للأدوات

اختر التخطيط الملائم للبيانات: قيمة واحدة، شريط تقدّم، ضوء حالة، عدّاد قياس، قائمة إحصاءات، مخطط اتجاه مصغّر، عدّ تنازلي، مستوى بطارية، جدول مواعيد، أو تدفق بين نقاط. كل قالب يعرضه تطبيق PushWard أصليًا، فتصل بياناتك إلى تخطيط مصقول دون أي عمل تصميمي.

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

أدوات تفاعلية تُنفّذ

يمكن للأداة أن تحمل حتى ثلاثة إجراءات لمس: إطلاق webhook صامت دون مغادرة الشاشة الرئيسية، أو الانتقال برابط عميق إلى تطبيق آخر، أو فتح URL. أعد تشغيل خادم، أو شغّل اختصارًا، أو أكّد استلام تنبيه مباشرة من الأداة — لا يحتاج تطبيق PushWard إلى الفتح أبدًا.

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

غذِّ الأدوات من الأدوات التي تشغّلها بالفعل: تنبيه Grafana يقلب ضوء حالة، وأتمتة Home Assistant تحدّث درجة حرارة، ومهمة GitHub Actions ترفع عدّاد النشرات، وسكربت cron ينشر عمر نسخة احتياطية. إن كان يستطيع إرسال طلب HTTP، فبإمكانه امتلاك أداة.

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

الأدوات والأنشطة المباشرة معًا

الأدوات والأنشطة المباشرة متكاملتان: الأداة حالة دائمة محيطة تبقى على الشاشة الرئيسية حتى تُزال، بينما النشاط المباشر مهمة لها بداية ونهاية تثبّت نفسها على شاشة القفل وفي Dynamic Island أثناء تنفيذها. يقود PushWard كليهما عبر نفس REST API ونفس مفتاح التكامل.

تعرّف على API الأنشطة المباشرة →

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

هل هذه هي WidgetKit API الرسمية من Apple؟

لا. WidgetKit هو إطار عمل Apple على الجهاز، واستخدامه مباشرة يعني بناء تطبيق iOS خاص بك مع امتداد أداة ونشره. PushWard هو API مستقل لأدوات iOS: تطبيق PushWard يشحن امتداد WidgetKit، وطلبات HTTP الخاصة بك تقرر ما يعرضه.

ما مدى سرعة تحديث الأدوات؟

كل PATCH يطلق إشعارًا خفيفًا يطلب من WidgetKit إعادة تحميل الأداة، فتصل التحديثات عادةً خلال ثوانٍ. مثبّط الإشعارات لكل أداة (من ثانية واحدة إلى ساعة واحدة) يجمع المصادر ذات الدفعات، ويبقي التحديثات ضمن الميزانية التي يمنحها iOS للامتداد.

هل تعمل الأدوات على شاشة القفل وفي وضع الاستعداد؟

نعم. يمكن إضافة أدوات PushWard إلى الشاشة الرئيسية وشاشة القفل ووضع الاستعداد في iPhone. تعرض خانات الملحقات المدمجة في شاشة القفل تخطيطًا مكثّفًا، ولمس إحداها يفتح إجراء اللمس المضبوط لها.

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

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

جرّب API أدوات iOS

ابنِ حمولة أداة في الـ playground وشاهدها تُعرض على iPhone محاكى، أو اقرأ دليل البدء وسجّل أول أداة لك باستخدام curl خلال دقائق.