푸시 발송 API
HIVE 푸시 시스템은 API를 이용해 푸시를 발송합니다. 각 마켓에서 제공하는 서비스(APNS, FCM, ADM, Facebook)를 이용하고 있으며, 요청 데이터는 아래 그림과 같은 과정으로 서비스에 전달됩니다.
- 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)- Facebook (App-to-User Notification): 페이스북 푸시
(https://developers.facebook.com/docs/games/gaming-services/gaming-services-sdk/appnotifications)
푸시 시스템은 요청 조건에 맞는 토큰 데이터를 찾아 payload를 구성하고, 각 서비스에 전달하는 역할을 담당합니다. 이후 푸시 메시지를 단말에 전송하는 과정은 각 서비스에서 수행하고 있습니다. 다시 말해, 푸시 시스템이 서비스 호출 과정의 성공 여부를 추적할 뿐 실제 단말에서 미 수신했을 때 원인을 파악하는 기능은 지원하지 않습니다.
환경별 접근 URL
| 서버 | URL |
| Production | https://notification.withhive.com |
| Sandbox | https://sandbox-notification.withhive.com |
| Test | https://test-notification.withhive.com |
인증 방식
HIVE 푸시 시스템이 제공하는 API를 사용하려면 먼저 인증토큰(API KEY)을 발급받아야 합니다. 인증토큰은 JWT(JSON Web Token: https://jwt.io) 명세를 따르며, 만료 시간이 없어 고정적으로 사용할 수 있습니다. 인증 토큰은 앱센터에 게임이 등록되면 자동으로 생성됩니다. 운영 > 앱센터 > 게임 관리 > 1. 기본정보 에서 확인하세요.