HTTP를 말하는 모든 것을 위한 iOS 실시간 현황 API

실시간 현황이란 무엇인가요?

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

ActivityKit 없이 쓰는 Apple 실시간 현황

실시간 현황은 iOS 16.1에서 도입된 Apple의 iOS 기능으로, 잠금 화면과 Dynamic Island에 고정되어 한눈에 들어오는 실시간 표시 영역입니다. 원래는 이를 만들려면 ActivityKit 위젯 익스텐션을 포함한 자체 iOS 앱을 출시하고, push-to-start 토큰을 요청하고, APNs와 직접 통신해야 합니다. PushWard는 그 모든 것을 REST API 하나로 대체합니다. 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"
  } }'

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

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

템플릿 둘러보기 →

여러분의 스택과 함께 작동

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

모든 통합 보기 →

자주 묻는 질문

이것이 Apple의 공식 실시간 현황 API인가요?

아니요. Apple의 공식 프레임워크는 ActivityKit이며, 자체 iOS 앱을 만들어 출시해야 합니다. PushWard는 독립적인 iOS 실시간 현황 API입니다. 여러분의 업데이트를 Apple Push Notification service를 통해 PushWard 앱에 전달하고, 앱이 이를 잠금 화면과 Dynamic Island에 렌더링합니다.

서버에서 실시간 현황을 시작할 수 있나요?

네 — 그게 바로 핵심입니다. HTTP 요청을 보낼 수 있는 서버, 스크립트, 자동화라면 무엇이든 실시간 현황을 생성·시작·업데이트·종료할 수 있습니다. Apple의 push-to-start 흐름은 PushWard가 대신 처리하므로, 수신자가 앱을 열지 않아도 현황이 나타납니다.

수신자가 앱을 설치해야 하나요?

네 — 무료 PushWard iOS 앱이 실시간 현황을 렌더링합니다. 여러분이 만들거나 서명하거나 App Store에 제출할 것은 아무것도 없습니다. 수신자는 PushWard를 한 번만 설치하면 되고, 여러분의 요청이 수신자의 잠금 화면을 움직입니다.

어떤 iPhone이 실시간 현황을 지원하나요?

PushWard 앱에는 iOS 26 이상이 필요합니다. Dynamic Island가 있는 iPhone에서는 실시간 현황이 아일랜드에 자리 잡고, 없는 모델에서는 잠금 화면과 스탠바이에 나타납니다.

iOS 실시간 현황 API 사용해 보기

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