身份验证
推送系統 API¶
推送系统通过使用API发送推送。该系统利用来自各个市场的推送服务，如APNS、FCM和ADM。以下图描述了请求数据如何传输到服务。
Note
- APNS (Apple 推送通知服务): 与 Apple 的推送服务
(https://developers.apple.com/go/?id=push-notifications)
- FCM (Firebase Cloud Messaging)：與 Google 的推送服務
(https://firebase.google.com/docs/cloud-messaging)
- ADM (Amazon 设备消息服务): 亚马逊的推送服务
推送系统管理搜索适合的令牌数据以进行有效负载组合，并将数据传输到每个服务。向设备发送推送消息是每个服务的职责。简而言之，推送系统仅跟踪服务的调用过程是否成功，不支持分析未接收设备的原因。
Tip
APNS 為每個應用程序版本和分發環境（生產和沙盒）提供專用端點。
- 生產環境: api.push.apple.com
- 沙盒環境: api.sandbox.push.apple.com
在 APNS 生产或沙盒环境中发出的设备令牌仅对相应的端点有效，不能在其他环境中使用。有关更多详细信息，请参阅 官方 Apple 文档。
Hive推送系統根據註冊的AppID的**服務類型**使用沙盒或生產端點。
- 如果**服務類型**為'TEST' → 使用沙盒端點
- 如果**服務類型**不是'TEST' → 使用生產端點
Warning
Hive 推送系统不能同时使用 APNS 提供的“生产”和“沙盒”端点；仅支持一个端点。
如果您随意更改已注册的 AppID 的 服务类型，可能会请求无效的端点。请确保根据您的操作环境设置 服务类型。有关更多详细信息，请参阅 AppID 管理。
URL¶
| 伺服器 | URL |
|---|---|
| 生產 | https://notification.withhive.com |
| 沙盒 | https://sandbox-notification.withhive.com |
認證¶
要實現推送系統提供的API，需要授權令牌（API KEY）。授權令牌遵循JWT（JSON Web Token: https://jwt.io）規範，沒有過期時間的限制，因此可以持續使用此令牌。在AppCenter中註冊遊戲後，授權令牌會自動創建。詳細信息請參見操作 > AppCenter > 遊戲管理 > 1. 基本信息。