iOS Live Activity API cho mọi thứ biết nói HTTP
PushWard là một iOS Live Activity API: gửi một yêu cầu HTTP duy nhất và nó xuất hiện trực tiếp trên Lock Screen 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.
Live Activity là gì?
Live Activity 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 Lock Screen, trong Dynamic Island và ở StandBy — 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, Live Activity 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 đó.
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 Live Activity đượ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 Lock Screen và Dynamic Island.
Hoạt động với stack của bạn
Gửi Live Activities 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.
Dùng thử iOS Live Activity API
Xem một Live Activity 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.