인증
푸시 발송 API¶
HIVE 푸시 시스템은 API를 이용해 푸시를 발송합니다. 각 마켓에서 제공하는 서비스(APNS, FCM, ADM)를 이용하고 있으며, 요청 데이터는 아래 그림과 같은 과정으로 서비스에 전달됩니다.
Note
-
APNS (Apple Push Notification Service): 애플 푸시 (https://developers.apple.com/go/?id=push-notifications)
-
FCM (Firebase Cloud Messaging): 구글 푸시 (https://firebase.google.com/docs/cloud-messaging)
-
ADM (Amazon Device Messaging): 아마존 푸시 (https://developer.amazon.com/docs/adm/overview.html)
푸시 시스템은 요청 조건에 맞는 토큰 데이터를 찾아 payload를 구성하고, 각 서비스에 전달하는 역할을 담당합니다. 이후 푸시 메시지를 단말에 전송하는 과정은 각 서비스에서 수행하고 있습니다. 다시 말해, 푸시 시스템이 서비스 호출 과정의 성공 여부를 추적할 뿐 실제 단말에서 미 수신했을 때 원인을 파악하는 기능은 지원하지 않습니다.
Tip
APNS에서는 앱 빌드 및 배포 환경(프로덕션 및 샌드박스)별로 전용 엔드포인트를 제공합니다.
- 프로덕션: api.push.apple.com
- 샌드박스: api.sandbox.push.apple.com
APNS의 프로덕션 및 샌드박스 환경에서 발급된 디바이스 토큰은 각 발급한 환경에 해당하는 엔드포인트에서만 유효하며, 이외 환경에서는 사용할 수 없습니다. 자세한 내용은 Apple 공식 문서를 참고하세요.
Hive 푸시 시스템은 등록한 AppID의 서비스 타입 에 따라 샌드박스 혹은 프로덕션 엔드포인트를 사용합니다.
- 서비스 타입 이 'TEST'인 경우 → 샌드박스 엔드포인트 사용
- 서비스 타입 이 'TEST'가 아닌 경우 → 프로덕션 엔드포인트 사용
Warning
Hive 푸시 시스템은 APNS에서 제공하는 '프로덕션' 및 '샌드박스' 엔드포인트를 동시에 사용할 수 없으며, 두 엔드포인트 중 하나만 지원합니다.
등록한 AppID의 서비스 타입 을 임의로 변경하면 유효하지 않은 엔드포인트를 요청할 수 있으므로, 운영 환경에 맞는 서비스 타입 을 설정하세요. 자세한 내용은 AppID 관리를 참고하세요.
환경별 접근 URL¶
| 서버 | URL |
|---|---|
| Production | https://notification.withhive.com https://notification.qpyou.cn |
| Sandbox | https://sandbox-notification.withhive.com https://sandbox-notification.qpyou.cn |
인증 방식¶
HIVE 푸시 시스템이 제공하는 API를 사용하려면 먼저 인증토큰(API KEY)을 발급받아야 합니다. 인증토큰은 JWT(JSON Web Token: https://jwt.io) 명세를 따르며, 만료 시간이 없어 고정적으로 사용할 수 있습니다. 인증 토큰은 앱센터에 게임이 등록되면 자동으로 생성됩니다. 운영 > 앱센터 > 게임 관리 > 1. 기본정보 에서 확인하세요.