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

# Identität des verbundenen Nutzers abrufen

> Lesen Sie die einer OAuth-Verbindung gewährten Identitäts-Claims.

Lesen Sie die einer OAuth-Verbindung gewährten Identitäts-Claims.

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

## Authentifizierung

Senden Sie ein OAuth-Zugriffstoken in Authorization: Bearer. Das Token muss openid enthalten; E-Mail-Claims erfordern zusätzlich email. API-Schlüssel und Zugangsdaten in der Abfragezeichenfolge werden nicht akzeptiert.

## Anfragebeispiele

Beachten Sie die für diese Route dokumentierte Kodierung und Authentifizierung. Die Antwortstruktur und Idempotenzregeln der Aktions-API gelten nur für Aktionsaufrufe.

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

## Antwort

Lesen Sie die einer OAuth-Verbindung gewährten Identitäts-Claims.

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

## Antwortheader

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

## Hinweise zur Operation

* OpenID-Connect-Endpunkte geben HTTP 404 zurück, wenn die Identitätsintegration in dieser Umgebung nicht verfügbar ist. Prüfen Sie die Erkennungsmetadaten, bevor Sie Identitätsfunktionen voraussetzen.
* sub ist die stabile Kontokennung. email und email\_verified werden nur ausgegeben, wenn email gewährt wurde und das Konto eine E-Mail-Adresse hat. email\_verified entspricht dem tatsächlichen Verifizierungsstatus und kann false sein. Gelöschte oder deaktivierte Konten können UserInfo nicht verwenden.

## Fehler

| HTTP-Status | Code | Bedeutung oder Behebung |
| - | - | - |
| 400 | `invalid_request` | Senden Sie das OAuth-Zugriffstoken nur im Authorization-Header. API-Schlüssel sowie access\_token/api\_key-Zugangsdaten in Abfrage oder Body werden abgelehnt. |
| 401 | `invalid_token` | Das OAuth-Zugriffstoken fehlt, ist ungültig, abgelaufen, widerrufen oder nicht mehr autorisiert. Verbinden Sie das Konto erneut. |
| 403 | `insufficient_scope` | Dem Token fehlt openid oder das Konto hat keinen berechtigten Zugriff mehr. Verbinden Sie sich erneut mit der erforderlichen Identitätsberechtigung und einem berechtigten Konto. Details finden Sie in der WWW-Authenticate-Challenge. |
| 404 | `invalid_request` | OpenID-Connect-Endpunkte geben HTTP 404 zurück, wenn die Identitätsintegration in dieser Umgebung nicht verfügbar ist. Prüfen Sie die Erkennungsmetadaten, bevor Sie Identitätsfunktionen voraussetzen. |
| 429 | `temporarily_unavailable` | Das öffentliche Anfrageratenlimit für OAuth wurde erreicht. Warten Sie vor einem erneuten Versuch das aktuelle Zeitfenster ab. |
| 500 | `server_error` | Die Autorisierung ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut. |


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