# OneSignal: Korean > OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard. ## Korean - [Korean / 사용자 가이드 (178 pages)](https://documentation.onesignal.com/_llms/ko/tab-e7325d8b.md): Documentation for Korean / 사용자 가이드. ### 홈 - [OneSignal 문서](https://documentation.onesignal.com/docs/ko/home.md): OneSignal로 더 빠르게 구축을 시작하세요. 퀵스타트, SDK, 메시징 채널, API 레퍼런스 및 저니와 라이브 액티비티 같은 고급 기능을 살펴보세요. ### 개발자 가이드 #### 개발자 문서 - [개발자](https://documentation.onesignal.com/docs/ko/developers.md): OneSignal 모바일 및 웹 SDK를 설정하고, App ID와 API 키를 찾고, 사용자를 식별하고, 출시 전에 통합을 테스트하세요. - [신원 확인](https://documentation.onesignal.com/docs/ko/identity-verification.md): 서버에서 생성된 JWT를 요구하여 외부 사용자 ID, 이메일 및 SMS 구독을 확인함으로써 사용자 사칭을 방지합니다. ##### 사용자 모델 - [사용자 모델 및 마이그레이션 가이드](https://documentation.onesignal.com/docs/ko/user-model-migration-guide.md): OneSignal의 기기 중심 모델에서 보다 개인화된 다채널 참여를 위한 새로운 사용자 중심 API 및 SDK로 마이그레이션하는 방법을 알아보세요. - [모바일 SDK 매핑](https://documentation.onesignal.com/docs/ko/device-user-model-mobile-sdk-mapping.md): OneSignal의 레거시 Player 모델(v3 및 v4)과 최신 User 모델(v5+) 간의 메서드 및 속성 이름을 비교하고, 보다 쉬운 마이그레이션을 위한 Swift 코드 예제를 나란히 제공합니다. - [웹 SDK 매핑](https://documentation.onesignal.com/docs/ko/device-user-model-web-sdk-mapping.md): 레거시 Player 모델과 새로운 User 모델 간의 OneSignal 웹 SDK 메서드를 비교하세요. TypeScript 기반 코드 예제 및 업데이트된 메서드 참조를 통해 구현을 마이그레이션하는 방법을 알아보세요. #### 모바일 SDKs ##### 모바일 SDK 설정 - [모바일 SDK 설정](https://documentation.onesignal.com/docs/ko/mobile-sdk-setup.md): Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다. - [iOS SDK 설정](https://documentation.onesignal.com/docs/ko/ios-sdk-setup.md): OneSignal로 iOS 앱에 푸시 알림 및 인앱 메시지를 추가하는 방법. - [Android SDK 설정](https://documentation.onesignal.com/docs/ko/android-sdk-setup.md): Android Studio에서 OneSignal Android SDK를 설치해 푸시·인앱 메시지 추가. FCM 자격 증명, 초기화, 테스트 안내 - [Unity SDK 설정](https://documentation.onesignal.com/docs/ko/unity-sdk-setup.md): iOS, Android, Amazon, Huawei용 Unity 앱에 푸시 알림과 인앱 메시지를 추가하는 OneSignal Unity SDK 가이드입니다. 패키지 설치, 플랫폼별 자격 증명 구성, SDK 초기화와 알림 아이콘 설정, 테스트까지 단계별로 안내합니다. - [React Native SDK 설정](https://documentation.onesignal.com/docs/ko/react-native-sdk-setup.md): iOS, Android 및 Amazon 앱 플랫폼을 위한 OneSignal React Native SDK 통합 종합 가이드입니다. 전제 조건, 구성 단계, 플랫폼별 설정 및 일반적인 문제 해결이 포함됩니다. - [Expo SDK 설정](https://documentation.onesignal.com/docs/ko/react-native-expo-sdk-setup.md): 푸시 알림과 인앱 메시지를 위해 Expo SDK 53+ 및 EAS Build 환경에서 OneSignal Expo SDK를 iOS 및 Android 앱에 통합하는 방법을 안내합니다. 플러그인 구성, SDK 설치와 초기화, 테스트까지 단계별로 다룹니다. - [Flutter SDK 설정](https://documentation.onesignal.com/docs/ko/flutter-sdk-setup.md): iOS 및 Android용 Flutter 앱에 OneSignal Flutter SDK를 추가하는 방법 - [Flutterflow SDK 설정](https://documentation.onesignal.com/docs/ko/flutterflow-sdk-setup.md): iOS 및 Android용 Flutterflow 앱에 OneSignal Flutter SDK를 추가하는 방법 - [Cordova SDK 설정](https://documentation.onesignal.com/docs/ko/cordova-sdk-setup.md): iOS 및 Android용 Cordova, Ionic 앱에 푸시 알림과 인앱 메시지를 추가하는 OneSignal Cordova SDK 설정 가이드입니다. 플러그인 설치, 플랫폼 자격 증명 구성, SDK 초기화, 서비스 워커 관리와 테스트까지 안내합니다. - [Capacitor SDK 설정](https://documentation.onesignal.com/docs/ko/capacitor-sdk-setup.md): iOS와 Android의 Capacitor 앱에 푸시 알림을 추가하기 위한 OneSignal Capacitor SDK 설정. - [.NET MAUI SDK 설정](https://documentation.onesignal.com/docs/ko/net-sdk-setup.md): iOS, Android 및 Desktop용 크로스 플랫폼 MAUI 앱에 OneSignal .NET SDK를 추가하는 지침입니다. - [Amazon SDK 설정](https://documentation.onesignal.com/docs/ko/amazon-sdk-setup.md): 푸시 알림 및 인앱 메시징 기능을 위해 Amazon Fire OS 앱에 OneSignal SDK를 통합하는 단계별 가이드입니다. - [Huawei SDK 설정](https://documentation.onesignal.com/docs/ko/huawei-sdk-setup.md): Android Studio를 위한 OneSignal Huawei SDK 설정 가이드. ###### 플랫폼 자격 증명 설정 - [Android Firebase 자격 증명](https://documentation.onesignal.com/docs/ko/android-firebase-credentials.md): OneSignal에서 Firebase Cloud Messaging(FCM) Service Account 자격 증명을 구성하여 Google Play 스토어의 앱에 Android 푸시 알림을 활성화하세요. - [iOS p8 토큰 기반 APNs 연결](https://documentation.onesignal.com/docs/ko/ios-p8-token-based-connection-to-apns.md): .p8 인증 키를 설정하여 OneSignal을 통해 iOS 또는 macOS 앱을 Apple Push Notification service(APNs)에 연결합니다. - [iOS p12 인증서 생성](https://documentation.onesignal.com/docs/ko/ios-p12-generate-certificates.md): OneSignal을 통해 iOS 또는 macOS 앱을 Apple Push Notification service(APNs)에 연결하기 위한 .p12 푸시 인증서를 생성하고 업로드하세요. - [Amazon API 키 생성](https://documentation.onesignal.com/docs/ko/generate-an-amazon-api-key.md): 단계별 가이드 - [Huawei 승인](https://documentation.onesignal.com/docs/ko/authorize-onesignal-to-send-huawei-push.md): PushKit 설정, API 키 구성 및 중국 사용자가 있는 앱을 위한 Huawei의 선택적 메시지 자체 분류를 포함하여 푸시 알림을 위해 Huawei 앱을 OneSignal에 연결하는 단계별 가이드입니다. ##### 모바일 SDK 참조 - [모바일 SDK 레퍼런스](https://documentation.onesignal.com/docs/ko/mobile-sdk-reference.md): 초기화, 사용자 ID, 구독, 태그, 권한, 인앱 메시지, Live Activities 등을 다루는 OneSignal 모바일 SDK의 종합 API 레퍼런스입니다. Android, iOS, Unity, React Native, Flutter, Cordova/Ionic을 지원합니다. - [Mobile Service Extensions](https://documentation.onesignal.com/docs/ko/service-extensions.md): iOS 및 Android에서 표시 전에 푸시 알림을 가로채고 수정하는 Notification Service Extension 설정을 안내합니다. 리치 미디어, 확인된 전달, 사용자 지정 스타일, 백그라운드 데이터 처리와 무음 푸시 활용을 다룹니다. - [알림 트레이 관리](https://documentation.onesignal.com/docs/ko/managing-the-notification-tray.md): Android 및 iOS의 알림 트레이에서 OneSignal 모바일 푸시 알림이 동작하는 방식: 클릭 및 해제 처리, 복원된 알림, 배지, 프로그래밍 방식 알림 지우기, 서비스 확장. - [OSNotification payload](https://documentation.onesignal.com/docs/ko/osnotification-payload.md): 모든 payload 필드, Android 및 iOS 특정 속성, 사용자 지정 데이터 및 클릭 동작을 포함한 OneSignal의 OSNotification 객체에 대한 참조입니다. - [iOS: App Clip 지원](https://documentation.onesignal.com/docs/ko/app-clip-support.md): iOS App Clip에서 OneSignal 푸시 알림을 활성화하고 구성하는 방법을 알아보세요. 설정 단계, 제한 사항 및 Target-Content-ID와 같은 고급 경험에 대한 지원을 다룹니다. ##### 모바일 SDK 문제 해결 - [Mobile SDK 문제 해결](https://documentation.onesignal.com/docs/ko/mobile-troubleshooting.md): OneSignal Mobile SDK의 일반적인 문제를 해결하세요. iOS, Android 및 크로스 플랫폼 프레임워크 전반에 걸친 푸시 전달 실패, APNS 오류 및 인앱 메시지 문제가 포함됩니다. - [디버그 로그 가져오기](https://documentation.onesignal.com/docs/ko/capturing-a-debug-log.md): OneSignal SDK를 사용하여 모바일 앱에서 자세한 디버그 로그를 캡처하는 방법을 알아보세요. 이 가이드는 상세 로깅 활성화, 문제 재현 및 Android 및 iOS 플랫폼에서 푸시 알림 문제 해결을 위한 로그 공유를 안내합니다. #### 웹 SDKs - [웹 SDK 참조](https://documentation.onesignal.com/docs/ko/web-sdk-reference.md): 초기화, 로그인과 사용자 식별, 속성과 태그, 푸시 구독 관리, 슬라이드다운 프롬프트, 이벤트 리스너를 다루는 OneSignal 웹 SDK v16의 완전한 API 참조입니다. OneSignalDeferred 사용법과 디버깅 팁도 포함합니다. ##### 웹 SDK 설정 - [웹 SDK 설정](https://documentation.onesignal.com/docs/ko/web-sdk-setup.md): JavaScript SDK 초기화, 서비스 워커 업로드, 대시보드 구성으로 웹사이트에 OneSignal 웹 푸시 알림을 추가하는 설정 가이드입니다. Chrome, Firefox, Edge, Safari 등 주요 브라우저와 로컬호스트 테스트 옵션을 지원합니다. - [iOS 웹 푸시 설정](https://documentation.onesignal.com/docs/ko/web-push-for-ios.md): Safari, Chrome 및 Edge 브라우저에 대한 manifest 파일 설정, 사용자 온보딩 전략 및 구현 모범 사례를 포함하여 iOS 및 iPadOS 기기에서 웹 푸시 알림을 활성화하는 완벽한 가이드입니다. - [OneSignal service worker](https://documentation.onesignal.com/docs/ko/onesignal-service-worker.md): OneSignalSDKWorker.js 파일을 설정하고 구성하여 웹사이트가 OneSignal을 통해 웹 푸시 알림을 수신하고 표시할 수 있도록 합니다. - [OneSignal Web SDK를 사용한 사용자 지정 코드 웹 푸시 설정](https://documentation.onesignal.com/docs/ko/web-push-custom-code-setup.md): 사용자 지정 코드로 OneSignal 웹 푸시 알림을 설정하세요. JavaScript SDK를 추가하고, 서비스 워커를 구성하고, 사이트에서 OneSignal을 초기화하세요. - [Google Tag Manager 설정](https://documentation.onesignal.com/docs/ko/google-tag-manager.md): Google Tag Manager(GTM)를 사용하여 웹사이트에 OneSignal Web Push를 추가하는 방법. Service Worker 설정, 초기화 및 태그를 안전하게 설정하는 방법을 포함합니다. - [Angular 웹 SDK 설정](https://documentation.onesignal.com/docs/ko/angular-setup.md): onesignal-ngx 패키지를 사용하여 Angular 애플리케이션에 OneSignal 웹 푸시 알림을 통합하세요. 설치, 구성 및 서비스 워커 문제 해결 방법을 배워 원활한 푸시 알림을 제공하세요. - [ReactJS 및 NextJS 설정](https://documentation.onesignal.com/docs/ko/react-js-setup.md): 초기화, 서비스 워커 설정 및 TypeScript 지원을 포함하여 ReactJS 또는 NextJS 웹 애플리케이션과 OneSignal 푸시 알림을 통합하는 방법을 알아보세요. - [Vue JS Web SDK 설정](https://documentation.onesignal.com/docs/ko/vue-js-setup.md): onesignal-vue 또는 @onesignal/onesignal-vue3 플러그인을 사용하여 OneSignal 웹 푸시 알림을 Vue.js 애플리케이션에 통합하세요. 원활한 푸시 전달을 위해 Service Worker를 설치, 구성 및 사용자 지정하는 방법을 알아보세요. ##### 웹 SDK 문제 해결 - [Web SDK 문제 해결](https://documentation.onesignal.com/docs/ko/troubleshooting-web-push.md): 서비스 워커 오류, 출처 불일치, MIME 유형, 알림이 표시되지 않는 문제 등 OneSignal Web Push 문제를 해결하세요. - [캐시 지우기 및 푸시 권한 재설정](https://documentation.onesignal.com/docs/ko/clearing-cache-and-resetting-push-permissions.md): Chrome, Firefox 및 Safari에서 브라우저 푸시 권한, 서비스 워커 및 사이트 데이터를 재설정하여 깨끗한 테스트 환경을 보장하고 웹 푸시 알림 문제를 해결하는 방법을 알아보세요. - [웹 푸시 Webhook](https://documentation.onesignal.com/docs/ko/webhooks.md): 사용자가 웹 푸시 알림을 표시, 클릭 또는 해제할 때 실시간 알림을 받도록 HTTP Webhook을 설정합니다. Chrome, Firefox 및 Safari 브라우저 지원 예제가 포함된 완전한 가이드입니다. #### 실시간 현황 - [Live Activities 개발자 설정](https://documentation.onesignal.com/docs/ko/live-activities-developer-setup.md): OneSignal을 사용하여 iOS 앱에서 Live Activities를 설정하여 잠금 화면과 Dynamic Island에 실시간 업데이트를 표시합니다. - [크로스 플랫폼 Live Activity SDK 설정](https://documentation.onesignal.com/docs/ko/cross-platform-live-activity-setup.md): React Native, Flutter, Unity, Cordova, Capacitor, .NET MAUI 앱에 iOS Live Activities를 추가하세요. setupDefault로 SDK가 ActivityKit 라이프사이클을 관리해 네이티브 코드를 최소화합니다. - [Android Live Update 알림](https://documentation.onesignal.com/docs/ko/android-live-notifications.md): OneSignal 푸시 위에 Android Live Updates를 구축하세요. Notification Service Extension으로 구조화된 페이로드를 처리해 하나의 지속 알림을 제자리에서 업데이트하며 iOS Live Activities를 재현합니다. #### 데스크탑 & 워치 설정 - [macOS 앱 설정](https://documentation.onesignal.com/docs/ko/macos-app-setup.md): Mac Catalyst 또는 직접 API 액세스를 사용하여 OneSignal을 macOS 앱에 통합하는 방법을 알아보세요. 플랫폼 구성, SDK 설치 및 푸시 알림 전송에 대한 단계별 가이드입니다. - [Windows 앱 설정](https://documentation.onesignal.com/docs/ko/windows-app-setup.md): Windows Push Notification Service(WNS) 및 OneSignal의 REST API를 사용하여 Universal Windows Platform(UWP) 앱에 OneSignal 푸시 알림을 통합하는 완전한 가이드입니다 - [watchOS 및 Wear OS 지원](https://documentation.onesignal.com/docs/ko/watchos-and-wear-os-support.md): 설정 지침 및 API 통합을 포함하여 독립형 Apple watchOS 및 Android Wear OS 애플리케이션에 대한 OneSignal 푸시 알림 구현 완벽 가이드입니다. ### 튜토리얼 #### 튜토리얼 - [튜토리얼 및 사용 사례](https://documentation.onesignal.com/docs/ko/tutorials.md): OneSignal 기능을 구현하고 참여, 유지 및 수익을 높이는 데 도움이 되는 단계별 튜토리얼 및 모범 사례 예제를 살펴보세요. #### 🏢 산업별 - [게임 전략](https://documentation.onesignal.com/docs/ko/gaming-industry.md): 게임 메시징 구현 허브입니다. 플레이어 ID, 라이프사이클 태그, 행동 기반 Custom Events, 세그먼트 구성과 모바일 및 라이브 서비스 게임을 위한 Journey 플레이북, 플레이어 온보딩과 재참여 전략을 예제와 함께 다룹니다. - [금융 및 핀테크 전략](https://documentation.onesignal.com/docs/ko/financial-fintech-industry.md): 금융 및 핀테크 메시징 구현 허브입니다. 사용자 ID, KYC 및 보안 태그, 상품 보유·거래 Custom Events, 세그먼트 구성과 규정 준수, 인증, 교차 판매, 리텐션을 위한 Journey 플레이북, 다중 채널 인증 전략을 다룹니다. - [뉴스 및 미디어 전략](https://documentation.onesignal.com/docs/ko/news-and-media-industry.md): 뉴스 및 미디어 메시징 구현 허브입니다. 사용자 ID, 카테고리 관심사 태그, 읽기 행동 Custom Events, 세그먼트 구성과 독자 증대, 페이월 전환, 재참여를 위한 Journey 플레이북, 권한 프롬프트 모범 사례를 다룹니다. #### 📈 참여도 & 유지도 증가 - [장바구니 이탈 튜토리얼](https://documentation.onesignal.com/docs/ko/abandoned-cart.md): OneSignal을 사용하여 장바구니 이탈 알림으로 잃어버린 매출을 회복하세요. 장바구니 활동을 추적하고, 올바른 세그먼트를 구축하며, Journeys로 적시에 리마인더를 보내는 방법을 알아보세요. - [활동 피드 만들기](https://documentation.onesignal.com/docs/ko/create-an-activity-feed.md): OneSignal의 REST API, Event Streams 또는 기기 내 로직을 사용하여 사용자 알림 기록을 추적하고 표시하는 인앱 활동 피드를 구축하는 방법을 알아보세요. - [예약 확인](https://documentation.onesignal.com/docs/ko/booking-confirmations.md): 커스텀 이벤트, Journeys, Data Feeds를 사용해 실시간 예약 상태에 따라 예약 확인 이메일이나 복구 이메일을 자동 전송하는 튜토리얼입니다. 예약 시작·완료 이벤트 설정, 방치된 예약 리마인더 분기, 쿠폰 Data Feed를 다룹니다. - [버튼 기반 온보딩 캐러셀 구축하기](https://documentation.onesignal.com/docs/ko/in-app-onboarding-carousel-tutorial.md): 버튼 내비게이션과 자동 닫기 기능이 있는 HTML 인앱 메시지를 사용하여 다단계 온보딩 플로우를 만듭니다. - [소셜 활동](https://documentation.onesignal.com/docs/ko/social-activity.md): 좋아요, 팔로우, 다이렉트 메시지, 게임 이벤트 등 소셜 활동에 대한 푸시, 이메일, SMS 알림을 custom_data와 Create message API로 개인화해 전송하는 방법을 다룹니다. 사용자가 앱을 떠나 있을 때 재참여를 유도하세요. - [오래된 앱 버전을 타겟팅하여 앱 업데이트 권장](https://documentation.onesignal.com/docs/ko/app-version-update.md): 인앱 메시지를 사용하여 오래된 앱 버전을 감지하고 사용자에게 업데이트를 촉구하세요. iOS와 Android를 위한 플랫폼별 세그먼트를 포함합니다. - [앱 스토어 리뷰 더 많이 받기](https://documentation.onesignal.com/docs/ko/example-app-store-review.md): OneSignal 인앱 메시지와 네이티브 iOS 및 Android 리뷰 프롬프트를 사용하여 앱을 떠나지 않고 사용자에게 리뷰를 요청하고, 마찰을 줄이며 평점을 높이세요. - [배너 인앱 메시지로 사용자 온보딩](https://documentation.onesignal.com/docs/ko/example-create-a-tutorial.md): 앱 UI를 차단하지 않는 상황에 맞는 상단 및 하단 배너 인앱 메시지로 사용자를 안내합니다. #### 🔔 중요 또는 시간 민감한 메시지 전달 - [트랜잭션 메시지](https://documentation.onesignal.com/docs/ko/transactional-messages.md): OneSignal의 API를 사용하여 푸시, 이메일 또는 SMS를 통해 개인화된 데이터로 OTP, 청구 업데이트 및 알림과 같은 트랜잭션 메시지를 보내는 방법을 알아보세요. - [대체 메시지: 푸시를 사용할 수 없을 때 Email 또는 SMS](https://documentation.onesignal.com/docs/ko/push-fallback-method.md): OneSignal로 대체 전략을 구현하여 푸시 알림이 실패할 때 Email 또는 SMS를 통해 중요한 메시지가 전달되도록 하세요. Journey, API 및 세분화를 사용하여 신뢰할 수 있는 사용자 참여를 위한 크로스 채널 메시징을 설정하는 방법을 알아보세요. - [위치 기반 메시지](https://documentation.onesignal.com/docs/ko/location-triggered-event.md): OneSignal을 사용하여 국가, GPS 좌표 또는 지오펜스로 사용자를 세그먼트화하고 위치 트리거 푸시 알림을 보내세요. #### 🧠 타겟팅 & 개인화 강화 - [더 스마트한 타겟팅을 위한 주제 관심사 추적](https://documentation.onesignal.com/docs/ko/auto-segment-users-by-page-visit.md): 사용자가 방문하는 페이지와 푸시 알림을 구독한 페이지를 기반으로 OneSignal 태그를 지정하고 타겟 캠페인용 세그먼트를 만드세요. 주제별 카운터 태그와 구독 시 귀속 태그 두 가지 패턴을 웹, Android, iOS 코드 예제와 함께 설명합니다. - [인앱 메시지로 위치 권한 요청](https://documentation.onesignal.com/docs/ko/location-opt-in-prompt.md): 네이티브 Android 또는 iOS 위치 권한 요청을 트리거하기 전에 OneSignal에서 소프트 사전 프롬프트를 사용하여 모바일 앱에서 위치 추적을 활성화하도록 사용자를 안내합니다. - [피드백을 요청하는 설문조사 만들기](https://documentation.onesignal.com/docs/ko/example-create-a-survey.md): 분석 및 세그먼테이션을 위해 캐러셀, 버튼 클릭 작업, 결과 및 태그를 사용하여 다페이지 인앱 설문조사를 구축하세요. - [특정 Android 제조업체 및 기기 타겟팅](https://documentation.onesignal.com/docs/ko/example-target-certain-android-manufacturers-and-devices.md): 앱이 스와이프되면 푸시 알림을 차단하는 것으로 알려진 제조업체의 Android 기기를 식별 및 타겟팅하고, 인앱 메시지를 사용하여 사용자에게 올바른 설정을 활성화하도록 교육합니다. #### 🛠️ 사용자 경험 & 온보딩 개선 - [이메일에 대한 확인된 옵트인 설정](https://documentation.onesignal.com/docs/ko/double-opt-in-email.md): 태그, 세그먼트 및 Journeys를 사용하여 OneSignal에서 이중 옵트인(확인된 옵트인) 프로세스를 구현하여 참여도, 규정 준수 및 목록 품질을 개선하는 방법을 알아보세요. - [기본 설정 센터](https://documentation.onesignal.com/docs/ko/preference-center.md): OneSignal API를 사용하여 앱 또는 웹사이트에서 알림 주제, 빈도, 채널 및 데이터 개인정보 보호 설정을 관리하는 사용자 지정 사용자 기본 설정 센터를 구현하는 방법을 알아보세요. - [인증, 매직 링크, OTP 및 이중 옵트인 메시지 보내기](https://documentation.onesignal.com/docs/ko/example-verification-magic-link-otp.md): OneSignal을 사용한 이메일 및 SMS 인증 메시지의 예제로, 일회용 비밀번호, 매직 링크 및 템플릿과 API 예제가 포함된 이중 옵트인 플로우를 포함합니다. - [iOS: 이미지 캐러셀 푸시 알림](https://documentation.onesignal.com/docs/ko/ios-image-carousel-push-notifications.md): Swift를 사용하여 OneSignal iOS 푸시 알림에서 이미지 캐러셀을 구현하는 방법. ### API Reference #### Using the REST APIs - [REST API overview](https://documentation.onesignal.com/reference/rest-api-overview.md): Programmatic access to OneSignal messaging, user management, segments, Journeys, and data exports over HTTPS with rate limiting and retry support. - [Rate limits and error handling](https://documentation.onesignal.com/reference/rate-limits.md): Understand OneSignal API and application rate limits, common errors, retry behavior, and how to safely recover from failures without sending duplicate messages or disabling your app. #### API reference ##### Messages - [Sending messages with the OneSignal API](https://documentation.onesignal.com/reference/create-message.md): Send push notifications, emails, SMS, and Live Activities with the OneSignal API. Covers audience targeting, message composition, scheduling, and response handling. - [Idempotent API requests](https://documentation.onesignal.com/reference/idempotent-notification-requests.md): Prevent duplicate messages or custom events when retrying API requests. - [Push notification](https://documentation.onesignal.com/reference/push-notification.md): Send a message using the push notification channel. - [Email](https://documentation.onesignal.com/reference/email.md): Send a message using the email channel. - [SMS](https://documentation.onesignal.com/reference/sms.md): Send a message using the SMS channel. - [View message](https://documentation.onesignal.com/reference/view-message.md): View the details of a single message and the Outcomes associated with it. - [View messages](https://documentation.onesignal.com/reference/view-messages.md): View the details for a collection of messages. - [Cancel message](https://documentation.onesignal.com/reference/cancel-message.md): Stop a scheduled or currently outgoing message. - [Message history](https://documentation.onesignal.com/reference/message-history.md): View which subscriptions received a particular message - [Estimated recipients](https://documentation.onesignal.com/reference/count-unsaved.md): Returns the estimated number of recipients for a notification's targeting, without creating or sending anything. ##### Live Activities - [Start Live Activity](https://documentation.onesignal.com/reference/start-live-activity.md): Remotely start an iOS Live Activity with the OneSignal REST API, also known as push-to-start. Covers required body fields, choosing an activity_id, and audience targeting. - [Update Live Activity](https://documentation.onesignal.com/reference/update-live-activity-api.md): Update the content of a running iOS Live Activity or end it with the OneSignal REST API. Covers required body fields, update priority, and dismissal timing. ##### Custom Events - [Create custom events](https://documentation.onesignal.com/reference/create-custom-events.md): The Custom Events API allows you to record user events. Custom events can represent any action users take in your application, such as completing a purchase, viewing content, or achieving milestones. ##### Users - [Create user](https://documentation.onesignal.com/reference/create-user.md): Create a new user or modify the subscriptions associated with an existing User. - [View user](https://documentation.onesignal.com/reference/view-user.md): Retrieve a user including aliases, properties, and subscriptions. - [Update user](https://documentation.onesignal.com/reference/update-user.md): Modify a user's properties. - [Delete user](https://documentation.onesignal.com/reference/delete-user.md): Delete a user including all associated properties, subscriptions, and identity. - [View user identity](https://documentation.onesignal.com/reference/fetch-aliases.md): Retrieve all aliases associated with a user using a known alias, such as an `external_id`, `onesignal_id`, or a custom alias. This API helps you map back to a user's full identity from any one piece of identifying information. - [View user identity (by subscription)](https://documentation.onesignal.com/reference/fetch-identity-by-subscription.md): Retrieve all aliases linked to a user using a known `subscription_id`. This is useful when the user's identity is unknown but you have access to one of their push, email, or SMS subscriptions. - [Create or update alias](https://documentation.onesignal.com/reference/create-alias.md): Add or update aliases on an existing user when you already know one of that user's aliases, such as an external_id, onesignal_id, or custom alias. Updates the identity object only. - [Create alias (by subscription)](https://documentation.onesignal.com/reference/create-alias-by-subscription.md): Create or update an alias for a user using a known subscription ID. - [Delete alias](https://documentation.onesignal.com/reference/delete-alias.md): Remove a specific alias from a user. ##### Subscriptions - [Create Subscription by alias](https://documentation.onesignal.com/reference/create-subscription.md): Attach a new subscription (email, SMS, or push) to an existing OneSignal user identified by an alias. - [Update Subscription by ID](https://documentation.onesignal.com/reference/update-subscription.md): Update properties on an existing OneSignal subscription using its subscription_id. Commonly used to enable or disable a subscription when managing outside of the OneSignal SDK. - [Update Subscription by token](https://documentation.onesignal.com/reference/update-subscription-by-token.md): Update properties on an existing Subscription using its token. Commonly used to enable or disable subscription status when managing outside of the OneSignal SDK. - [Delete Subscription](https://documentation.onesignal.com/reference/delete-subscription.md): Delete a specific subscription by its subscription_id. This stops messages from being sent to that subscription but does not prevent future subscriptions with the same token. - [Transfer Subscription](https://documentation.onesignal.com/reference/transfer-subscription.md): Transfer a Subscription to a different user within the same OneSignal app. Useful for associating existing Subscriptions like push, email, or SMS with a new or updated user identity. - [Unsubscribe email with token](https://documentation.onesignal.com/reference/unsubscribe-with-token.md): Unsubscribe an email address from future messages by calling this API from your custom unsubscribe page. Automatically disables the associated email subscription using a token-based approach. ##### Templates - [Create template](https://documentation.onesignal.com/reference/create-template.md): Create reusable message templates for push, email, and SMS channels. Templates can be accessed through both the dashboard and API using a `template_id`. - [Update template](https://documentation.onesignal.com/reference/update-template.md): Update existing OneSignal message templates for push, email, or SMS. Changes apply immediately across dashboard and API usage via the `template_id` reference. - [View templates](https://documentation.onesignal.com/reference/view-templates.md): Retrieve a paginated list of message templates from your OneSignal app. This endpoint returns summary information for each template, including ID, name, creation, and update timestamps. - [View template](https://documentation.onesignal.com/reference/view-template.md): Retrieve the details of a specific message template in your OneSignal app using its template ID. This API returns the template content, target channel, and timestamps for creation and last update. - [Delete template](https://documentation.onesignal.com/reference/delete-template.md): Permanently delete a specific message template from your OneSignal app using its template ID. Templates used in Journeys must be removed from those Journeys before deletion. - [Copy template to another app](https://documentation.onesignal.com/reference/copy-template-to-another-app.md): Create a duplicate of a template in another app. The new template will be completely separate from the original (including having a new template_id) but will be created with all the same content. ##### Segments - [View segments](https://documentation.onesignal.com/reference/view-segments.md): Retrieve a list of segments associated with a specific OneSignal app. Useful for programmatically accessing segment metadata such as name, creation date, and status. - [View segment](https://documentation.onesignal.com/reference/view-segment.md): Retrieve details for a single segment by its ID, including subscriber count and optionally segment metadata and filters. - [Create segment](https://documentation.onesignal.com/reference/create-segments.md): Programmatically create segments in your OneSignal app using flexible filters and targeting rules. - [Update segment](https://documentation.onesignal.com/reference/update-segment.md): Update an existing segment's name and/or filters. The name parameter is always required. When filters are provided, all existing filters are replaced with the new ones. - [Delete segment](https://documentation.onesignal.com/reference/delete-segments.md): Delete segments from OneSignal. Does not delete users or subscriptions. ##### Journeys - [View journeys](https://documentation.onesignal.com/reference/view-journeys.md): Retrieve a paginated list of journeys for an app, with cursor-based pagination and a lightweight summary representation of each journey. - [View journey](https://documentation.onesignal.com/reference/view-journey.md): Retrieve the full configuration of a single journey by its UUID, including its audience, schedule, and node graph. - [View journey stats](https://documentation.onesignal.com/reference/view-journey-stats.md): Retrieve performance stats for a single journey, including journey-level counts, per-node counts, per-branch counts, and channel delivery stats. - [Create journey](https://documentation.onesignal.com/reference/create-journey.md): Create a new journey with an audience and a node graph. Journeys are always created in the draft state. - [Duplicate journey](https://documentation.onesignal.com/reference/duplicate-journey.md): Copy an existing journey into a new draft. You can apply overrides to the copy in the same request. - [Update journey](https://documentation.onesignal.com/reference/update-journey.md): Apply a partial update to a journey with JSON Merge Patch, and activate a draft journey by transitioning its state. - [Update journey node](https://documentation.onesignal.com/reference/update-journey-node.md): Apply a partial update to a single journey node, located by its server-assigned id, with JSON Merge Patch. - [Delete journey](https://documentation.onesignal.com/reference/delete-journey.md): Permanently delete a journey by its UUID. Deletion cannot be undone; archive a running journey instead if you need to keep its data. ##### Configuration - [View apps](https://documentation.onesignal.com/reference/view-apps.md): Retrieve a list of all OneSignal apps associated with your account, including key app details like name, App ID, subscription counts, and timestamps. Useful for managing multiple apps through the OneSignal API. - [View an app](https://documentation.onesignal.com/reference/view-an-app.md): View the details of a single OneSignal app - [Create an app](https://documentation.onesignal.com/reference/create-an-app.md): Programmatically create a new OneSignal app via the REST API. This guide explains required fields, supported platform configurations (Web, Android, iOS), and how to properly authenticate using your Organization API key. - [Update an app](https://documentation.onesignal.com/reference/update-an-app.md): Use to update the name or push platform configuration of an existing app. This guide explains required parameters and platform-specific update rules - [View API keys](https://documentation.onesignal.com/reference/view-api-keys.md): View the details of all of your current app API keys (Rich Authentication Token) for a single OneSignal app. - [Create API key](https://documentation.onesignal.com/reference/create-api-key.md): Use the OneSignal API to create a new Rich Authentication Token (App API Key) for a specific app. This guide explains how to authenticate with the Organization API key and configure optional IP allowlists using CIDR notation. - [Delete API key](https://documentation.onesignal.com/reference/delete-api-key.md): Delete a specific Rich Authentication Token (App API Key) for a OneSignal app. Requires your Organization API Key and the token's unique ID, not the token value itself. - [Update API key](https://documentation.onesignal.com/reference/update-api-key.md): Update a Rich Authentication Token (App API Key) for a OneSignal app. Modify the token's name or IP allowlist settings using your Organization API Key. - [Rotate API key](https://documentation.onesignal.com/reference/rotate-api-key.md): Rotate an existing App API Key (Rich Authentication Token) for a OneSignal app. Useful when a token is compromised or needs replacement without creating a new key from scratch. ##### Analytics - [Export subscriptions CSV](https://documentation.onesignal.com/reference/csv-export.md): Generate a GZip-compressed CSV export of your current subscription data using this API endpoint. - [Export audience activity CSV](https://documentation.onesignal.com/reference/export-csv-of-events.md): Export a compressed CSV report of audience-level delivery and engagement data for a specific message. This includes sent, delivered, clicked, failed, and unsubscribed events across Push, Email, and SMS channels. - [View outcomes](https://documentation.onesignal.com/reference/view-outcomes.md): View and export push notification outcome metrics such as clicks, conversions, and custom events. ##### Deprecated - [View players](https://documentation.onesignal.com/reference/view-devices.md): GET `https://onesignal.com/api/v1/players?app_id={app_id}&limit={limit}&offset={offset}` - [View player](https://documentation.onesignal.com/reference/view-device.md): GET https://onesignal.com/api/v1/players/{player_id} - [Add a player](https://documentation.onesignal.com/reference/add-a-device.md): POST `https://onesignal.com/api/v1/players` - [Edit player](https://documentation.onesignal.com/reference/edit-device.md): put https://onesignal.com/api/v1/players/{player_id} - [Edit tags with external user id](https://documentation.onesignal.com/reference/edit-tags-with-external-user-id.md): put https://onesignal.com/api/v1/apps/{app_id}/users/{external_user_id} - [Delete player record](https://documentation.onesignal.com/reference/delete-user-record.md): delete https://onesignal.com/api/v1/players/{player_id}?app_id={app_id} #### SDKs - [Server SDK 참조](https://documentation.onesignal.com/docs/ko/server-sdk-reference.md): Node.js, Python, Java, Go, PHP, Ruby, C#, Rust 백엔드에서 푸시 알림, 이메일, SMS를 보내기 위해 OneSignal 서버 SDK를 설치, 구성 및 사용합니다. ### Release Notes #### Release Notes - [Changelog](https://documentation.onesignal.com/release-notes/changelog.md): Follow the OneSignal changelog for new features, product updates, and bug fixes across push, email, SMS, in-app messages, Journeys, and analytics. - [SDK Releases](https://documentation.onesignal.com/release-notes/sdk-releases.md): View the latest OneSignal SDK releases and updates. ## OpenAPI Specs - [openapi](/openapi.json) ## Optional - [Blog](https://onesignal.com/blog) - [GitHub](https://github.com/OneSignal) - [YouTube](https://www.youtube.com/@onesignalofficial/playlists)