ہر اس چیز کے لیے iOS لائیو سرگرمیوں کا API جو HTTP بولتی ہے

PushWard، Apple کی لائیو سرگرمیوں کے لیے ایک API ہے: ایک HTTP درخواست بھیجیں اور وہ iPhone کی لاک اسکرین اور Dynamic Island پر لائیو نظر آتی ہے، ریئل ٹائم میں اپ ڈیٹ ہوتی ہے اور کام مکمل ہونے پر خود ہٹ جاتی ہے۔ نہ ActivityKit کوڈ، نہ Xcode، نہ آپ کی طرف سے App Store جائزہ۔

لائیو سرگرمی کیا ہے؟

لائیو سرگرمی iOS کی ایک خصوصیت ہے جو لاک اسکرین پر، Dynamic Island میں اور StandBy میں لائیو، ایک نظر میں سمجھ آنے والی معلومات دکھاتی ہے — اور وصول کنندہ کو کوئی ایپ کھولنے کی ضرورت نہیں پڑتی۔ پش نوٹیفکیشن کے برعکس، جو ایک بار نظر آ کر فہرست میں گم ہو جاتی ہے، لائیو سرگرمی جمی رہتی ہے اور ریئل ٹائم میں اپ ڈیٹ ہوتی ہے: اپنے مراحل سے گزرتی ہوئی بلڈ، الٹی گنتی کرتا ٹائمر، قریب آتی ڈیلیوری۔ PushWard ایک HTTP درخواست کو بالکل اسی میں بدل دیتا ہے۔

Apple کی لائیو سرگرمیاں، ActivityKit کے بغیر

لائیو سرگرمیاں iOS 16.1 میں متعارف ہونے والی Apple کی iOS خصوصیت ہیں: ایک نظر میں سمجھ آنے والی، ریئل ٹائم سطحیں جو لاک اسکرین اور Dynamic Island پر جمی رہتی ہیں۔ عام طور پر ایک بنانے کا مطلب ہے ActivityKit ویجیٹ ایکسٹینشن کے ساتھ اپنی iOS ایپ شپ کرنا، push-to-start ٹوکن حاصل کرنا اور خود APNs سے بات کرنا۔ PushWard یہ سب ایک REST API سے بدل دیتا ہے: PushWard ایپ آپ کی لائیو سرگرمی رینڈر کرتی ہے، اور ایک HTTP درخواست اسے شروع، اپ ڈیٹ یا ختم کرتی ہے۔

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

ایک ایکٹیویٹی بنائیں، شروع کریں، اپ ڈیٹ کریں اور ختم کریں — سب کچھ آپ کی انٹیگریشن کلید کے ساتھ PushWard کے REST API کے ذریعے۔ کوئی بھی سروس جو 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"
  } }'

ہر قسم کی اپ ڈیٹ کے لیے ایک ٹیمپلیٹ

مختلف کاموں کے لیے بنائے گئے لائیو سرگرمی ٹیمپلیٹس میں سے چنیں — ایک عمومی پروگریس بار، الٹی گنتی، مراحل کی ترتیب، الرٹ، گیج، ٹائم لائن اسپارک لائن، ٹائلوں کا بورڈ یا لائیو ایونٹ لاگ۔ ہر ایک کا لے آؤٹ لاک اسکرین اور Dynamic Island کے لیے سنوارا گیا ہے۔

ٹیمپلیٹس دیکھیں →

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

جو ٹولز آپ پہلے سے چلا رہے ہیں، انہی سے براہِ راست لائیو سرگرمیاں بھیجیں۔ تیار شدہ برجز اور ہوسٹ کیا گیا webhook relay، Grafana الرٹس، Home Assistant آٹومیشنز، GitHub Actions، SABnzbd ڈاؤن لوڈز، Bambu Lab پرنٹس، ArgoCD سنکس اور JSON بھیج سکنے والی ہر چیز کا احاطہ کرتے ہیں۔

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

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

کیا یہ Apple کا سرکاری لائیو سرگرمیوں کا API ہے؟

نہیں۔ Apple کا سرکاری فریم ورک ActivityKit ہے، جس کے لیے اپنی iOS ایپ بنا کر شپ کرنی پڑتی ہے۔ PushWard ایک خودمختار iOS لائیو سرگرمیوں کا API ہے: یہ آپ کی اپ ڈیٹس Apple Push Notification service کے ذریعے PushWard ایپ تک پہنچاتا ہے، جو انہیں لاک اسکرین اور Dynamic Island پر رینڈر کرتی ہے۔

کیا میں سرور سے لائیو سرگرمی شروع کر سکتا ہوں؟

جی ہاں — یہی تو اصل مقصد ہے۔ کوئی بھی سرور، اسکرپٹ یا آٹومیشن جو HTTP درخواست بھیج سکے، لائیو سرگرمی بنا، شروع، اپ ڈیٹ اور ختم کر سکتی ہے۔ Apple کا push-to-start مرحلہ PushWard آپ کے لیے سنبھالتا ہے، اس لیے وصول کنندہ کے ایپ کھولے بغیر سرگرمی نظر آ جاتی ہے۔

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

جی ہاں — مفت PushWard iOS ایپ ہی لائیو سرگرمی رینڈر کرتی ہے۔ آپ کو کچھ بنانا، سائن کرنا یا App Store میں جمع کرانا نہیں پڑتا؛ وصول کنندگان ایک بار PushWard انسٹال کرتے ہیں اور آپ کی درخواستیں ان کی لاک اسکرین چلاتی ہیں۔

کون سے iPhone لائیو سرگرمیوں کو سپورٹ کرتے ہیں؟

PushWard ایپ کے لیے iOS 26 یا اس کے بعد کا ورژن درکار ہے۔ Dynamic Island والے iPhone پر لائیو سرگرمی آئی لینڈ میں سما جاتی ہے؛ جن ماڈلز میں یہ نہیں، وہاں وہ لاک اسکرین اور StandBy میں نظر آتی ہے۔

iOS لائیو سرگرمی API آزمائیں

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