> ## 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.

# Obtenir l’identité de l’utilisateur connecté

> Lisez les claims d’identité accordés à une connexion OAuth.

Lisez les claims d’identité accordés à une connexion OAuth.

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

## Authentification

Envoyez un token d’accès OAuth dans Authorization: Bearer. Il doit inclure openid ; les claims d’adresse e-mail nécessitent aussi email. Les clés API et les identifiants dans les paramètres d’URL sont refusés.

## Exemples de requêtes

Suivez l’encodage et l’authentification documentés pour cette route. L’enveloppe et les règles d’idempotence de l’API d’actions s’appliquent uniquement aux invocations d’actions.

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

## Réponse

Lisez les claims d’identité accordés à une connexion OAuth.

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

## En-têtes de réponse

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

## Notes de l’opération

* Les endpoints OpenID Connect renvoient HTTP 404 quand l’intégration d’identité est indisponible dans cet environnement. Vérifiez la découverte avant de dépendre des fonctions d’identité.
* sub est l’identifiant stable du compte. email et email\_verified sont inclus uniquement si email a été accordé et que le compte possède une adresse e-mail. email\_verified reflète le statut réel de vérification et peut valoir false. Les comptes supprimés ou désactivés ne peuvent pas utiliser UserInfo.

## Erreurs

| Statut HTTP | Code | Signification ou solution |
| - | - | - |
| 400 | `invalid_request` | Envoyez le token d’accès OAuth uniquement dans l’en-tête Authorization. Les clés API et les identifiants access\_token/api\_key dans les paramètres d’URL ou le corps sont refusés. |
| 401 | `invalid_token` | Le token d’accès OAuth est absent, invalide, expiré, révoqué ou n’est plus autorisé. Reconnectez le compte. |
| 403 | `insufficient_scope` | Le token ne possède pas openid ou le compte ne dispose plus d’un accès éligible. Reconnectez-vous avec la permission d’identité requise et un compte éligible. Consultez le challenge WWW-Authenticate pour plus de détails. |
| 404 | `invalid_request` | Les endpoints OpenID Connect renvoient HTTP 404 quand l’intégration d’identité est indisponible dans cet environnement. Vérifiez la découverte avant de dépendre des fonctions d’identité. |
| 429 | `temporarily_unavailable` | La limite de fréquence des requêtes OAuth publiques a été atteinte. Attendez la fin de la fenêtre en cours avant de réessayer. |
| 500 | `server_error` | L’autorisation est temporairement indisponible. Réessayez plus tard. |


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