HTTP बोलणाऱ्या प्रत्येक गोष्टीसाठी iOS विजेट API
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 ला विजेटची टाइमलाइन पुन्हा लोड करायला सांगतो; त्यामुळे विजेटने कधीही पोलिंग न करता नवे मूल्य दिसते. प्रति-विजेट ऐच्छिक पुश थ्रॉटल झटक्याने येणारे स्रोत एकत्र करते.
# 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 अॅप नेटिव्हपणे रेंडर करते, त्यामुळे कोणत्याही डिझाइन कामाशिवाय तुमचा डेटा नीटनेटक्या लेआउटमध्ये दिसतो.
कृती करणारी इंटरॲक्टिव्ह विजेट्स
एका विजेटमध्ये तीनपर्यंत टॅप कृती असू शकतात: होम स्क्रीन न सोडता सायलेंट वेबहुक चालवणे, डीप लिंकने दुसऱ्या अॅपमध्ये जाणे, किंवा URL उघडणे. सर्व्हर रीस्टार्ट करा, शॉर्टकट चालवा किंवा अलर्टची दखल घ्या, थेट विजेटमधूनच — 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 ला विजेट पुन्हा लोड करायला सांगतो; त्यामुळे अपडेट सहसा काही सेकंदांत पोहोचतात. प्रति-विजेट पुश थ्रॉटल (1 सेकंद ते 1 तास) झटक्याने येणारे स्रोत एकत्र करते, आणि iOS एक्स्टेंशनला देत असलेल्या बजेटमध्ये रिफ्रेश ठेवते.
विजेट्स लॉक स्क्रीनवर आणि StandBy मध्ये चालतात का?
हो. PushWard विजेट्स iPhone च्या होम स्क्रीन, लॉक स्क्रीन आणि StandBy मध्ये जोडता येतात. लॉक स्क्रीनचे कॉम्पॅक्ट ॲक्सेसरी स्लॉट संक्षिप्त लेआउट रेंडर करतात, आणि एकावर टॅप केल्यास त्याची कॉन्फिगर केलेली टॅप कृती उघडते.
प्राप्तकर्त्यांकडे अॅप इन्स्टॉल असावे लागते का?
हो — मोफत PushWard iOS अॅप (iOS 26 किंवा नंतरचे) विजेट्स रेंडर करते आणि त्यांना iOS विजेट पिकरमध्ये रजिस्टर करते. तुम्हाला काहीही बनवायचे किंवा App Store वर सबमिट करायचे नाही.
iOS विजेट API वापरून पाहा
playground मध्ये विजेट पेलोड बनवा आणि तो सिम्युलेटेड iPhone वर रेंडर होताना पाहा, किंवा गेटिंग-स्टार्टेड मार्गदर्शक वाचा आणि काही मिनिटांत curl ने तुमचे पहिले विजेट रजिस्टर करा.