API REST di autenticazione Firebase

Scambia token personalizzato con un ID e token di aggiornamento

Puoi scambiare un token Auth personalizzato con un ID e un token di aggiornamento inviando una richiesta HTTP POST all'endpoint Auth verifyCustomToken .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati al token personalizzato.

Risposta di esempio

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

Codici di errore comuni

• INVALID_CUSTOM_TOKEN: il formato del token personalizzato non è corretto o il token non è valido per qualche motivo (ad esempio scaduto, firma non valida ecc.)
• CREDENTIAL_MISMATCH: il token personalizzato corrisponde a un diverso progetto Firebase.

Scambia un token di aggiornamento con un token ID

Puoi aggiornare un token ID Firebase inviando una richiesta HTTP POST all'endpoint securetoken.googleapis.com .

Metodo: POST

Tipo di contenuto: application/x-www-form-urlencoded

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

Esempio di richiesta

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]'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il nuovo token ID Firebase e il token di aggiornamento.

Risposta di esempio

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

Codici di errore comuni

• TOKEN_EXPIRED: la credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• USER_DISABLED: l'account utente è stato disabilitato da un amministratore.
• USER_NOT_FOUND: l'utente corrispondente al token di aggiornamento non è stato trovato. È probabile che l'utente sia stato eliminato.
• Chiave API non valida. Trasmetti una chiave API valida. (chiave API fornita non valida)
• INVALID_REFRESH_TOKEN: è stato fornito un token di aggiornamento non valido.
• È stato ricevuto un payload JSON non valido. Nome sconosciuto \"refresh_tokens\": impossibile associare il parametro di query. Impossibile trovare il campo "refresh_tokens" nel messaggio di richiesta.
• INVALID_GRANT_TYPE: il tipo di concessione specificato non è valido.
• MISSING_REFRESH_TOKEN: nessun token di aggiornamento fornito.
• PROJECT_NUMBER_MISMATCH: il numero di progetto del token di aggiornamento non corrisponde a quello della chiave API fornita.

Iscriviti con email/password

Puoi creare un nuovo utente di posta elettronica e password inviando una richiesta HTTP POST all'endpoint Auth signupNewUser .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati al nuovo account.

Risposta di esempio

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

Codici di errore comuni

• EMAIL_EXISTS: l'indirizzo email è già utilizzato da un altro account.
• OPERATION_NOT_ALLOWED: l'accesso tramite password è disabilitato per questo progetto.
• TOO_MANY_ATTEMPTS_TRY_LATER: abbiamo bloccato tutte le richieste provenienti da questo dispositivo a causa di attività insolite. Riprovare più tardi.

Accedi con email/password

Puoi accedere come utente con un indirizzo email e una password inviando una richiesta HTTP POST all'endpoint Auth verifyPassword .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'account email/password esistente.

Risposta di esempio

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

Codici di errore comuni

• EMAIL_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.
• INVALID_PASSWORD: la password non è valida o l'utente non dispone di una password.
• USER_DISABLED: l'account utente è stato disabilitato da un amministratore.

Accedi in modo anonimo

Puoi accedere un utente in modo anonimo inviando una richiesta HTTP POST all'endpoint Auth signupNewUser .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente anonimo.

Risposta di esempio

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

Codici di errore comuni

• OPERATION_NOT_ALLOWED: l'accesso utente anonimo è disabilitato per questo progetto.

Accedi con le credenziali OAuth

È possibile accedere a un utente con credenziali OAuth inviando una richiesta HTTP POST all'endpoint Auth verifyAssertion .

Metodo: POST

Tipo di contenuto: application/json

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

Richiesta di esempio con token ID OAuth

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"id_token=[GOOGLE_ID_TOKEN]&providerId=[google.com]","requestUri":"[http://localhost]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con token ID OAuth

