验证 iOS 客户端是否为真实的 iOS 设备。如果请求有效,系统会在响应中发送收据,并通过 Apple 推送通知服务发送密钥。客户端应在后续调用(例如 /accounts:sendVerificationCode)中将这两个值发回给某些 Identity Platform API,以便验证客户端。请求标头中必须包含软件包 ID(x-ios-bundle-identifier
)。
请求中必须包含 API 密钥,以便识别 Google Cloud 项目。
HTTP 请求
POST https://identitytoolkit.googleapis.com/v1/accounts:verifyIosClient
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "appToken": string, "isSandbox": boolean } |
字段 | |
---|---|
appToken |
iOS 客户端在注册 APNs(Apple 推送通知服务)后获得的设备令牌。 |
isSandbox |
应用令牌是否位于 iOS 沙盒中。如果为 false,则表示应用令牌位于生产环境中。 |
响应正文
accounts.verifyIosClient 的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "receipt": string, "suggestedTimeout": string } |
字段 | |
---|---|
receipt |
收到应用令牌验证成功的通知。 |
suggestedTimeout |
客户端应等待多长时间(以秒为单位)才能收到推送通知的建议时间。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/identitytoolkit
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅 Authentication Overview。