सामग्री पर जाएँ

हर उस चीज़ के लिए iOS विजेट API जो HTTP बोलती है

PushWard, Apple के iOS विजेट के लिए एक API है: विजेट एक बार declare करें, फिर सादी HTTP requests से iPhone की होम स्क्रीन, लॉक स्क्रीन और स्टैंडबाय चलाएँ। हर अपडेट push से चलने वाला WidgetKit refresh trigger करता है — न polling, न WidgetKit कोड, न Xcode, न आपकी तरफ़ से App Store review।

iOS होम स्क्रीन विजेट क्या है?

विजेट Apple की एक नज़र में दिखने वाली सतहें हैं: iPhone की होम स्क्रीन, लॉक स्क्रीन और स्टैंडबाय पर हमेशा दिखने वाली छोटी टाइलें, जो बिना app खोले जानकारी दिखाती हैं। ये WidgetKit से बनते हैं, जो Apple का on-device framework है, और आम तौर पर हर विजेट उस app का होता है जिसे आपको खुद बनाना, sign करना और शिप करना पड़ता। PushWard के विजेट अलग हैं: उन्हें PushWard app render करता है, और उनका content आपकी API calls से आता है — किसी sensor की reading, server का health check, deploy counter, कुछ भी जो JSON में भेजा जा सके।

API कैसे काम करती है

POST से विजेट register करें, फिर PATCH से अपडेट करें — बस इतना ही loop है। हर अपडेट Apple Push Notification service के ज़रिए एक हल्का push भेजता है जो WidgetKit से विजेट की timeline फिर से load करवाता है, इसलिए नई value बिना किसी polling के दिख जाती है। हर विजेट का वैकल्पिक push throttle झटकों में आने वाले sources को समेट देता है।

HTTP से विजेट register और अपडेट करें 
# 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" } }'

दस विजेट टेम्पलेट

डेटा के हिसाब से layout चुनें: एक value, progress bar, status light, gauge, stat list, trend sparkline, countdown, बैटरी स्तर, schedule, या endpoints के बीच flow। हर टेम्पलेट PushWard app natively render करता है, इसलिए आपका डेटा बिना किसी design मेहनत के सधे हुए layout में दिखता है।

Trend विजेट — बढ़ती सियान sparkline के ऊपर p95 latency 371 ms, ऊपर की ओर तीर और Refresh व History बटन के साथ।
बैटरी विजेट — चार हरे चार्ज रिंग: 68%, चार्जिंग बोल्ट के साथ 45%, लाल रंग में 18% और 92%।
Flow विजेट — Power में Solar 3,200 W, बाहर जाते तीर के साथ Grid 1,400 W, अंदर आते चार्जिंग तीर के साथ Battery 800 W, और 1,000 W खींचता Home।

विजेट टेम्पलेट देखें →

इंटरैक्टिव विजेट जो काम करते हैं

विजेट में तीन तक tap actions हो सकते हैं: होम स्क्रीन छोड़े बिना silent webhook चलाना, deep link से दूसरे app में जाना, या कोई URL खोलना। server restart करें, कोई Shortcut trigger करें या alert acknowledge करें, सीधे विजेट से — PushWard app को कभी खोलना नहीं पड़ता।

आपके stack के साथ काम करता है

जो tools आप पहले से चलाते हैं, उन्हीं से विजेट को डेटा दें: Grafana alert से status light बदलना, Home Assistant automation से तापमान अपडेट होना, GitHub Actions job से deploy counter बढ़ना, cron script से backup की उम्र post होना। जो भी HTTP request भेज सकता है, उसका अपना विजेट हो सकता है।

सभी integrations देखें →

विजेट और लाइव ऐक्टिविटीज़ साथ-साथ

विजेट और लाइव ऐक्टिविटीज़ एक-दूसरे के पूरक हैं: विजेट स्थायी, शांत status है जो हटाए जाने तक होम स्क्रीन पर रहता है, जबकि लाइव ऐक्टिविटी शुरुआत और अंत वाला काम है जो चलते समय लॉक स्क्रीन और Dynamic Island पर टिका रहता है। PushWard दोनों को एक ही REST API और एक ही integration key से चलाता है।

लाइव ऐक्टिविटी API के बारे में जानें →

अक्सर पूछे जाने वाले प्रश्न

क्या यह Apple की आधिकारिक WidgetKit API है?

नहीं। WidgetKit, Apple का on-device framework है, और उसे सीधे इस्तेमाल करने का मतलब है widget extension के साथ अपना iOS app बनाकर शिप करना। PushWard एक स्वतंत्र iOS विजेट API है: WidgetKit extension PushWard app में आता है, और आपकी HTTP requests तय करती हैं कि वह क्या दिखाए।

विजेट कितनी जल्दी अपडेट होते हैं?

हर PATCH एक हल्का push trigger करता है जो WidgetKit से विजेट फिर से load करवाता है, इसलिए अपडेट आम तौर पर कुछ सेकंड में पहुँच जाते हैं। हर विजेट का push throttle (1 सेकंड से 1 घंटे तक) झटकों में आने वाले sources को समेटता है, ताकि refresh उस बजट में रहें जो iOS extension को देता है।

क्या विजेट लॉक स्क्रीन और स्टैंडबाय पर काम करते हैं?

हाँ। PushWard विजेट iPhone की होम स्क्रीन, लॉक स्क्रीन और स्टैंडबाय में जोड़े जा सकते हैं। लॉक स्क्रीन के compact accessory slots संक्षिप्त layout दिखाते हैं, और किसी पर tap करने से उसका configure किया हुआ tap action खुलता है।

क्या पाने वालों को कोई app इंस्टॉल करना होगा?

हाँ — मुफ़्त PushWard iOS app (iOS 26 या बाद का) विजेट render करता है और उन्हें iOS widget picker में register करता है। आपको कुछ भी बनाना या App Store पर submit नहीं करना।

iOS विजेट API आज़माएँ

playground में विजेट payload बनाएँ और उसे simulated iPhone पर render होते देखें, या getting-started guide पढ़ें और कुछ ही मिनटों में curl से अपना पहला विजेट register करें।

Playground विजेट विजेट API लाइव ऐक्टिविटीज़