将试用保存到已有账户
POST /agent/trial/claim/existing
同时证明试用持有权和接收账户控制权；未结算调用阻止认领，积分不足保留余债。
REST API 概览 · OpenAPI JSON · OpenAPI YAML
接口契约
| 稳定性 | 认证 | 费用 | Operation ID |
|---|---|---|---|
| 已发布 | 试用持有证明及接收账户登录确认 | 免费 | claim_existing_api_v1_agent_trial_claim_existing_post |
参数
| 名称 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
X-Qveris-Claim-Account-Token | header | 是 | string | — |
请求体
Schema: TrialClaimExistingRequest
| 名称 | 必填 | 类型 | 说明 |
|---|
可运行示例
请在人类操作的认领页面完成验证和账户确认，不把密码、验证码或主账户令牌交给 Agent 提示词。下方示例只查询认领回执；请求体契约供可信应用实现使用。
curl --fail-with-body --request GET \
--url "https://qveris.ai/api/v1/agent/trial/claim" \
--header "Authorization: Bearer $QVERIS_TRIAL_PROOF"
const response = await fetch("https://qveris.ai/api/v1/agent/trial/claim", {
method: "GET",
credentials: "omit",
redirect: "error",
headers: {
Authorization: `Bearer ${process.env.QVERIS_TRIAL_PROOF}`,
},
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
if (response.status !== 204) console.log(await response.json())
import os
import requests
response = requests.request(
"GET",
"https://qveris.ai/api/v1/agent/trial/claim",
headers={"Authorization": f"Bearer {os.environ['QVERIS_TRIAL_PROOF']}"},
allow_redirects=False,
timeout=30,
)
response.raise_for_status()
if response.status_code != 204:
print(response.json())
响应
| 状态码 | 含义 | Schema |
|---|---|---|
200 | Successful Response | APIResponse_TrialClaimReceiptView_ |
400 | Bad Request | APIResponse_BrowserTrialFailure_ |
401 | Unauthorized | APIResponse_BrowserTrialFailure_ |
413 | Request Entity Too Large | APIResponse_BrowserTrialFailure_ |
422 | Unprocessable Entity | APIResponse_BrowserTrialFailure_ |
429 | Too Many Requests | APIResponse_BrowserTrialFailure_ |
成功响应示例
{
"status": "string",
"message": "string"
}
精确契约
- 稳定版 JSON: OpenAPI JSON
- 稳定版 YAML: OpenAPI YAML
- 版本化 JSON: OpenAPI v1 JSON
- 版本化 YAML: OpenAPI v1 YAML