Apple Push 通知
通过 HTTP/2 从 Delphi 向 api.push.apple.com 发送 APNs 推送通知。同时支持基于证书和基于令牌(JWT ES256)的身份验证。
通过 HTTP/2 从 Delphi 向 api.push.apple.com 发送 APNs 推送通知。同时支持基于证书和基于令牌(JWT ES256)的身份验证。
将 TsgcHTTP2Client(HTTP/2 传输)与 TsgcHTTP_JWT_Client(ES256 令牌生成)配合使用以驱动 APNs — 这是 Apple 在旧版二进制协议停用后推荐的组合。
TsgcHTTP2Client + TsgcHTTP_JWT_Client
Windows, macOS, Linux, iOS, Android
Standard / Professional / Enterprise
使用您的 APNs ES256 私钥和 Key/Team ID 配置 TsgcHTTP_JWT_Client,将其链接到 TsgcHTTP2Client.Authentication.Token.JWT,然后向 /3/device/<token> POST JSON 载荷。
uses
sgcHTTP, sgcBase_Helpers;
var
HTTP2: TsgcHTTP2Client;
JWT: TsgcHTTP_JWT_Client;
begin
JWT := TsgcHTTP_JWT_Client.Create(nil);
JWT.JWTOptions.Header.alg := jwtES256;
JWT.JWTOptions.Header.kid := 'APPLE-KEY-ID';
JWT.JWTOptions.Payload.iss := 'APPLE-TEAM-ID';
JWT.JWTOptions.Payload.iat := StrToInt64(GetDateTimeUnix(Now, False));
JWT.JWTOptions.Algorithms.ES.PrivateKey.LoadFromFile('AuthKey_XXX.p8');
JWT.JWTOptions.RefreshTokenAfter := 40 * 60;
HTTP2 := TsgcHTTP2Client.Create(nil);
HTTP2.TLSOptions.IOHandler := iohSChannel;
HTTP2.Authentication.Token.JWT := JWT;
HTTP2.Request.CustomHeaders.Clear;
HTTP2.Request.CustomHeaders.Add('apns-topic: com.example.app');
HTTP2.Post(
'https://api.push.apple.com/3/device/' ,
'{"aps":{"alert":"hello","sound":"default"}}');
end;
// uses: sgcHTTP
TsgcHTTP_JWT_Client *JWT = new TsgcHTTP_JWT_Client(this);
JWT->JWTOptions->Header->alg = jwtES256;
JWT->JWTOptions->Header->kid = "APPLE-KEY-ID";
JWT->JWTOptions->Payload->iss = "APPLE-TEAM-ID";
JWT->JWTOptions->Algorithms->ES->PrivateKey->LoadFromFile("AuthKey_XXX.p8");
TsgcHTTP2Client *HTTP2 = new TsgcHTTP2Client(this);
HTTP2->Authentication->Token->JWT = JWT;
HTTP2->Request->CustomHeaders->Add("apns-topic: com.example.app");
HTTP2->Post("https://api.push.apple.com/3/device/" , payload);
两个协作组件端到端处理 APNs — HTTP/2 帧处理和 JWT 生成。
使用您的 Apple AuthKey_*.p8 私钥签署的 ES256 JWT。JWT 客户端每 40 分钟自动刷新令牌(Apple 要求在一小时内轮换)。
对于旧版通用证书,设置 TLSOptions.CertFile + Password 并清除 Authentication.Token.JWT。TLS 握手对连接进行身份验证。
将 URL 指向 api.push.apple.com(生产)或 api.development.push.apple.com(沙盒)— 相同组件,只需更改主机。
按 Apple 文档设置 Request.CustomHeaders,包括 apns-topic、apns-priority、apns-push-type、apns-collapse-id、apns-expiration。
单条 TLS 连接每分钟可发送数千条推送 — HTTP/2 流对请求进行多路复用。每次调用后检查 Response.Status 获取传递结果。
在 Windows 上使用 iohSChannel 进行内核模式 TLS(无需 DLL),或使用 iohOpenSSL 用于跨平台服务器部署。
本组件所实现 API 的权威来源。