HTTP మాట్లాడే ప్రతి దానికీ iOS విడ్జెట్ API
PushWard అనేది Apple iOS విడ్జెట్ల కోసం ఒక API: విడ్జెట్ను ఒక్కసారి డిక్లేర్ చేయండి; ఆపై సాధారణ HTTP రిక్వెస్టులతో iPhone హోమ్ స్క్రీన్, లాక్ స్క్రీన్ మరియు స్టాండ్బైను నడిపించండి. ప్రతి అప్డేట్ పుష్-ఆధారిత WidgetKit రిఫ్రెష్ను ప్రేరేపిస్తుంది — పోలింగ్ లేదు, WidgetKit కోడ్ లేదు, Xcode లేదు, మీ వైపు App Store సమీక్ష కూడా లేదు.
iOS హోమ్ స్క్రీన్ విడ్జెట్ అంటే ఏమిటి?
విడ్జెట్లు Apple యొక్క ఒక్క చూపు ఉపరితలాలు: iPhone హోమ్ స్క్రీన్, లాక్ స్క్రీన్ మరియు స్టాండ్బైలో ఎప్పుడూ కనిపించే చిన్న టైల్స్; యాప్ తెరవకుండానే సమాచారాన్ని చూపిస్తాయి. అవి Apple యొక్క ఆన్-డివైస్ ఫ్రేమ్వర్క్ అయిన WidgetKit తో నిర్మించబడతాయి; సాధారణంగా ప్రతి ఒక్కటీ మీరు స్వయంగా నిర్మించి, సైన్ చేసి, విడుదల చేయాల్సిన యాప్కు చెందుతుంది. 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 యాప్ నేటివ్గా రెండర్ చేస్తుంది; కాబట్టి ఎలాంటి డిజైన్ పని లేకుండానే మీ డేటా అందమైన లేఅవుట్లో అమరిపోతుంది.
విడ్జెట్ టెంప్లేట్లను చూడండి →
చర్య తీసుకునే ఇంటరాక్టివ్ విడ్జెట్లు
ఒక విడ్జెట్ మూడు వరకు ట్యాప్ చర్యలను కలిగి ఉండగలదు: హోమ్ స్క్రీన్ వదలకుండా నిశ్శబ్ద webhook ను ప్రేరేపించడం, డీప్ లింక్తో మరో యాప్లోకి వెళ్లడం, లేదా ఒక 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 ఎక్స్టెన్షన్కు ఇచ్చే బడ్జెట్ లోపలే రిఫ్రెష్లను ఉంచుతుంది.
విడ్జెట్లు లాక్ స్క్రీన్పై, స్టాండ్బైలో పనిచేస్తాయా?
అవును. PushWard విడ్జెట్లను iPhone హోమ్ స్క్రీన్, లాక్ స్క్రీన్ మరియు స్టాండ్బైకు జోడించవచ్చు. లాక్ స్క్రీన్ యొక్క కాంపాక్ట్ యాక్సెసరీ స్లాట్లు కుదించిన లేఅవుట్ను రెండర్ చేస్తాయి; ఒకదాన్ని ట్యాప్ చేస్తే దాని కాన్ఫిగర్ చేసిన ట్యాప్ చర్య తెరుచుకుంటుంది.
స్వీకర్తలకు యాప్ ఇన్స్టాల్ అయి ఉండాలా?
అవును — ఉచిత PushWard iOS యాప్ (iOS 26 లేదా ఆ తర్వాతిది) విడ్జెట్లను రెండర్ చేసి, వాటిని iOS విడ్జెట్ పికర్లో రిజిస్టర్ చేస్తుంది. మీరు ఏమీ నిర్మించడం లేదా App Store కు సమర్పించడం అవసరం లేదు.
iOS విడ్జెట్ API ని ప్రయత్నించండి
playground లో ఒక విడ్జెట్ పేలోడ్ను నిర్మించి, అది సిమ్యులేటెడ్ iPhone పై రెండర్ అవడాన్ని చూడండి; లేదా ప్రారంభ గైడ్ చదివి కొన్ని నిమిషాల్లో curl తో మీ మొదటి విడ్జెట్ను రిజిస్టర్ చేయండి.