HTTP பேசும் எதற்கும் ஏற்ற iOS Widgets API

iOS முகப்புத் திரை widget என்றால் என்ன?

Widgets என்பவை Apple இன் ஒரே பார்வையில் புரியும் பரப்புகள்: iPhone முகப்புத் திரை, பூட்டுத் திரை மற்றும் ஸ்டாண்ட்பையில் எப்போதும் தெரியும் சிறிய கட்டங்கள்; ஆப்பைத் திறக்காமலேயே தகவலைக் காட்டுகின்றன. அவை Apple இன் சாதனத்திலேயே இயங்கும் framework ஆன WidgetKit ஆல் உருவாக்கப்படுகின்றன; வழக்கமாக ஒவ்வொன்றும், நீங்களே உருவாக்கி, கையொப்பமிட்டு, வெளியிட வேண்டிய ஒரு ஆப்பைச் சேர்ந்தது. PushWard இன் widgets வேறுபட்டவை: PushWard ஆப் அவற்றை வரைகிறது; அவற்றின் உள்ளடக்கம் உங்கள் API அழைப்புகளில் இருந்து வருகிறது — ஒரு சென்சார் அளவீடு, ஒரு சர்வர் ஹெல்த் செக், ஒரு டெப்ளாய் எண்ணி, JSON ஆக அனுப்பக்கூடிய எதுவும்.

API எப்படி வேலை செய்கிறது

POST ஆல் widget ஐப் பதிவு செய்து, PATCH ஆல் புதுப்பியுங்கள் — சுழற்சி அவ்வளவுதான். ஒவ்வொரு புதுப்பிப்பும் Apple Push Notification service வழியாக ஒரு மெல்லிய புஷ் அனுப்புகிறது; அது widget இன் காலவரிசையை மீண்டும் ஏற்றச் சொல்லி WidgetKit க்கு அறிவிக்கிறது. எனவே widget ஒருபோதும் polling செய்யாமலேயே புதிய மதிப்பு தோன்றுகிறது. widget க்கு ஒரு விருப்பத் தேர்வான புஷ் கட்டுப்படுத்தி, திடீர்ப் பெருக்கத்துடன் அனுப்பும் மூலங்களை ஒன்றிணைக்கிறது.

# 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" } }'

பத்து widget வார்ப்புருக்கள்

தரவுக்குப் பொருந்தும் அமைப்பைத் தேர்ந்தெடுங்கள்: ஒற்றை மதிப்பு, முன்னேற்றப் பட்டை, நிலை விளக்கு, அளவுமானி, புள்ளிவிவரப் பட்டியல், போக்கு ஸ்பார்க்லைன், எண்ணிக்கைக் குறைப்பு, பேட்டரி அளவு, அட்டவணை, அல்லது இரு முனைகளுக்கு இடையிலான ஓட்டம். ஒவ்வொரு வார்ப்புருவையும் PushWard ஆப் நேட்டிவ் ஆக வரைகிறது; எனவே எந்த வடிவமைப்பு வேலையும் இல்லாமல் உங்கள் தரவு நேர்த்தியான அமைப்பில் அமர்கிறது.

widget வார்ப்புருக்களைப் பாருங்கள் →

செயல்படும் ஊடாடும் widgets

ஒரு widget மூன்று வரை தட்டல் செயல்களைக் கொண்டிருக்கலாம்: முகப்புத் திரையை விட்டு வெளியேறாமல் ஒரு அமைதியான webhook ஐ இயக்கலாம், deep link வழியாக வேறு ஆப்பிற்குச் செல்லலாம், அல்லது ஒரு URL ஐத் திறக்கலாம். widget இலிருந்தே சர்வரை மறுதொடக்கம் செய்யுங்கள், ஒரு Shortcut ஐ இயக்குங்கள், அல்லது ஒரு எச்சரிக்கையை உறுதிப்படுத்துங்கள் — PushWard ஆப்பை ஒருபோதும் திறக்க வேண்டியதில்லை.

உங்கள் ஸ்டேக்குடன் இயங்குகிறது

