API Widget iOS untuk apa pun yang berbicara HTTP

Apa itu widget Layar Utama iOS?

Widget adalah permukaan sekilas milik Apple: ubin kecil yang selalu terlihat di Layar Utama, Layar Terkunci, dan mode Siaga iPhone yang menampilkan informasi tanpa membuka aplikasi. Widget dibuat dengan WidgetKit, framework di perangkat milik Apple, dan biasanya masing-masing milik sebuah aplikasi yang harus Anda buat, tanda tangani, dan rilis sendiri. Widget PushWard berbeda: aplikasi PushWard yang menampilkannya, dan kontennya berasal dari panggilan API Anda — pembacaan sensor, pemeriksaan kesehatan server, penghitung deploy, apa pun yang bisa dikirim sebagai JSON.

Cara kerja API

Daftarkan widget dengan POST, lalu perbarui dengan PATCH — itulah seluruh daurnya. Setiap pembaruan mengirim push ringan melalui Apple Push Notification service yang memberi tahu WidgetKit untuk memuat ulang lini masa widget, sehingga nilai baru muncul tanpa widget pernah melakukan polling. Pembatas push opsional per widget menggabungkan sumber yang mengirim secara beruntun.

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

Sepuluh templat widget

Pilih tata letak yang cocok dengan datanya: satu nilai, bilah kemajuan, lampu status, pengukur, daftar statistik, sparkline tren, hitung mundur, tingkat baterai, jadwal, atau aliran antar titik. Setiap templat ditampilkan secara native oleh aplikasi PushWard, sehingga data Anda mendarat di tata letak yang rapi tanpa pekerjaan desain apa pun.

Jelajahi templat widget →

Widget interaktif yang bertindak

Widget dapat membawa hingga tiga aksi ketuk: memicu webhook senyap tanpa meninggalkan Layar Utama, menaut dalam ke aplikasi lain, atau membuka URL. Mulai ulang server, jalankan Pintasan, atau konfirmasi peringatan langsung dari widget — aplikasi PushWard tidak pernah perlu dibuka.

Bekerja dengan stack Anda

Isi widget dari alat yang sudah Anda jalankan: peringatan Grafana yang membalik lampu status, otomasi Home Assistant yang memperbarui suhu, job GitHub Actions yang menambah penghitung deploy, skrip cron yang melaporkan umur cadangan. Jika bisa mengirim permintaan HTTP, ia bisa memiliki widget.

Lihat semua integrasi →

Widget dan Aktivitas Langsung bersama-sama

Widget dan Aktivitas Langsung saling melengkapi: widget adalah status ambien yang bertahan di Layar Utama sampai dihapus, sementara Aktivitas Langsung adalah tugas dengan awal dan akhir yang menyematkan dirinya ke Layar Terkunci dan Dynamic Island selama berjalan. PushWard menggerakkan keduanya melalui REST API yang sama dan kunci integrasi yang sama.

Pelajari API Aktivitas Langsung →

Pertanyaan yang sering diajukan

Apakah ini API WidgetKit resmi dari Apple?

Bukan. WidgetKit adalah framework di perangkat milik Apple, dan menggunakannya langsung berarti membuat dan merilis aplikasi iOS sendiri dengan ekstensi widget. PushWard adalah API widget iOS yang independen: aplikasi PushWard membawa ekstensi WidgetKit, dan permintaan HTTP Anda menentukan apa yang ditampilkannya.

Seberapa cepat widget diperbarui?

Setiap PATCH memicu push ringan yang memberi tahu WidgetKit untuk memuat ulang widget, sehingga pembaruan biasanya tiba dalam hitungan detik. Pembatas push per widget (1 detik hingga 1 jam) menggabungkan sumber yang beruntun, menjaga penyegaran tetap dalam anggaran yang diberikan iOS kepada ekstensi.

Apakah widget berfungsi di Layar Terkunci dan mode Siaga?

Ya. Widget PushWard dapat ditambahkan ke Layar Utama, Layar Terkunci, dan mode Siaga iPhone. Slot aksesori ringkas di Layar Terkunci menampilkan tata letak padat, dan mengetuknya membuka aksi ketuk yang dikonfigurasi.

Apakah penerima perlu memasang aplikasi?

Ya — aplikasi iOS PushWard yang gratis (iOS 26 atau yang lebih baru) menampilkan widget dan mendaftarkannya di pemilih widget iOS. Tidak ada yang perlu Anda buat atau kirim ke App Store.

Coba API Widget iOS

Susun payload widget di playground dan saksikan ia ditampilkan di iPhone simulasi, atau baca panduan memulai dan daftarkan widget pertama Anda dengan curl dalam beberapa menit.