{
  "federatedId": "https://accounts.google.com/1234567890",
  "providerId": "google.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthIdToken": "[GOOGLE_ID_TOKEN]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Richiesta di esempio con token di accesso OAuth

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"access_token=[FACEBOOK_ACCESS_TOKEN]&providerId=[facebook.com]","requestUri":"[http://localhost]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con token di accesso OAuth

{
  "federatedId": "http://facebook.com/1234567890",
  "providerId": "facebook.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthAccessToken": "[FACEBOOK_ACCESS_TOKEN]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "https://scontent.xx.fbcdn.net/v/...",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Richiesta di esempio con credenziale Twitter OAuth 1.0

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"access_token=[TWITTER_ACCESS_TOKEN]&oauth_token_secret=[TWITTER_TOKEN_SECRET]&providerId=[twitter.com]","requestUri":"[http://localhost]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con credenziale Twitter OAuth 1.0

{
  "federatedId": "http://twitter.com/1234567890",
  "providerId": "twitter.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthAccessToken": "[OAUTH_ACCESS_TOKEN]",
  "oauthTokenSecret": "[OAUTH_TOKEN_SECRET]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "http://abs.twimg.com/sticky/...",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Codici di errore comuni

• OPERATION_NOT_ALLOWED: il provider corrispondente è disabilitato per questo progetto.
• INVALID_IDP_RESPONSE: la credenziale di autenticazione fornita non è valida o è scaduta.

Recupera i provider per la posta elettronica

Puoi cercare tutti i provider associati a un'e-mail specifica inviando una richiesta HTTP POST all'endpoint Auth createAuthUri .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

curl 'https://identitytoolkit.googleapis.com/v1/accounts:createAuthUri?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"identifier":"[user@example.com]","continueUri":"[http://localhost:8080/app]"}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene l'elenco dei fornitori associati all'e-mail.

Risposta di esempio

{
  "allProviders": [
    "password",
    "google.com"
  ],
  "registered": true
}

Codici di errore comuni

• INVALID_EMAIL: l'indirizzo email è formattato in modo errato.

Invia e-mail di reimpostazione della password

È possibile inviare un'e-mail di reimpostazione della password inviando una richiesta HTTP POST all'endpoint Auth getOobConfirmationCode .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
 "email": "[user@example.com]"
}

Codici di errore comuni

• EMAIL_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.

Verifica il codice di reimpostazione della password

È possibile verificare un codice di reimpostazione della password inviando una richiesta HTTP POST all'endpoint Auth resetPassword .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "email": "[user@example.com]",
  "requestType": "PASSWORD_RESET"
}

Codici di errore comuni

• OPERATION_NOT_ALLOWED: l'accesso tramite password è disabilitato per questo progetto.
• EXPIRED_OOB_CODE: il codice dell'azione è scaduto.
• INVALID_OOB_CODE: il codice dell'azione non è valido. Ciò può verificarsi se il codice non è valido, è scaduto o è già stato utilizzato.

Conferma la reimpostazione della password

È possibile applicare una modifica di reimpostazione della password inviando una richiesta HTTP POST all'endpoint Auth resetPassword .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

curl 'https://identitytoolkit.googleapis.com/v1/accounts:resetPassword?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"oobCode":"[PASSWORD_RESET_CODE]","newPassword":"[NEW_PASSWORD]"}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "email": "[user@example.com]",
  "requestType": "PASSWORD_RESET"
}

Codici di errore comuni

• OPERATION_NOT_ALLOWED: l'accesso tramite password è disabilitato per questo progetto.
• EXPIRED_OOB_CODE: il codice dell'azione è scaduto.
• INVALID_OOB_CODE: il codice dell'azione non è valido. Ciò può verificarsi se il codice non è valido, è scaduto o è già stato utilizzato.
• USER_DISABLED: l'account utente è stato disabilitato da un amministratore.

Cambia email

Puoi modificare l'e-mail di un utente inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il nuovo token ID Firebase e il token di aggiornamento associati all'utente.

Risposta di esempio

