API Aktivitas Langsung iOS untuk apa pun yang berbicara HTTP

Apa itu Aktivitas Langsung?

Aktivitas Langsung adalah fitur iOS yang menampilkan informasi langsung dan mudah dibaca sekilas di Layar Terkunci, di Dynamic Island, dan dalam mode Siaga — tanpa penerima perlu membuka aplikasi. Berbeda dengan notifikasi push yang muncul sekali lalu tenggelam di daftar, Aktivitas Langsung tetap terpasang dan diperbarui secara real-time: build yang melewati langkah-langkahnya, timer yang menghitung mundur, pengiriman yang semakin dekat. PushWard mengubah satu permintaan HTTP menjadi hal itu.

Aktivitas Langsung Apple, tanpa ActivityKit

Aktivitas Langsung adalah fitur iOS dari Apple yang diperkenalkan di iOS 16.1: permukaan real-time yang mudah dibaca sekilas, terpasang di Layar Terkunci dan Dynamic Island. Membuatnya biasanya berarti merilis aplikasi iOS Anda sendiri dengan ekstensi widget ActivityKit, meminta token push-to-start, dan berbicara sendiri dengan APNs. PushWard menggantikan semua itu dengan satu REST API: aplikasi PushWard menampilkan Aktivitas Langsung Anda, dan satu permintaan HTTP memulai, memperbarui, atau mengakhirinya.

Cara kerja API

Buat aktivitas, mulai, perbarui, dan akhiri — semuanya melalui REST API PushWard dengan kunci integrasi Anda. Layanan apa pun yang bisa mengirim permintaan HTTP dapat mengendalikan apa yang orang lihat sekilas. Tidak ada sertifikat APNs dan tidak ada kode klien yang harus ditulis; PushWard menangani pengiriman melalui Apple Push Notification service.

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

Template untuk setiap jenis pembaruan

Pilih dari template Aktivitas Langsung yang dibuat untuk tugas berbeda — bilah progres generik, hitung mundur, urutan langkah, peringatan, pengukur, sparkline linimasa, papan ubin, atau log peristiwa langsung. Masing-masing punya tata letak yang disetel untuk Layar Terkunci dan Dynamic Island.

Jelajahi template →

Bekerja dengan stack Anda

Kirim Aktivitas Langsung dari alat yang sudah Anda jalankan. Bridge siap pakai dan relay webhook yang dihosting mencakup peringatan Grafana, otomasi Home Assistant, GitHub Actions, unduhan SABnzbd, cetakan Bambu Lab, sinkronisasi ArgoCD, dan apa pun yang bisa mengirim JSON.

Lihat semua integrasi →

Pertanyaan yang sering diajukan

Apakah ini API Aktivitas Langsung resmi dari Apple?

Bukan. Framework resmi Apple adalah ActivityKit, yang mengharuskan Anda membuat dan merilis aplikasi iOS sendiri. PushWard adalah API Aktivitas Langsung iOS yang independen: ia mengirimkan pembaruan Anda melalui Apple Push Notification service ke aplikasi PushWard, yang menampilkannya di Layar Terkunci dan di Dynamic Island.

Bisakah saya memulai Aktivitas Langsung dari server?

Bisa — justru itu intinya. Server, skrip, atau otomasi apa pun yang dapat mengirim permintaan HTTP bisa membuat, memulai, memperbarui, dan mengakhiri Aktivitas Langsung. PushWard menangani alur push-to-start Apple untuk Anda, sehingga aktivitas muncul tanpa penerima membuka aplikasi.

Apakah penerima perlu memasang aplikasi?

Ya — aplikasi iOS PushWard yang gratis menampilkan Aktivitas Langsung. Tidak ada yang perlu Anda buat, tanda tangani, atau kirim ke App Store; penerima memasang PushWard sekali dan permintaan Anda menggerakkan Layar Terkunci mereka.

iPhone mana saja yang mendukung Aktivitas Langsung?

Aplikasi PushWard memerlukan iOS 26 atau yang lebih baru. Di iPhone dengan Dynamic Island, Aktivitas Langsung bersandar di dalam island; di model tanpa Dynamic Island, ia muncul di Layar Terkunci dan dalam mode Siaga.

Coba API Aktivitas Langsung iOS

Saksikan Aktivitas Langsung muncul di iPhone simulasi di playground, atau baca panduan memulai dan kirim yang pertama dengan curl dalam beberapa menit.