நீங்கள் ஏற்கெனவே இயக்கும் கருவிகளிலிருந்தே widgets க்குத் தரவு ஊட்டுங்கள்: Grafana எச்சரிக்கை நிலை விளக்கை மாற்றுகிறது, Home Assistant ஆட்டோமேஷன் வெப்பநிலையைப் புதுப்பிக்கிறது, GitHub Actions ஜாப் டெப்ளாய் எண்ணியை உயர்த்துகிறது, cron ஸ்கிரிப்ட் காப்புப்பிரதியின் வயதைப் பதிவிடுகிறது. HTTP கோரிக்கை அனுப்ப முடிந்தால், அதற்கு ஒரு widget சொந்தமாக இருக்கலாம்.

அனைத்து ஒருங்கிணைப்புகளையும் காணுங்கள் →

widgets உம் நேரடிச் செயல்பாடுகளும் இணைந்து

widgets உம் நேரடிச் செயல்பாடுகளும் ஒன்றையொன்று நிறைவு செய்கின்றன: widget என்பது நீக்கும் வரை முகப்புத் திரையில் இருக்கும் நிலையான, அமைதியான நிலை; நேரடிச் செயல்பாடு என்பது தொடக்கமும் முடிவும் உள்ள ஒரு பணி — இயங்கும்போது பூட்டுத் திரை மற்றும் Dynamic Island இல் தன்னை நிலைநிறுத்திக்கொள்கிறது. PushWard இரண்டையும் ஒரே REST API ஆலும் ஒரே ஒருங்கிணைப்பு விசையாலும் இயக்குகிறது.

நேரடிச் செயல்பாட்டு API பற்றி அறியுங்கள் →

அடிக்கடி கேட்கப்படும் கேள்விகள்

இது Apple இன் அதிகாரப்பூர்வ WidgetKit API ஆ?

இல்லை. WidgetKit என்பது Apple இன் சாதனத்திலேயே இயங்கும் framework; அதை நேரடியாகப் பயன்படுத்த, widget நீட்டிப்புடன் உங்கள் சொந்த iOS ஆப்பை உருவாக்கி வெளியிட வேண்டும். PushWard ஒரு சுயாதீன iOS widgets API: WidgetKit நீட்டிப்பு PushWard ஆப்புடன் வருகிறது; அது எதைக் காட்டும் என்பதை உங்கள் HTTP கோரிக்கைகள் தீர்மானிக்கின்றன.

widgets எவ்வளவு விரைவாகப் புதுப்பிக்கப்படுகின்றன?

ஒவ்வொரு PATCH உம் widget ஐ மீண்டும் ஏற்றச் சொல்லி WidgetKit க்கு ஒரு மெல்லிய புஷ்ஷைத் தூண்டுகிறது; எனவே புதுப்பிப்புகள் வழக்கமாக சில வினாடிகளில் சேர்கின்றன. widget க்கான புஷ் கட்டுப்படுத்தி (1 வினாடி முதல் 1 மணிநேரம் வரை) திடீர்ப் பெருக்க மூலங்களை ஒன்றிணைத்து, iOS நீட்டிப்பிற்கு வழங்கும் வரவுசெலவுக்குள் புதுப்பிப்புகளை வைத்திருக்கிறது.

widgets பூட்டுத் திரையிலும் ஸ்டாண்ட்பையிலும் வேலை செய்யுமா?

ஆம். PushWard widgets ஐ iPhone முகப்புத் திரை, பூட்டுத் திரை மற்றும் ஸ்டாண்ட்பையில் சேர்க்கலாம். பூட்டுத் திரையின் சிறிய accessory இடங்களில் சுருக்கமான அமைப்பு வரையப்படுகிறது; ஒன்றைத் தட்டினால் அதற்கு அமைக்கப்பட்ட தட்டல் செயல் திறக்கிறது.

பெறுநர்களுக்கு ஆப் நிறுவப்பட்டிருக்க வேண்டுமா?

ஆம் — இலவச PushWard iOS ஆப் (iOS 26 அல்லது அதற்குப் பிந்தையது) widgets ஐ வரைந்து, iOS widget தேர்வியில் அவற்றைப் பதிவு செய்கிறது. நீங்கள் எதையும் உருவாக்கவோ App Store இல் சமர்ப்பிக்கவோ வேண்டியதில்லை.

iOS Widgets API ஐ முயற்சிக்கவும்

playground இல் ஒரு widget payload ஐ உருவாக்கி, அது சிமுலேட்டட் iPhone இல் வரையப்படுவதைப் பாருங்கள்; அல்லது தொடக்க வழிகாட்டியைப் படித்து சில நிமிடங்களில் curl மூலம் உங்கள் முதல் widget ஐப் பதிவு செய்யுங்கள்.