个推互联网推送服务器地址

个推推送服务器地址分类

个推的推送服务根据业务场景、协议类型和地域部署了多个服务器地址，开发者需根据实际需求选择对应的接入点,以下是主要分类：

主流推送协议对应的服务器地址

HTTP/HTTPS 协议

• 生产环境地址：
  • http://api.getui.com（默认端口80）
  • https://api.getui.com（默认端口443）
• 沙箱环境地址：
  • http://api.getui.com/sandbox（用于接口调试）
• 说明：HTTPS协议推荐优先使用，尤其在涉及敏感数据（如用户标识）时,可保障传输安全性。

TCP/UDP 协议

• 生产环境地址：
  • tcp.getui.com:6020（透传消息长连接）
  • udp.getui.com:6021（实时性要求高的场景）
• 说明：TCP协议适用于需要可靠传输的透传消息，UDP则适合对延迟敏感但允许少量丢包的场景（如实时弹幕）。

海外节点地址

• 东南亚节点：sea.api.getui.com
• 北美节点：na.api.getui.com
• 适用场景：面向海外用户的App,可减少跨境网络延迟。

服务器地址配置步骤

1. 获取AppID与AppKey：登录个推开发者后台,在应用管理中查看唯一标识。
2. 选择协议与环境：
   • 生产环境使用api.getui.com,测试环境使用沙箱地址。
   • 根据业务需求选择HTTP/HTTPS或TCP/UDP。
3. 集成SDK：
   • 在客户端集成个推SDK（如Android、iOS、Flutter等）,SDK内部已封装服务器地址逻辑。
   • 若直接调用HTTP API,需手动配置URL。
4. 验证连通性：
   • 使用curl或Postman发送测试请求，

     curl -X POST https://api.getui.com/v1/push 
     -H "Content-Type: application/json" 
     -d '{"appkey":"your_appkey","token":"device_token"}'

   • 若返回200 OK且推送成功,则地址配置正确。

常见问题与避坑指南

FAQs

问题1：如何确认当前使用的服务器地址是否为最新版本？

解答：
个推会定期更新服务器域名或IP，建议通过以下方式获取最新地址：

1. 登录个推开发者控制台（https://dev.getui.com），在“应用管理”中查看文档。
2. 联系个推技术支持（工单或客服电话），获取官方最新配置。
3. 检查SDK更新日志,新版本可能修复了服务器地址兼容性问题。

问题2：自建推送系统时，如何对接个推服务器地址？

解答：
若需将个推服务器地址集成到自建推送系统中，需注意：

1. 协议匹配：确保自建系统支持HTTP/HTTPS或TCP/UDP协议，并与个推接口兼容。
2. 鉴权机制：配置时需携带AppKey和AppSecret，部分接口还需签名（如MD5或HMAC）。
3. 容灾设计：建议同时配置多地域节点（如华东+华北），当主节点故障时自动切换备用地址。
4. 监控与报警：通过API返回状态码（如503表示服务不可用）监控服务器健康状态,及时告警。