API Hoạt động trực tiếp trên iOS cho mọi thứ biết nói HTTP
PushWard là một API cho Hoạt động trực tiếp của Apple: gửi một yêu cầu HTTP duy nhất và nó xuất hiện trực tiếp trên Màn hình khóa và Dynamic Island của iPhone, cập nhật theo thời gian thực và tự biến mất khi nhiệm vụ hoàn tất. Không cần mã ActivityKit, không Xcode, không phải qua xét duyệt App Store từ phía bạn.
Hoạt động trực tiếp là gì?
Hoạt động trực tiếp là một tính năng của iOS hiển thị thông tin trực tiếp, dễ nắm bắt trong nháy mắt trên Màn hình khóa, trong Dynamic Island và ở Chế độ chờ — mà người nhận không bao giờ phải mở ứng dụng. Khác với thông báo đẩy chỉ xuất hiện một lần rồi chìm vào danh sách, Hoạt động trực tiếp luôn được ghim và cập nhật theo thời gian thực: một bản build đang đi qua các bước, một bộ đếm ngược, một đơn giao hàng đang đến gần. PushWard biến một yêu cầu HTTP duy nhất thành chính điều đó.
Hoạt động trực tiếp của Apple, không cần ActivityKit
Hoạt động trực tiếp là một tính năng iOS của Apple ra mắt từ iOS 16.1: những bề mặt thời gian thực, dễ nắm bắt trong nháy mắt, được ghim vào Màn hình khóa và Dynamic Island. Thông thường, để xây dựng một cái, bạn phải phát hành ứng dụng iOS của riêng mình với phần mở rộng widget ActivityKit, xin token push-to-start và tự giao tiếp với APNs. PushWard thay thế tất cả bằng một REST API duy nhất: ứng dụng PushWard hiển thị Hoạt động trực tiếp của bạn, và một yêu cầu HTTP duy nhất sẽ khởi động, cập nhật hoặc kết thúc nó.
API hoạt động thế nào
Tạo một activity, khởi động, cập nhật và kết thúc nó — tất cả qua REST API của PushWard với khóa tích hợp của bạn. Bất kỳ dịch vụ nào gửi được yêu cầu HTTP đều có thể điều khiển những gì mọi người thấy trong nháy mắt. Không có chứng chỉ APNs, không phải viết mã phía client; PushWard lo việc chuyển phát qua 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"
} }'Một mẫu cho mọi loại cập nhật
Chọn từ các mẫu Hoạt động trực tiếp được thiết kế cho những công việc khác nhau — thanh tiến trình chung, đếm ngược, chuỗi bước, cảnh báo, đồng hồ đo, sparkline dòng thời gian, bảng ô hay nhật ký sự kiện trực tiếp. Mỗi mẫu có bố cục được tinh chỉnh cho Màn hình khóa và Dynamic Island.
Hoạt động với stack của bạn
Gửi các Hoạt động trực tiếp thẳng từ những công cụ bạn đang vận hành. Các cầu nối dựng sẵn và một relay webhook được lưu trữ sẵn bao phủ cảnh báo Grafana, tự động hóa Home Assistant, GitHub Actions, tải xuống SABnzbd, bản in Bambu Lab, đồng bộ ArgoCD và bất cứ thứ gì khác gửi được JSON.
Câu hỏi thường gặp
Đây có phải là API Hoạt động trực tiếp chính thức của Apple không?
Không. Framework chính thức của Apple là ActivityKit, đòi hỏi bạn phải xây dựng và phát hành ứng dụng iOS của riêng mình. PushWard là một API Hoạt động trực tiếp trên iOS độc lập: nó chuyển các bản cập nhật của bạn qua Apple Push Notification service tới ứng dụng PushWard, và ứng dụng này hiển thị chúng trên Màn hình khóa và trong Dynamic Island.
Tôi có thể khởi động Hoạt động trực tiếp từ máy chủ không?
Có — đó chính là mục đích. Bất kỳ máy chủ, tập lệnh hay quy trình tự động nào gửi được yêu cầu HTTP đều có thể tạo, khởi động, cập nhật và kết thúc một Hoạt động trực tiếp. PushWard xử lý luồng push-to-start của Apple thay bạn, nên hoạt động xuất hiện mà người nhận không cần mở ứng dụng.
Người nhận có cần cài ứng dụng không?
Có — ứng dụng iOS miễn phí PushWard sẽ hiển thị Hoạt động trực tiếp. Bạn không phải xây dựng, ký hay nộp gì lên App Store; người nhận cài PushWard một lần và các yêu cầu của bạn điều khiển Màn hình khóa của họ.
Những iPhone nào hỗ trợ Hoạt động trực tiếp?
Ứng dụng PushWard yêu cầu iOS 26 trở lên. Trên các iPhone có Dynamic Island, Hoạt động trực tiếp sẽ neo vào đảo; trên các mẫu máy không có, nó xuất hiện trên Màn hình khóa và trong Chế độ chờ.
Dùng thử API Hoạt động trực tiếp trên iOS
Xem một Hoạt động trực tiếp xuất hiện trên iPhone mô phỏng trong playground, hoặc đọc hướng dẫn bắt đầu và gửi cái đầu tiên bằng curl trong vài phút.