内省资源 Token
POST /oauth/introspect
内省资源 Token
REST API 概览 · OpenAPI JSON · OpenAPI YAML
接口契约
| 稳定性 | 认证 | 费用 | Operation ID |
|---|---|---|---|
| 已发布 | HTTP Basic（已加入允许列表的机密客户端） | 免费 | introspect_api_v1_oauth_introspect_post |
参数
此操作没有路径或查询参数。
请求体
Schema: inline
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
token | 是 | string | — |
resource | 是 | string | — |
token_type_hint | 否 | string | null | — |
可运行示例
curl --request POST \
--url "https://qveris.ai/api/v1/oauth/introspect" \
--user "$QVERIS_OAUTH_CLIENT_ID:$QVERIS_OAUTH_CLIENT_SECRET" \
--data-urlencode 'token=YOUR_RESOURCE_TOKEN' \
--data-urlencode 'resource=YOUR_REGISTERED_RESOURCE_URI'
const response = await fetch("https://qveris.ai/api/v1/oauth/introspect", {
method: "POST",
headers: {
Authorization: `Basic ${Buffer.from(`${process.env.QVERIS_OAUTH_CLIENT_ID}:${process.env.QVERIS_OAUTH_CLIENT_SECRET}`).toString("base64")}`,
},
body: new URLSearchParams(Object.entries({
"token": "YOUR_RESOURCE_TOKEN",
"resource": "YOUR_REGISTERED_RESOURCE_URI"
}).map(([key, value]) => [key, String(value)])),
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
import json
import os
import requests
response = requests.request(
"POST",
"https://qveris.ai/api/v1/oauth/introspect",
auth=(os.environ["QVERIS_OAUTH_CLIENT_ID"], os.environ["QVERIS_OAUTH_CLIENT_SECRET"]),
data=json.loads(r'''{
"token": "YOUR_RESOURCE_TOKEN",
"resource": "YOUR_REGISTERED_RESOURCE_URI"
}'''),
timeout=30,
)
response.raise_for_status()
print(response.json())
响应
| 状态码 | 含义 | Schema |
|---|---|---|
200 | Successful Response | OAuthIntrospectionActiveResponse | OAuthIntrospectionInactiveResponse |
400 | OAuth request or grant error | OAuthErrorResponse |
401 | Client authentication or bearer-token error | OAuthErrorResponse |
403 | Subject token has insufficient scope | OAuthErrorResponse |
422 | Validation Error | HTTPValidationError |
成功响应示例
{
"active": true,
"token_type": "Bearer",
"scope": "string",
"client_id": "string",
"sub": "string",
"token_use": "access",
"exp": 1,
"iat": 1,
"nbf": 1,
"aud": "string",
"iss": "string",
"jti": "string"
}
精确契约
- 稳定版 JSON: OpenAPI JSON
- 稳定版 YAML: OpenAPI YAML
- 版本化 JSON: OpenAPI v1 JSON
- 版本化 YAML: OpenAPI v1 YAML