認証
プッシュシステムAPI¶
プッシュシステムは、APIを使用してプッシュを送信します。このシステムは、各マーケットからのAPNS、FCM、ADMなどのプッシュサービスを利用しています。以下の画像は、リクエストデータがサービスにどのように送信されるかを説明しています。
Note
- APNS (Apple Push Notification Service): Appleのプッシュサービス
(https://developers.apple.com/go/?id=push-notifications)
- FCM (Firebase Cloud Messaging): Googleによるプッシュサービス
(https://firebase.google.com/docs/cloud-messaging)
- ADM (Amazon Device Messaging): Amazonのプッシュサービス
プッシュシステムは、ペイロード構成に適したトークンデータを検索し、そのデータを各サービスに転送します。デバイスにプッシュメッセージを送信するのは各サービスの役割です。簡単に言えば、プッシュシステムはサービスの呼び出しプロセスが成功したかどうかを追跡するだけであり、受信されなかったデバイスの原因を分析することはサポートされていません。
Tip
APNSは、各アプリのビルドおよび配布環境（本番環境とサンドボックス）に対して専用のエンドポイントを提供します。
- 本番: api.push.apple.com
- サンドボックス: api.sandbox.push.apple.com
APNSの本番またはサンドボックス環境で発行されたデバイストークンは、対応するエンドポイントでのみ有効であり、他の環境では使用できません。詳細については、公式Appleドキュメントを参照してください。
Hiveプッシュシステムは、登録されたAppIDの**サービスタイプ**に基づいて、サンドボックスまたは本番エンドポイントのいずれかを使用します。
- **サービスタイプ**が'TEST'の場合 → サンドボックスエンドポイントを使用
- **サービスタイプ**が'TEST'でない場合 → プロダクションエンドポイントを使用
Warning
Hiveプッシュシステムは、APNSが提供する「production」と「sandbox」の両方のエンドポイントを同時に使用することはできません。サポートされているのは1つのエンドポイントのみです。
登録されたAppIDの**サービスタイプ**を任意に変更すると、無効なエンドポイントをリクエストする可能性があります。**サービスタイプ**は、運用環境に応じて設定してください。詳細については、AppID管理を参照してください。
URL¶
| サーバー | URL |
|---|---|
| 本番 | https://notification.withhive.com |
| サンドボックス | https://sandbox-notification.withhive.com |
認証¶
Pushシステムが提供するAPIを実装するには、認証トークン（API KEY）が必要です。認証トークンはJWT（JSON Web Token: https://jwt.io）仕様に従い、有効期限が制限されていないため、このトークンを使い続けることができます。AppCenterにゲームを登録すると、認証トークンが自動的に作成されます。詳細については、操作 > AppCenter > ゲーム管理 > 1. 基本情報をご覧ください。