मजकुराकडे जा

HTTP बोलणाऱ्या प्रत्येक गोष्टीसाठी iOS लाइव्ह ॲक्टिव्हिटी API

PushWard हे Apple च्या लाइव्ह ॲक्टिव्हिटीजसाठी एक API आहे: एकच HTTP रिक्वेस्ट पाठवा आणि ती iPhone लॉक स्क्रीन आणि Dynamic Island वर लाइव्ह दिसते, रिअल-टाइममध्ये अपडेट होते आणि काम पूर्ण झाल्यावर आपोआप निघून जाते. ActivityKit कोड नाही, Xcode नाही, तुमच्या बाजूने App Store रिव्ह्यूही नाही.

लाइव्ह ॲक्टिव्हिटी म्हणजे काय?

लाइव्ह ॲक्टिव्हिटी हे iOS चे एक वैशिष्ट्य आहे, जे लॉक स्क्रीनवर, Dynamic Island मध्ये आणि StandBy मध्ये लाइव्ह, एका नजरेत समजणारी माहिती दाखवते — आणि प्राप्तकर्त्याला कोणतेही अ‍ॅप उघडावे लागत नाही. एकदा दिसून यादीत हरवणाऱ्या पुश नोटिफिकेशनसारखे नाही; लाइव्ह ॲक्टिव्हिटी पिन केलेली राहते आणि रिअल-टाइममध्ये अपडेट होते: पायऱ्यांमधून पुढे जाणारे बिल्ड, उलटी गिनती करणारा टायमर, जवळ येणारी डिलिव्हरी. PushWard एका HTTP रिक्वेस्टचे नेमके यातच रूपांतर करते.

Apple च्या लाइव्ह ॲक्टिव्हिटीज, ActivityKit शिवाय

लाइव्ह ॲक्टिव्हिटीज हे Apple चे iOS 16.1 मध्ये आलेले 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 ने तुमची पहिली पाठवा.

Playground विजेट्स दस्तऐवज वाचा API संदर्भ तुलना