Usar a API REST

Troque um token personalizado por um ID e um token de atualização

Pode trocar uma chave de autorização personalizada por uma chave de ID e uma chave de atualização emitindo um pedido HTTP POST para o ponto final signInWithCustomToken.

Método: POST

Content-Type: application/json

https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken?key=[API_KEY]

Pedido de amostra

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"token":"[CUSTOM_TOKEN]","returnSecureToken":true}'

Um pedido bem-sucedido é indicado por um código de estado HTTP 200 OK. A resposta contém o token de ID e o token de atualização da Identity Platform associados ao token personalizado.

Exemplo de resposta

{
  "idToken": "[ID_TOKEN]",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600"
}

Códigos de erro comuns

• INVALID_CUSTOM_TOKEN: o formato do token personalizado está incorreto ou o token é inválido por algum motivo (por exemplo, expirou, assinatura inválida, etc.)
• CREDENTIAL_MISMATCH: o token personalizado corresponde a um Google Cloud projeto diferente.

Troque um token de atualização por um token de ID

Pode atualizar um token de ID da Identity Platform emitindo um pedido HTTP POST para o ponto final securetoken.googleapis.com.

Método: POST

Content-Type: application/x-www-form-urlencoded

https://securetoken.googleapis.com/v1/token?key=[API_KEY]

Pedido de amostra

curl 'https://securetoken.googleapis.com/v1/token?key=[API_KEY]' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data 'grant_type=refresh_token&refresh_token=[REFRESH_TOKEN]'

Um pedido bem-sucedido é indicado por um código de estado HTTP 200 OK. A resposta contém o novo token de atualização e token de ID da Identity Platform.

Exemplo de resposta

{
  "expires_in": "3600",
  "token_type": "Bearer",
  "refresh_token": "[REFRESH_TOKEN]",
  "id_token": "[ID_TOKEN]",
  "user_id": "tRcfmLH7o2XrNELi...",
  "project_id": "1234567890"
}

Códigos de erro comuns

• TOKEN_EXPIRED: a credencial do utilizador já não é válida. O utilizador tem de iniciar sessão novamente.
• USER_DISABLED: a conta de utilizador foi desativada por um administrador.
• USER_NOT_FOUND: não foi encontrado o utilizador correspondente ao token de atualização. É provável que o utilizador tenha sido eliminado.
• A chave da API não é válida. Transmita uma chave da API válida. (chave da API inválida fornecida)
• INVALID_REFRESH_TOKEN: foi fornecido um token de atualização inválido.
• Payload JSON inválido recebido. Nome desconhecido "refresh_tokens": não é possível associar o parâmetro de consulta. Não foi possível encontrar o campo "refresh_tokens" na mensagem de pedido.
• INVALID_GRANT_TYPE: o tipo de autorização especificado é inválido.
• MISSING_REFRESH_TOKEN: nenhum token de atualização fornecido.
• PROJECT_NUMBER_MISMATCH: o número do projeto do token de atualização não corresponde ao da chave da API fornecida.

Inscreva-se com email / palavra-passe

Pode criar um novo utilizador com email e palavra-passe enviando um pedido HTTP POST para o ponto final de autenticação signupNewUser.

Método: POST

Content-Type: application/json

https://identitytoolkit.googleapis.com/v1/accounts:signUp?key=[API_KEY]

Pedido de amostra

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signUp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"email":"[user@example.com]","password":"[PASSWORD]","returnSecureToken":true}'

Um pedido bem-sucedido é indicado por um código de estado HTTP 200 OK. A resposta contém o token de ID e o token de atualização da Identity Platform associados à nova conta.

Exemplo de resposta

{
  "idToken": "[ID_TOKEN]",
  "email": "[user@example.com]",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "localId": "tRcfmLH7..."
}

Códigos de erro comuns

• EMAIL_EXISTS: o endereço de email já está a ser usado por outra conta.
• OPERATION_NOT_ALLOWED: O início de sessão com palavra-passe está desativado para este projeto.
• TOO_MANY_ATTEMPTS_TRY_LATER: Bloqueámos todos os pedidos deste dispositivo devido a atividade invulgar. Tente mais tarde.

Inicie sessão com email / palavra-passe

Pode iniciar sessão num utilizador com um email e uma palavra-passe emitindo um pedido HTTP POST para o ponto final de autenticação verifyPassword.

Método: POST

Content-Type: application/json

https://identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=[API_KEY]

Pedido de amostra

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"email":"[user@example.com]","password":"[PASSWORD]","returnSecureToken":true}'

Um pedido bem-sucedido é indicado por um código de estado HTTP 200 OK. A resposta contém o token de ID e o token de atualização do Identity Platform associados à conta de email/palavra-passe existente.

Exemplo de resposta

{
  "localId": "ZY1rJK0eYLg...",
  "email": "[user@example.com]",
  "displayName": "",
  "idToken": "[ID_TOKEN]",
  "registered": true,
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600"
}

Códigos de erro comuns

• EMAIL_NOT_FOUND: não existe nenhum registo de utilizador correspondente a este identificador. O utilizador pode ter sido eliminado.
• INVALID_PASSWORD: a palavra-passe é inválida ou o utilizador não tem uma palavra-passe.
• USER_DISABLED: a conta de utilizador foi desativada por um administrador.

Inicie sessão anonimamente

Pode iniciar sessão num utilizador anonimamente emitindo um pedido HTTP POST para o ponto final de autenticação signupNewUser.

Método: POST

Content-Type: application/json

https://identitytoolkit.googleapis.com/v1/accounts:signUp?key=[API_KEY]

Pedido de amostra

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signUp?key=[API_KEY]' \
-H 'Content-Type: application/json' --data-binary '{"returnSecureToken":true}'

Um pedido bem-sucedido é indicado por um código de estado HTTP 200 OK. A resposta contém o token de atualização e o token de ID da Identity Platform associados ao utilizador anónimo.

Exemplo de resposta

{
  "idToken": "[ID_TOKEN]",
  "email": "",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "localId": "Jws4SVjpT..."
}

Códigos de erro comuns

• OPERATION_NOT_ALLOWED: o início de sessão de utilizadores anónimos está desativado para este projeto.

Inicie sessão com a credencial do OAuth

Pode iniciar sessão num utilizador com uma credencial OAuth emitindo um pedido HTTP POST para o ponto final verifyAssertion de autenticação.

Método: POST

Content-Type: application/json

https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]