API-ul de widgeturi pe iOS pentru orice vorbește HTTP

PushWard este un API pentru widgeturile iOS de la Apple: declari un widget o dată, apoi conduci ecranul principal, ecranul de blocare și modul În repaus al iPhone-ului cu simple cereri HTTP. Fiecare actualizare declanșează o reîmprospătare WidgetKit condusă de push — fără polling, fără cod WidgetKit, fără Xcode, fără recenzie App Store din partea ta.

Ce este un widget din ecranul principal iOS?

Widgeturile sunt suprafețele Apple vizibile dintr-o privire: plăcuțe mici, mereu la vedere, pe ecranul principal, ecranul de blocare și în modul În repaus al iPhone-ului, care arată informații fără a deschide o aplicație. Sunt construite cu WidgetKit, framework-ul Apple de pe dispozitiv, și în mod normal fiecare aparține unei aplicații pe care ar trebui să o construiești, semnezi și publici tu însuți. Widgeturile PushWard sunt diferite: aplicația PushWard le redă, iar conținutul lor vine din apelurile tale de API — o citire de senzor, o verificare de sănătate a unui server, un contor de deploy-uri, orice poate fi trimis ca JSON.

Cum funcționează API-ul

Înregistrezi un widget cu un POST, apoi îl actualizezi cu un PATCH — asta e toată bucla. Fiecare actualizare trimite un push ușor prin Apple Push Notification service, care îi spune WidgetKit să reîncarce cronologia widgetului, așa că noua valoare apare fără ca widgetul să facă vreodată polling. Un limitator de push opțional per widget grupează sursele care trimit în rafale.

Înregistrează și actualizează un widget prin HTTP

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

Zece șabloane de widget

Alege aspectul potrivit datelor: o valoare unică, o bară de progres, un indicator luminos de stare, un cadran, o listă de statistici, o sparkline de tendință, o numărătoare inversă, un nivel de baterie, un orar sau un flux între puncte. Fiecare șablon este redat nativ de aplicația PushWard, astfel că datele tale ajung într-un aspect finisat fără nicio muncă de design.

Răsfoiește șabloanele de widget →

Widgeturi interactive care acționează

Widgeturile pot purta până la trei acțiuni la atingere: declanșează un webhook silențios fără a părăsi ecranul principal, sari printr-un deep link în altă aplicație sau deschide un URL. Repornește un server, declanșează o Scurtătură sau confirmă o alertă direct din widget — aplicația PushWard nu trebuie să se deschidă niciodată.

Funcționează cu stack-ul tău

Alimentează widgeturile din uneltele pe care le rulezi deja: o alertă Grafana care comută un indicator de stare, o automatizare Home Assistant care actualizează o temperatură, un job GitHub Actions care incrementează un contor de deploy-uri, un script cron care publică vechimea unui backup. Dacă poate trimite o cerere HTTP, poate deține un widget.

Vezi toate integrările →

Widgeturile și Activitățile live împreună

Widgeturile și Activitățile live sunt complementare: un widget este o stare persistentă, ambientală, care rămâne pe ecranul principal până e eliminat, în timp ce o Activitate live este o sarcină cu un început și un sfârșit, care se fixează pe ecranul de blocare și în Dynamic Island cât timp rulează. PushWard le conduce pe amândouă prin același REST API și aceeași cheie de integrare.

Află despre API-ul de Activități live →

Întrebări frecvente

Este acesta API-ul oficial WidgetKit de la Apple?

Nu. WidgetKit este framework-ul Apple de pe dispozitiv, iar folosirea lui directă înseamnă să construiești și să publici propria aplicație iOS cu o extensie de widget. PushWard este un API independent de widgeturi pe iOS: aplicația PushWard livrează extensia WidgetKit, iar cererile tale HTTP decid ce afișează.

Cât de repede se actualizează widgeturile?

Fiecare PATCH declanșează un push ușor care îi spune WidgetKit să reîncarce widgetul, așa că actualizările ajung de obicei în câteva secunde. Un limitator de push per widget (de la 1 secundă la 1 oră) grupează sursele în rafale, menținând reîmprospătările în bugetul pe care iOS îl acordă extensiei.

Funcționează widgeturile pe ecranul de blocare și în modul În repaus?

Da. Widgeturile PushWard pot fi adăugate pe ecranul principal, pe ecranul de blocare și în modul În repaus al iPhone-ului. Sloturile compacte de accesorii ale ecranului de blocare redau un aspect condensat, iar atingerea unuia deschide acțiunea la atingere configurată.

Destinatarii au nevoie de o aplicație instalată?

Da — aplicația iOS gratuită PushWard (iOS 26 sau mai nou) redă widgeturile și le înregistrează în selectorul de widgeturi din iOS. Nu ai nimic de construit sau de trimis în App Store.

Încearcă API-ul de widgeturi pe iOS

Construiește un payload de widget în playground și privește-l cum se redă pe un iPhone simulat, sau citește ghidul de început și înregistrează-ți primul widget cu curl în câteva minute.