HTTP를 말하는 모든 것을 위한 iOS Live Activity API

Live Activity란 무엇인가요?

Live Activity는 수신자가 앱을 열지 않아도 Lock Screen, Dynamic Island, StandBy에서 실시간 정보를 한눈에 보여 주는 iOS 기능입니다. 한 번 나타났다가 목록에 묻히는 푸시 알림과 달리, Live Activity는 고정된 채 실시간으로 업데이트됩니다. 단계를 밟아 가는 빌드, 카운트다운하는 타이머, 점점 가까워지는 배송. PushWard는 HTTP 요청 하나를 바로 그것으로 바꿉니다.

API 작동 방식

액티비티를 만들고, 시작하고, 업데이트하고, 종료하세요 — 모두 통합 키와 함께 PushWard의 REST API를 통해 이뤄집니다. HTTP 요청을 보낼 수 있는 서비스라면 무엇이든 사람들이 한눈에 보는 내용을 움직일 수 있습니다. APNs 인증서도, 작성할 클라이언트 코드도 없습니다. 전달은 PushWard가 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"
  } }'

모든 종류의 업데이트를 위한 템플릿

서로 다른 용도에 맞춘 Live Activity 템플릿 중에서 고르세요 — 범용 진행 표시줄, 카운트다운, 단계 시퀀스, 경보, 게이지, 타임라인 스파크라인, 타일 보드, 실시간 이벤트 로그. 각 템플릿은 Lock Screen과 Dynamic Island에 맞게 다듬어진 레이아웃을 갖추고 있습니다.

템플릿 둘러보기 →

여러분의 스택과 함께 작동

이미 운영 중인 도구에서 바로 Live Activities를 보내세요. 준비된 브리지와 호스팅형 webhook relay가 Grafana 경보, Home Assistant 자동화, GitHub Actions, SABnzbd 다운로드, Bambu Lab 프린트, ArgoCD 동기화, 그리고 JSON을 보낼 수 있는 모든 것을 지원합니다.

모든 통합 보기 →

iOS Live Activity API 사용해 보기

playground에서 시뮬레이션된 iPhone에 Live Activity가 도착하는 모습을 보거나, 시작 가이드를 읽고 몇 분 안에 curl로 첫 번째를 보내 보세요.