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

# De identiteit van de verbonden gebruiker ophalen (POST)

> Lees de identiteitsclaims die aan een OAuth-verbinding zijn verleend.

Lees de identiteitsclaims die aan een OAuth-verbinding zijn verleend.

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

## Authenticatie

Stuur een OAuth-toegangstoken in Authorization: Bearer. Het token moet openid bevatten; e-mailclaims vereisen ook email. API-sleutels en inloggegevens in queryparameters worden niet geaccepteerd.

## Voorbeeldaanvragen

Volg de gedocumenteerde codering en authenticatie voor deze route. De antwoordstructuur en idempotentieregels van de actie-API gelden alleen voor actieaanroepen.

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

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

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

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

## Antwoord

Lees de identiteitsclaims die aan een OAuth-verbinding zijn verleend.

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

## Antwoordheaders

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

## Opmerkingen bij de bewerking

* OpenID Connect-endpoints geven HTTP 404 terug wanneer identiteitsintegratie in deze omgeving niet beschikbaar is. Controleer discovery voordat je op identiteitsfuncties vertrouwt.
* sub is de vaste accountidentificatie. email en email\_verified worden alleen opgenomen als email is verleend en het account een e-mailadres heeft. email\_verified weerspiegelt de werkelijke verificatiestatus en kan false zijn. Verwijderde of uitgeschakelde accounts kunnen UserInfo niet gebruiken.

## Fouten

| HTTP-status | Code | Betekenis of herstel |
| - | - | - |
| 400 | `invalid_request` | Stuur het OAuth-toegangstoken alleen in de Authorization-header. API-sleutels en access\_token/api\_key-inloggegevens in de query of body worden geweigerd. |
| 401 | `invalid_token` | Het OAuth-toegangstoken ontbreekt, is ongeldig, verlopen, ingetrokken of niet meer geautoriseerd. Verbind het account opnieuw. |
| 403 | `insufficient_scope` | Het token mist openid of het account voldoet niet meer aan de toegangseisen. Verbind opnieuw met het vereiste identiteitsrecht en een geschikt account. Lees de WWW-Authenticate-challenge voor details. |
| 404 | `invalid_request` | OpenID Connect-endpoints geven HTTP 404 terug wanneer identiteitsintegratie in deze omgeving niet beschikbaar is. Controleer discovery voordat je op identiteitsfuncties vertrouwt. |
| 429 | `temporarily_unavailable` | De openbare frequentielimiet voor OAuth-aanvragen is bereikt. Wacht tot het huidige tijdvenster voorbij is voordat je het opnieuw probeert. |
| 500 | `server_error` | Autorisatie is tijdelijk niet beschikbaar. Probeer het later opnieuw. |


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