鉴权地址
推送系统 API¶
推送系统通过使用API发送推送。该系统利用来自各个市场的推送服务，如APNS、FCM和ADM。以下图描述了请求数据如何传输到服务。
Note
- APNS (苹果推送通知服务): 与苹果的推送服务
(https://developers.apple.com/go/?id=push-notifications)
- FCM (Firebase 云消息传递): 与 Google 的推送服务
(https://firebase.google.com/docs/cloud-messaging)
- ADM (亚马逊设备消息服务)：与亚马逊的推送服务
推送系统管理搜索适合的令牌数据以进行有效负载组合，并将数据传输到每个服务。向设备发送推送消息是每个服务的职责。简而言之，推送系统只是跟踪服务的调用过程是否成功，不支持分析未接收设备的原因。
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. 基本信息。