HTTP konuşan her şey için iOS Widget API'si

PushWard, Apple'ın iOS widget'ları için bir API'dir: widget'ı bir kez tanımlayın; ardından iPhone ana ekranını, kilitli ekranı ve Bekleme Modu'nu sade HTTP istekleriyle yönetin. Her güncelleme push güdümlü bir WidgetKit yenilemesi tetikler — sorgulama yok, WidgetKit kodu yok, Xcode yok, sizin tarafınızda App Store incelemesi yok.

iOS ana ekran widget'ı nedir?

Widget'lar Apple'ın bir bakışta okunan yüzeyleridir: iPhone ana ekranında, kilitli ekranda ve Bekleme Modu'nda her zaman görünür duran, bir uygulama açmadan bilgi gösteren küçük kutucuklar. Apple'ın cihaz üstü çatısı WidgetKit ile oluşturulurlar ve normalde her biri, sizin oluşturup imzalayıp yayınlamanız gereken bir uygulamaya aittir. PushWard'ın widget'ları farklıdır: onları PushWard uygulaması çizer ve içerikleri API çağrılarınızdan gelir — bir sensör değeri, bir sunucu sağlık kontrolü, bir dağıtım sayacı, JSON olarak gönderilebilen her şey.

API nasıl çalışır

Bir widget'ı POST ile kaydedin, sonra PATCH ile güncelleyin — bütün döngü bu. Her güncelleme, Apple Push Notification service üzerinden WidgetKit'e widget'ın zaman çizelgesini yeniden yüklemesini söyleyen hafif bir push gönderir; böylece yeni değer, widget hiç sorgulama yapmadan görünür. İsteğe bağlı widget başına push kısıtlayıcı, ani yoğunluk yaratan kaynakları birleştirir.

HTTP üzerinden bir widget kaydedin ve güncelleyin

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

On widget şablonu

Veriye uyan düzeni seçin: tek bir değer, ilerleme çubuğu, durum ışığı, gösterge, istatistik listesi, eğilim mini grafiği, geri sayım, pil düzeyi, program veya uç noktalar arası akış. Her şablon PushWard uygulaması tarafından yerel olarak çizilir; verileriniz hiçbir tasarım çalışması gerektirmeden özenli bir düzene oturur.

Widget şablonlarına göz atın →

Harekete geçen etkileşimli widget'lar

Widget'lar en fazla üç dokunma eylemi taşıyabilir: ana ekrandan ayrılmadan sessiz bir webhook tetikleyin, derin bağlantıyla başka bir uygulamaya geçin veya bir URL açın. Bir sunucuyu yeniden başlatın, bir Kestirme tetikleyin ya da bir uyarıyı doğrudan widget'tan onaylayın — PushWard uygulamasının hiç açılması gerekmez.

Teknoloji yığınınızla çalışır

Widget'ları zaten kullandığınız araçlardan besleyin: durum ışığını değiştiren bir Grafana uyarısı, sıcaklığı güncelleyen bir Home Assistant otomasyonu, dağıtım sayacını artıran bir GitHub Actions işi, yedeğin yaşını bildiren bir cron betiği. HTTP isteği gönderebiliyorsa bir widget'ın sahibi olabilir.

Tüm entegrasyonları görün →

Widget'lar ve canlı etkinlikler birlikte

Widget'lar ve canlı etkinlikler birbirini tamamlar: widget, kaldırılana dek ana ekranda duran kalıcı, ortam düzeyinde bir durumdur; canlı etkinlik ise çalıştığı sürece kendini kilitli ekrana ve Dynamic Island'a sabitleyen, başı ve sonu olan bir görevdir. PushWard ikisini de aynı REST API ve aynı entegrasyon anahtarıyla yönetir.

Canlı etkinlik API'sini öğrenin →

Sık sorulan sorular

Bu, Apple'ın resmi WidgetKit API'si mi?

Hayır. WidgetKit, Apple'ın cihaz üstü çatısıdır ve onu doğrudan kullanmak, widget uzantılı kendi iOS uygulamanızı oluşturup yayınlamak demektir. PushWard bağımsız bir iOS widget API'sidir: WidgetKit uzantısını PushWard uygulaması taşır; ne göstereceğine HTTP istekleriniz karar verir.

Widget'lar ne kadar hızlı güncellenir?

Her PATCH, WidgetKit'e widget'ı yeniden yüklemesini söyleyen hafif bir push tetikler; bu yüzden güncellemeler genellikle saniyeler içinde ulaşır. Widget başına push kısıtlayıcı (1 saniye - 1 saat), ani yoğunluk yaratan kaynakları birleştirerek yenilemeleri iOS'in uzantıya tanıdığı bütçe içinde tutar.

Widget'lar kilitli ekranda ve Bekleme Modu'nda çalışır mı?

Evet. PushWard widget'ları iPhone ana ekranına, kilitli ekrana ve Bekleme Modu'na eklenebilir. Kilitli ekranın kompakt aksesuar yuvaları yoğunlaştırılmış bir düzen çizer; birine dokunmak, yapılandırılmış dokunma eylemini açar.

Alıcıların yüklü bir uygulamaya ihtiyacı var mı?

Evet — ücretsiz PushWard iOS uygulaması (iOS 26 veya üzeri) widget'ları çizer ve onları iOS widget seçicisine kaydeder. Sizin oluşturacağınız ya da App Store'a göndereceğiniz hiçbir şey yok.

iOS Widget API'sini deneyin

Playground'da bir widget yükü oluşturup simüle edilmiş bir iPhone'da çizilişini izleyin veya başlangıç kılavuzunu okuyup ilk widget'ınızı birkaç dakika içinde curl ile kaydedin.