> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ottenere l’identità dell’utente connesso

> Leggi i claim di identità concessi a una connessione OAuth.

Leggi i claim di identità concessi a una connessione OAuth.

```http theme={null}
GET https://api.voicecheap.ai/oauth/userinfo
```

## Autenticazione

Invia un token di accesso OAuth in Authorization: Bearer. Deve includere openid; i claim email richiedono anche email. Le chiavi API e le credenziali nei parametri di query non sono accettate.

## Esempi di richiesta

Segui la codifica e l'autenticazione documentate per questa route. L'involucro e le regole di idempotenza dell'API delle azioni si applicano solo alle invocazioni di azioni.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET 'https://api.voicecheap.ai/oauth/userinfo' \
    --header "Authorization: Bearer $VOICECHEAP_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const input = {};
  const response = await fetch('https://api.voicecheap.ai/oauth/userinfo', {
    method: 'GET',
    headers: {
      Authorization: `Bearer ${process.env.VOICECHEAP_ACCESS_TOKEN}`,
    },
    redirect: 'manual',
  });
  console.log(response.status, await response.text());
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.request(
      "GET",
      "https://api.voicecheap.ai/oauth/userinfo",
      headers={"Authorization":"Bearer " + os.environ["VOICECHEAP_ACCESS_TOKEN"]},
      timeout=120,
      allow_redirects=False,
  )
  print(response.status_code, response.text)
  ```
</RequestExample>

## Risposta

Leggi i claim di identità concessi a una connessione OAuth.

```json HTTP 200 theme={null}
{
  "sub": "voicecheap-user-id",
  "email": "customer@example.com",
  "email_verified": false
}
```

## Intestazioni della risposta

```json theme={null}
{
  "Cache-Control": "no-store",
  "Pragma": "no-cache"
}
```

## Note sull'operazione

* Gli endpoint OpenID Connect restituiscono HTTP 404 quando l’integrazione di identità non è disponibile in questo ambiente. Controlla la discovery prima di basarti sulle funzioni di identità.
* sub è l’identificatore stabile dell’account. email ed email\_verified sono inclusi solo se email è stato concesso e l’account ha un indirizzo email. email\_verified riflette lo stato di verifica effettivo e può essere false. Gli account eliminati o disattivati non possono usare UserInfo.

## Errori

| Stato HTTP | Codice | Significato o risoluzione |
| - | - | - |
| 400 | `invalid_request` | Invia il token di accesso OAuth solo nell’intestazione Authorization. Le chiavi API e le credenziali access\_token/api\_key nella query o nel corpo vengono rifiutate. |
| 401 | `invalid_token` | Il token di accesso OAuth è assente, non valido, scaduto, revocato o non più autorizzato. Ricollega l’account. |
| 403 | `insufficient_scope` | Il token non include openid oppure l’account non dispone più di un accesso idoneo. Ricollegati con l’autorizzazione di identità richiesta e un account idoneo. Consulta la challenge WWW-Authenticate per i dettagli. |
| 404 | `invalid_request` | Gli endpoint OpenID Connect restituiscono HTTP 404 quando l’integrazione di identità non è disponibile in questo ambiente. Controlla la discovery prima di basarti sulle funzioni di identità. |
| 429 | `temporarily_unavailable` | È stato raggiunto il limite di frequenza delle richieste OAuth pubbliche. Attendi il termine della finestra corrente prima di riprovare. |
| 500 | `server_error` | L'autorizzazione è temporaneamente non disponibile. Riprova più tardi. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.