PUSH API · v1a

지원 범위

현재 지원

Android와 iOS 네이티브 SDK: 앱 설치 등록, 주소 갱신·정확한 해제, 알림 권한 관측, 앱 수신 설정, 영속 동기화.
FCM FID 또는 기존 등록 토큰 모드, APNs 샌드박스·APNs 프로덕션. 앱이 푸시 서비스 설정과 OS 콜백을 소유합니다.
새 SDK의 간편 초기화는 서버의 BASIC/VERIFIED 정책을 자동으로 읽어요. 인증 모드는 프로젝트 환경마다 하나이고 그 환경의 모든 앱에 적용돼요. 프로젝트 환경의 첫 앱은 BASIC으로 시작하고, 나중에 추가한 앱은 그 환경의 모드를 따라요. BASIC은 external ID를 사용하고 VERIFIED는 신뢰할 수 있는 고객 백엔드가 세션을 확인한 JWT가 필요해요. 정책 조회 실패는 BASIC으로 전환되지 않아요. SDK가 기기 인증·연결·재시도를 관리해요. 기존 identify/logout/transfer와 동시에 사용하거나 앱에 서버 키·개인 키를 넣지 마세요.
OS_DISPLAY 알림, 공개 API의 개별·다중 대상 메시지, 허용된 전체 발송, 상태·개별 발송 조회와 운영 제어. 각 기능의 권한과 활성화 조건을 확인해야 합니다.
선택형 iOS 이미지 Notification Service Extension, 호스트가 등록한 iOS 버튼, 호스트 foreground 알림용 Android 버튼 helper. SDK 설치만으로 확장이 설치되거나 버튼이 등록되지는 않습니다.
실제 수신·클릭 기록은 메시지 track_events와 SDK notificationEventsEnabled가 모두 켜져 있어야 해요. 새 SDK 소스는 기본 수집 ON이며 저장된 거부가 우선해요. 대시보드의 새 메시지는 기록 ON으로 시작하지만, 기존 초안·복제본이나 API에서 생략한 값은 바꾸지 않아요.

지원한다고 약속하지 않는 것

웹 푸시, 브라우저 SDK, React Native·Flutter 래퍼, macOS 앱 SDK는 이 네이티브 연동 문서의 지원 대상이 아닙니다.
메시지 API의 display_path에 APP_DISPLAY를 직접 지정할 수는 없어요. Android의 SDK 직접 표시는 호환 SDK가 등록한 기능을 바탕으로 서버가 자동 선택해요. 임의 필드나 지원되지 않는 enum을 추가하지 마세요.
전체 기기 전달·화면 표시·클릭률을 측정한다고 보장하지 않습니다. 선택형 콜백 관측에는 유실이 있으며 클릭이 수신을 자동 생성하지 않습니다. Android background OS_DISPLAY의 임의 버튼도 지원하지 않습니다.
Maven Central이나 공개 Swift Package URL로 즉시 설치할 수 있다고 가정하지 마세요. 승인된 배포물과 호환 버전을 확인해야 합니다.
정적 문서에는 키를 입력하는 체험 화면이나 실제 발송 버튼이 없습니다. 서비스 가용성·발송 성공률·배포 일정도 약속하지 않습니다.