curl --request POST 'https://api.voicecheap.ai/oauth/userinfo' \
--header "Authorization: Bearer $VOICECHEAP_ACCESS_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
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());
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)
OAuth e protocollo MCP
Ottenere l’identità dell’utente connesso (POST)
Leggi i claim di identità concessi a una connessione OAuth.
POST
/
oauth
/
userinfo
curl --request POST 'https://api.voicecheap.ai/oauth/userinfo' \
--header "Authorization: Bearer $VOICECHEAP_ACCESS_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
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());
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)
Leggi i claim di identità concessi a una connessione OAuth.
POST 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.curl --request POST 'https://api.voicecheap.ai/oauth/userinfo' \
--header "Authorization: Bearer $VOICECHEAP_ACCESS_TOKEN" \
--header 'Content-Type: application/json' \
--data '{}'
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());
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)
Risposta
Leggi i claim di identità concessi a una connessione OAuth.HTTP 200
{
"sub": "voicecheap-user-id",
"email": "customer@example.com",
"email_verified": false
}
Intestazioni della risposta
{
"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. |
Questa pagina è stata utile?