Method: accounts.verifyIosClient

Verifies an iOS client is a real iOS device. If the request is valid, a reciept will be sent in the response and a secret will be sent via Apple Push Notification Service. The client should send both of them back to certain Identity Platform APIs in a later call (for example, /accounts:sendVerificationCode), in order to verify the client. The bundle ID is required in the request header as x-ios-bundle-identifier.

An API key is required in the request in order to identify the Google Cloud project.

HTTP request

POST https://identitytoolkit.googleapis.com/v1/accounts:verifyIosClient

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "appToken": string,
  "isSandbox": boolean
}
Fields
appToken

string

A device token that the iOS client gets after registering to APNs (Apple Push Notification service).

isSandbox

boolean

Whether the app token is in the iOS sandbox. If false, the app token is in the production environment.

Response body

If successful, the response body contains data with the following structure:

Response message for accounts.verifyIosClient.

JSON representation
{
  "receipt": string,
  "suggestedTimeout": string
}
Fields
receipt

string

Receipt of successful app token validation.

suggestedTimeout

string (int64 format)

Suggested time that the client should wait in seconds for delivery of the push notification.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.