{
  "localId": "tRcfmLH7o2...",
  "email": "[user@example2.com]",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "password",
      "federatedId": "[user@example2.com]"
    }
  ],
  "idToken": "[NEW_ID_TOKEN]",
  "refreshToken": "[NEW_REFRESH_TOKEN]",
  "expiresIn": "3600"
}

Codici di errore comuni

• EMAIL_EXISTS: l'indirizzo email è già utilizzato da un altro account.
• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.

Cambiare la password

Puoi modificare la password di un utente inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il nuovo token ID Firebase e il token di aggiornamento associati all'utente.

Risposta di esempio

{
  "localId": "tRcfmLH7o2...",
  "email": "[user@example.com]",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "password",
      "federatedId": "[user@example.com]"
    }
  ],
  "idToken": "[NEW_ID_TOKEN]",
  "refreshToken": "[NEW_REFRESH_TOKEN]",
  "expiresIn": "3600"
}

Codici di errore comuni

• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• WEAK_PASSWORD: la password deve essere lunga 6 caratteri o più.

Aggiorna il profilo

Puoi aggiornare il profilo di un utente (nome visualizzato/URL della foto) inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

curl 'https://identitytoolkit.googleapis.com/v1/accounts:update?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary \
'{"idToken":"[ID_TOKEN]","displayName":"[NAME]","photoUrl":"[URL]","returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "localId": "tRcfmLH...",
  "email": "user@example2.com",
  "displayName": "John Doe",
  "photoUrl": "[http://localhost:8080/img1234567890/photo.png]",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "password",
      "federatedId": "user@example2.com",
      "displayName": "John Doe",
      "photoUrl": "http://localhost:8080/img1234567890/photo.png"
    }
  ],
  "idToken": "[NEW_ID_TOKEN]",
  "refreshToken": "[NEW_REFRESH_TOKEN]",
  "expiresIn": "3600"
}

Codici di errore comuni

• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.

Ottieni i dati dell'utente

Puoi ottenere i dati di un utente inviando una richiesta HTTP POST all'endpoint Auth getAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta conterrà tutte le informazioni dell'utente associate all'account.

Risposta di esempio

{
  "users": [
    {
      "localId": "ZY1rJK0...",
      "email": "user@example.com",
      "emailVerified": false,
      "displayName": "John Doe",
      "providerUserInfo": [
        {
          "providerId": "password",
          "displayName": "John Doe",
          "photoUrl": "http://localhost:8080/img1234567890/photo.png",
          "federatedId": "user@example.com",
          "email": "user@example.com",
          "rawId": "user@example.com",
          "screenName": "user@example.com"
        }
      ],
      "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg",
      "passwordHash": "...",
      "passwordUpdatedAt": 1.484124177E12,
      "validSince": "1484124177",
      "disabled": false,
      "lastLoginAt": "1484628946000",
      "createdAt": "1484124142000",
      "customAuth": false
    }
  ]
}

Codici di errore comuni

• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• USER_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.

Collegamento con e-mail/password

Puoi collegare un'e-mail/password a un utente corrente inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio

{
  "localId": "huDwUz...",
  "email": "user@example.com",
  "displayName": "John Doe",
  "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "password",
      "federatedId": "user@example.com"
    }
  ],
  "idToken": "[ID_TOKEN]",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "emailVerified": false
}

Codici di errore comuni

• CREDENTIAL_TOO_OLD_LOGIN_AGAIN: la credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• TOKEN_EXPIRED: la credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• WEAK_PASSWORD: la password deve essere lunga 6 caratteri o più.

Collegamento con credenziale OAuth

Puoi collegare una credenziale OAuth a un utente inviando una richiesta HTTP POST all'endpoint Auth verifyAssertion .

Metodo: POST

Tipo di contenuto: application/json

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

Richiesta di esempio con token ID OAuth

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"id_token=[GOOGLE_ID_TOKEN]&providerId=[google.com]","requestUri":"[http://localhost]","idToken":"[FIREBASE_ID_TOKEN]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con token ID OAuth

