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 と MCP プロトコル
接続ユーザーの ID を取得 (POST)
OAuth 接続に付与された ID クレームを取得します。
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)
OAuth 接続に付与された ID クレームを取得します。
POST https://api.voicecheap.ai/oauth/userinfo
認証
OAuth アクセストークンを Authorization: Bearer で送信してください。トークンには openid が必要です。メールのクレームには email も必要です。API キーとクエリ文字列の認証情報は受け付けられません。リクエスト例
このルートに記載されたエンコード方式と認証方法に従ってください。アクション API のエンベロープと冪等性のルールは、アクションの呼び出しにのみ適用されます。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 接続に付与された ID クレームを取得します。HTTP 200
{
"sub": "voicecheap-user-id",
"email": "customer@example.com",
"email_verified": false
}
レスポンスヘッダー
{
"Cache-Control": "no-store",
"Pragma": "no-cache"
}
操作の注意事項
- この環境で ID 連携が利用できない場合、OpenID Connect エンドポイントは HTTP 404 を返します。ID 機能を利用する前に検出情報を確認してください。
- sub はアカウントの安定した識別子です。email と email_verified は、email が付与され、アカウントにメールアドレスがある場合のみ含まれます。email_verified は実際の確認状態を反映し、false の場合もあります。削除済みまたは無効化されたアカウントでは UserInfo を利用できません。
エラー
| HTTP ステータス | コード | 意味または対処方法 |
|---|---|---|
| 400 | invalid_request | OAuth アクセストークンは Authorization ヘッダーでのみ送信してください。API キーと、クエリまたはボディの access_token/api_key 認証情報は拒否されます。 |
| 401 | invalid_token | OAuth アクセストークンが存在しない、無効、有効期限切れ、失効済み、または認可されていません。アカウントを再接続してください。 |
| 403 | insufficient_scope | トークンに openid がないか、アカウントが利用条件を満たさなくなりました。必要な ID 権限と利用可能なアカウントで再接続してください。詳細は WWW-Authenticate チャレンジを確認してください。 |
| 404 | invalid_request | この環境で ID 連携が利用できない場合、OpenID Connect エンドポイントは HTTP 404 を返します。ID 機能を利用する前に検出情報を確認してください。 |
| 429 | temporarily_unavailable | 公開 OAuth リクエストのレート上限に達しました。現在の制限期間が終わってから再試行してください。 |
| 500 | server_error | 認可を一時的に利用できません。後で再試行してください。 |
このページは役に立ちましたか？