QVeris
文档目录

将试用保存到新账户

POST /agent/trial/claim/verify

验证邮箱并确认认领一次,认领后用已有积分抵扣已确认欠费,不再赠送注册积分。

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性认证费用Operation ID
已发布私密 Agent 试用持有证明免费claim_verify_api_v1_agent_trial_claim_verify_post

参数

此操作没有路径或查询参数。

请求体

Schema: TrialClaimVerifyRequest

名称必填类型说明
email是string—
code是string—
password是string—

可运行示例

请在人类操作的认领页面完成验证和账户确认,不把密码、验证码或主账户令牌交给 Agent 提示词。下方示例只查询认领回执;请求体契约供可信应用实现使用。

bash
curl --fail-with-body --request GET \
  --url "https://qveris.ai/api/v1/agent/trial/claim" \
  --header "Authorization: Bearer $QVERIS_TRIAL_PROOF"
typescript
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())
python
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
200Successful ResponseAPIResponse_TrialClaimReceiptView_
400Bad RequestAPIResponse_BrowserTrialFailure_
401UnauthorizedAPIResponse_BrowserTrialFailure_
413Request Entity Too LargeAPIResponse_BrowserTrialFailure_
422Unprocessable EntityAPIResponse_BrowserTrialFailure_
429Too Many RequestsAPIResponse_BrowserTrialFailure_

成功响应示例

json
{
  "status": "string",
  "message": "string"
}

精确契约

相关操作

POST 发现能力 · POST 检查能力 · POST 预检能力 · POST 调用能力

这个页面对你有帮助吗?