{
  "federatedId": "https://accounts.google.com/1234567890",
  "providerId": "google.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthIdToken": "[GOOGLE_ID_TOKEN]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Richiesta di esempio con token di accesso OAuth

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"access_token=[FACEBOOK_ACCESS_TOKEN]&providerId=[facebook.com]","idToken":"[FIREBASE_ID_TOKEN]","requestUri":"[http://localhost]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con token di accesso OAuth

{
  "federatedId": "http://facebook.com/1234567890",
  "providerId": "facebook.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthAccessToken": "[FACEBOOK_ACCESS_TOKEN]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "https://scontent.xx.fbcdn.net/v/...",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Richiesta di esempio con credenziale Twitter OAuth 1.0

curl 'https://identitytoolkit.googleapis.com/v1/accounts:signInWithIdp?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"postBody":"access_token=[TWITTER_ACCESS_TOKEN]&oauth_token_secret=[TWITTER_TOKEN_SECRET]&providerId=[twitter.com]","requestUri":"[http://localhost]","idToken":"[FIREBASE_ID_TOKEN]","returnIdpCredential":true,"returnSecureToken":true}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK . La risposta contiene il token ID Firebase e il token di aggiornamento associati all'utente autenticato.

Risposta di esempio con credenziale Twitter OAuth 1.0

{
  "federatedId": "http://twitter.com/1234567890",
  "providerId": "twitter.com",
  "localId": "5xwsPCWYo...",
  "emailVerified": true,
  "email": "user@example.com",
  "oauthAccessToken": "[OAUTH_ACCESS_TOKEN]",
  "oauthTokenSecret": "[OAUTH_TOKEN_SECRET]",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "displayName": "John Doe",
  "idToken": "[ID_TOKEN]",
  "photoUrl": "http://abs.twimg.com/sticky/...",
  "refreshToken": "[REFRESH_TOKEN]",
  "expiresIn": "3600",
  "rawUserInfo": "{\"updated_time\":\"2017-02-22T01:10:57+0000\",\"gender\":\"male\", ...}"
}

Codici di errore comuni

• OPERATION_NOT_ALLOWED: il provider corrispondente è disabilitato per questo progetto.
• INVALID_IDP_RESPONSE: la credenziale di autenticazione fornita non è valida o è scaduta.
• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• EMAIL_EXISTS: l'indirizzo email è già utilizzato da un altro account.
• FEDERATED_USER_ID_ALREADY_LINKED: questa credenziale è già associata a un account utente diverso.

Scollega fornitore

Puoi scollegare un provider da un utente corrente inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

curl 'https://identitytoolkit.googleapis.com/v1/accounts:update?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"idToken":"[FIREBASE_ID_TOKEN]","deleteProvider":["[facebook.com]"]}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "localId": "huDwUz...",
  "email": "user@example.com",
  "displayName": "John Doe",
  "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "google.com",
      "federatedId": "1234567890",
      "displayName": "John Doe",
      "photoUrl": "https://lh5.googleusercontent.com/.../photo.jpg"
    },
    {
      "providerId": "password",
      "federatedId": "user@example.com"
    }
  ],
  "emailVerified": "true"
}

Codici di errore comuni

• INVALID_ID_TOKEN: la credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.

Invia verifica via e-mail

Puoi inviare una verifica email per l'utente corrente emettendo una richiesta HTTP POST all'endpoint Auth getOobConfirmationCode .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

curl 'https://identitytoolkit.googleapis.com/v1/accounts:sendOobCode?key=[API_KEY]' \
-H 'Content-Type: application/json' \
--data-binary '{"requestType":"VERIFY_EMAIL","idToken":"[FIREBASE_ID_TOKEN]"}'

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "email": "user@example.com"
}

Codici di errore comuni

• INVALID_ID_TOKEN: la credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• USER_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.

Conferma la verifica dell'e-mail

