HTTP konuşan her şey için iOS Canlı Etkinlik API'si

Canlı etkinlik nedir?

Canlı etkinlik, alıcı hiçbir uygulama açmadan kilitli ekranda, Dynamic Island'da ve Bekleme Modu'nda canlı, bir bakışta okunabilir bilgiler gösteren bir iOS özelliğidir. Bir kez görünüp listede kaybolan push bildirimlerinin aksine, canlı etkinlik sabit kalır ve gerçek zamanlı güncellenir: adımlarını ilerleten bir derleme, geriye sayan bir zamanlayıcı, yaklaşan bir teslimat. PushWard tek bir HTTP isteğini tam olarak buna dönüştürür.

Apple'ın canlı etkinlikleri, ActivityKit olmadan

Canlı etkinlikler, Apple'ın iOS 16.1 ile tanıttığı bir iOS özelliğidir: kilitli ekrana ve Dynamic Island'a sabitlenen, bir bakışta okunan gerçek zamanlı yüzeyler. Bir tane oluşturmak normalde ActivityKit widget uzantısı içeren kendi iOS uygulamanızı yayınlamak, push-to-start jetonları istemek ve APNs ile kendiniz konuşmak demektir. PushWard bunların hepsini tek bir REST API ile değiştirir: PushWard uygulaması canlı etkinliğinizi çizer; tek bir HTTP isteği onu başlatır, günceller veya sonlandırır.

API nasıl çalışır

Bir aktivite oluşturun, başlatın, güncelleyin ve sonlandırın — hepsi entegrasyon anahtarınızla PushWard'ın REST API'si üzerinden. HTTP isteği gönderebilen her servis, insanların bir bakışta gördüklerini yönetebilir. APNs sertifikası yok, yazılacak istemci kodu yok; teslimatı Apple Push Notification service üzerinden PushWard üstlenir.

# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "deploy", "name": "Deploy to production" }'

# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ongoing", "content": {
    "template": "generic", "progress": 0.2,
    "state": "Building...", "accent_color": "cyan"
  } }'

# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{ "state": "ended", "content": {
    "template": "generic", "progress": 1, "state": "Deployed"
  } }'

Her tür güncelleme için bir şablon

Farklı işler için tasarlanmış canlı etkinlik şablonları arasından seçim yapın — genel bir ilerleme çubuğu, geri sayım, adım dizisi, uyarı, gösterge, zaman çizelgesi sparkline'ı, karo panosu veya canlı olay günlüğü. Her birinin kilitli ekran ve Dynamic Island için ayarlanmış bir düzeni vardır.

Şablonlara göz atın →

Yığınınızla çalışır

Zaten çalıştırdığınız araçlardan doğrudan canlı etkinlikler gönderin. Hazır köprüler ve barındırılan bir webhook relay'i; Grafana uyarılarını, Home Assistant otomasyonlarını, GitHub Actions'ı, SABnzbd indirmelerini, Bambu Lab baskılarını, ArgoCD senkronizasyonlarını ve JSON gönderebilen diğer her şeyi kapsar.

Tüm entegrasyonları görün →

Sık sorulan sorular

Bu, Apple'ın resmi canlı etkinlik API'si mi?

Hayır. Apple'ın resmi çatısı, kendi iOS uygulamanızı oluşturup yayınlamanızı gerektiren ActivityKit'tir. PushWard bağımsız bir iOS canlı etkinlik API'sidir: güncellemelerinizi Apple Push Notification service üzerinden PushWard uygulamasına iletir; uygulama da bunları kilitli ekranda ve Dynamic Island'da çizer.

Bir sunucudan canlı etkinlik başlatabilir miyim?

Evet — bütün mesele bu. HTTP isteği gönderebilen her sunucu, betik veya otomasyon bir canlı etkinlik oluşturabilir, başlatabilir, güncelleyebilir ve sonlandırabilir. Apple'ın push-to-start akışını PushWard sizin yerinize yürütür; böylece etkinlik, alıcı uygulamayı açmadan görünür.

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

Evet — ücretsiz PushWard iOS uygulaması canlı etkinliği çizer. Sizin oluşturacağınız, imzalayacağınız ya da App Store'a göndereceğiniz hiçbir şey yok; alıcılar PushWard'ı bir kez yükler ve istekleriniz onların kilitli ekranını yönetir.

Hangi iPhone'lar canlı etkinlikleri destekliyor?

PushWard uygulaması iOS 26 veya üzerini gerektirir. Dynamic Island'lı iPhone'larda canlı etkinlik adaya yerleşir; onsuz modellerde kilitli ekranda ve Bekleme Modu'nda görünür.

iOS Canlı Etkinlik API'sini deneyin

Playground'da bir canlı etkinliğin simüle edilmiş bir iPhone'a düşüşünü izleyin veya başlangıç kılavuzunu okuyup ilkinizi birkaç dakika içinde curl ile gönderin.