ہر اس چیز کے لیے iOS ویجیٹس API جو HTTP بولتی ہے

PushWard، Apple کی iOS ویجیٹس کے لیے ایک API ہے: ویجیٹ ایک بار ڈکلیئر کریں، پھر سادہ HTTP درخواستوں سے iPhone کی ہوم اسکرین، لاک اسکرین اور StandBy چلائیں۔ ہر اپ ڈیٹ پش سے چلنے والا WidgetKit ریفریش شروع کرتی ہے — نہ پولنگ، نہ WidgetKit کوڈ، نہ Xcode، نہ آپ کی طرف سے App Store جائزہ۔

iOS ہوم اسکرین ویجیٹ کیا ہے؟

ویجیٹس Apple کی ایک نظر میں سمجھ آنے والی سطحیں ہیں: iPhone کی ہوم اسکرین، لاک اسکرین اور StandBy پر ہمیشہ نظر آنے والی چھوٹی ٹائلیں، جو کوئی ایپ کھولے بغیر معلومات دکھاتی ہیں۔ یہ WidgetKit سے بنتی ہیں، جو Apple کا آن ڈیوائس فریم ورک ہے، اور عام طور پر ہر ویجیٹ ایسی ایپ کا حصہ ہوتی ہے جو آپ کو خود بنانی، سائن کرنی اور شپ کرنی پڑتی۔ PushWard کی ویجیٹس مختلف ہیں: انہیں PushWard ایپ رینڈر کرتی ہے، اور ان کا مواد آپ کی API کالز سے آتا ہے — کوئی سینسر ریڈنگ، سرور کا ہیلتھ چیک، ڈپلائے کاؤنٹر، ہر وہ چیز جو JSON کی صورت بھیجی جا سکے۔

API کیسے کام کرتا ہے

POST سے ویجیٹ رجسٹر کریں، پھر PATCH سے اپ ڈیٹ کریں — بس یہی پورا چکر ہے۔ ہر اپ ڈیٹ Apple Push Notification service کے ذریعے ایک ہلکی پش بھیجتی ہے جو WidgetKit سے ویجیٹ کی ٹائم لائن دوبارہ لوڈ کراتی ہے، یوں نئی قدر ویجیٹ کے کبھی پولنگ کیے بغیر نظر آ جاتی ہے۔ ہر ویجیٹ کے لیے ایک اختیاری push throttle یکدم آنے والے ذرائع کو یکجا کر دیتا ہے۔

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 کھولیں۔ سرور ری اسٹارٹ کریں، کوئی Shortcut چلائیں یا کوئی الرٹ سیدھا ویجیٹ سے تسلیم کریں — PushWard ایپ کو کبھی کھلنا نہیں پڑتا۔

آپ کے اسٹیک کے ساتھ کام کرتا ہے

جو ٹولز آپ پہلے سے چلا رہے ہیں انہی سے ویجیٹس کو ڈیٹا دیں: Grafana الرٹ اسٹیٹس لائٹ بدلتا ہوا، Home Assistant آٹومیشن درجہ حرارت اپ ڈیٹ کرتی ہوئی، GitHub Actions جاب ڈپلائے کاؤنٹر بڑھاتی ہوئی، کوئی cron اسکرپٹ بیک اپ کی عمر بھیجتا ہوا۔ جو کچھ بھی HTTP درخواست بھیج سکتا ہے، وہ ایک ویجیٹ کا مالک بن سکتا ہے۔

تمام انٹیگریشنز دیکھیں →

ویجیٹس اور لائیو سرگرمیاں، ساتھ ساتھ

ویجیٹس اور لائیو سرگرمیاں ایک دوسرے کی تکمیل کرتی ہیں: ویجیٹ مستقل، پس منظر کی حالت ہے جو ہٹائے جانے تک ہوم اسکرین پر رہتی ہے، جبکہ لائیو سرگرمی آغاز اور انجام والا کام ہے جو چلتے ہوئے خود کو لاک اسکرین اور Dynamic Island پر جما لیتا ہے۔ PushWard دونوں کو ایک ہی REST API اور ایک ہی انٹیگریشن کلید سے چلاتا ہے۔

لائیو سرگرمیوں کے API کے بارے میں جانیں →

اکثر پوچھے گئے سوالات

کیا یہ Apple کا سرکاری WidgetKit API ہے؟

نہیں۔ WidgetKit، Apple کا آن ڈیوائس فریم ورک ہے، اور اسے براہِ راست استعمال کرنے کا مطلب ہے ویجیٹ ایکسٹینشن کے ساتھ اپنی iOS ایپ بنا کر شپ کرنا۔ PushWard ایک خودمختار iOS ویجیٹس API ہے: WidgetKit ایکسٹینشن PushWard ایپ کے ساتھ آتی ہے، اور آپ کی HTTP درخواستیں طے کرتی ہیں کہ وہ کیا دکھائے۔

ویجیٹس کتنی جلدی اپ ڈیٹ ہوتی ہیں؟

ہر PATCH ایک ہلکی پش بھیجتا ہے جو WidgetKit سے ویجیٹ دوبارہ لوڈ کراتی ہے، اس لیے اپ ڈیٹس عموماً چند سیکنڈ میں پہنچ جاتی ہیں۔ ہر ویجیٹ کا push throttle (1 سیکنڈ سے 1 گھنٹہ) یکدم آنے والے ذرائع کو یکجا کرتا ہے، تاکہ ریفریش iOS کی ایکسٹینشن کو دی گئی گنجائش کے اندر رہیں۔

کیا ویجیٹس لاک اسکرین اور StandBy میں کام کرتی ہیں؟

جی ہاں۔ PushWard ویجیٹس iPhone کی ہوم اسکرین، لاک اسکرین اور StandBy میں شامل کی جا سکتی ہیں۔ لاک اسکرین کے چھوٹے accessory خانوں میں ایک مختصر لے آؤٹ رینڈر ہوتا ہے، اور ٹیپ کرنے پر اس کا مقرر کردہ ٹیپ ایکشن کھلتا ہے۔

کیا وصول کنندگان کو کوئی ایپ انسٹال کرنی ہوگی؟

جی ہاں — مفت PushWard iOS ایپ (iOS 26 یا بعد کا) ویجیٹس رینڈر کرتی ہے اور انہیں iOS ویجیٹ پکر میں رجسٹر کرتی ہے۔ آپ کو کچھ بنانا یا App Store میں جمع کرانا نہیں پڑتا۔

iOS ویجیٹس API آزمائیں

playground میں ویجیٹ پے لوڈ بنائیں اور اسے سمیولیٹڈ iPhone پر رینڈر ہوتے دیکھیں، یا ابتدائی گائیڈ پڑھیں اور چند منٹوں میں curl سے اپنی پہلی ویجیٹ رجسٹر کریں۔