Puoi confermare un codice di verifica email inviando una richiesta HTTP POST all'endpoint Auth setAccountInfo .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Risposta di esempio

{
  "localId": "FhyStE...",
  "email": "user@example.com",
  "passwordHash": "...",
  "providerUserInfo": [
    {
      "providerId": "password",
      "federatedId": "user@example.com"
    }
  ]
}

Codici di errore comuni

• EXPIRED_OOB_CODE: il codice dell'azione è scaduto.
• INVALID_OOB_CODE: il codice dell'azione non è valido. Ciò può verificarsi se il codice non è valido, è scaduto o è già stato utilizzato.
• USER_DISABLED: l'account utente è stato disabilitato da un amministratore.
• EMAIL_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.

Eliminare l'account

Puoi eliminare un utente corrente inviando una richiesta HTTP POST all'endpoint Auth deleteAccount .

Metodo: POST

Tipo di contenuto: application/json

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

Esempio di richiesta

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

Una richiesta riuscita è indicata da un codice di stato HTTP 200 OK .

Codici di errore comuni

• INVALID_ID_TOKEN: La credenziale dell'utente non è più valida. L'utente deve accedere nuovamente.
• USER_NOT_FOUND: non esiste alcun record utente corrispondente a questo identificatore. L'utente potrebbe essere stato eliminato.

Cancella account utente

Rimuovi tutti gli account nel progetto specificato, indipendentemente dallo stato.

Metodo: ELIMINA

Tieni presente che 9099 è la porta predefinita per l'emulatore di autenticazione. Controllare l'output del terminale per la porta effettivamente utilizzata.

http://localhost:9099/emulator/v1/projects/{project-id}/accounts

Ottieni la configurazione dell'emulatore

Ottieni la configurazione specifica dell'emulatore per il progetto specificato.

Metodo: OTTIENI

Tieni presente che 9099 è la porta predefinita per l'emulatore di autenticazione. Controllare l'output del terminale per la porta effettivamente utilizzata.

http://localhost:9099/emulator/v1/projects/{project-id}/config

Configurazione dell'emulatore patch

Aggiorna la configurazione specifica dell'emulatore per il progetto specificato.

Metodo: patch

Si noti che 9099 è la porta predefinita per l'emulatore di autenticazione. Controllare l'uscita del terminale per la porta effettiva utilizzata.

Content-Type: Application/JSON

http://localhost:9099/emulator/v1/projects/{project-id}/config

Recupera i codici di autenticazione fuori banda

Se i flussi di autenticazione che stai testando generano normalmente codici fuori banda (ad esempio, codici di verifica e-mail, codici di reimpostazione della password), l'emulatore memorizza tali codici internamente fino a quando non vengono utilizzati.

Metodo: ottenere

Si noti che 9099 è la porta predefinita per l'emulatore di autenticazione. Controllare l'uscita del terminale per la porta effettiva utilizzata.

http://localhost:9099/emulator/v1/projects/{project-id}/oobCodes

Recupera i codici di verifica SMS

Se stai testando i flussi di autenticazione del telefono/SMS, l'emulatore memorizza tali codici SMS internamente fino a quando non vengono utilizzati.

Metodo: ottenere

Si noti che 9099 è la porta predefinita per l'emulatore di autenticazione. Controllare l'uscita del terminale per la porta effettiva utilizzata.

http://localhost:9099/emulator/v1/projects/{project-id}/verificationCodes

Formato di risposta all'errore

Ogni volta che un errore viene restituito dal server backend per una delle API sopra, la risposta avrà il seguente formato.

Risposta del campione

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalid",
        "message": "CREDENTIAL_TOO_OLD_LOGIN_AGAIN"
      }
    ],
    "code": 400,
    "message": "CREDENTIAL_TOO_OLD_LOGIN_AGAIN"
  }
}

Il codice di errore è ottenuto dal campo del messaggio. Tutti i codici di errore di cui sopra si riferiscono al contenuto del campo del messaggio.