QVeris
文档目录

查询 Capability 详情

GET /capabilities/{capability_id}

查询 Capability 详情

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性认证费用Operation ID
已发布Bearer API 密钥免费capabilities_detail_api_v1_capabilities__capability_id__get

参数

名称位置必填类型说明
capability_idpath是string—
run_idquery否stringRun identifier required by constrained delegation tokens.
provider_idquery否stringProvider target required by constrained delegation tokens.

请求体

此操作没有 JSON 请求体。

可运行示例

bash
curl --request GET \
  --url "https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID" \
  --header "Authorization: Bearer $QVERIS_API_KEY"
typescript
const response = await fetch("https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
  },
})

if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
python
import os
import requests

response = requests.request(
    "GET",
    "https://qveris.ai/api/v1/capabilities/YOUR_CAPABILITY_ID",
    headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

响应

状态码含义Schema
200Successful ResponsePublicCapabilityDetailResponse
401UnauthorizedPublicApiError
402Insufficient creditsPublicApiError
403Delegation constraint rejectedPublicApiError
404Capability not foundPublicApiError
408Request timeoutPublicApiError
422Validation ErrorHTTPValidationError
500Request failedPublicApiError

成功响应示例

json
{
  "capability_id": "MKT.BARS.EOD",
  "name": "End-of-Day Bars",
  "description": "Daily market bars for a symbol.",
  "contract_version": 7,
  "schema_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "remaining_credits": 995,
  "verification_status": "unverified",
  "verification": {
    "status": "unverified",
    "policy_version": "catalog-verification-v1",
    "required_checks": [
      "schema",
      "authentication",
      "description_contract",
      "provider_identity",
      "permissions",
      "freshness",
      "live_check"
    ],
    "checks": [
      {
        "name": "schema",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": "schema_missing"
      },
      {
        "name": "authentication",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": "authentication_path_missing"
      },
      {
        "name": "description_contract",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": null
      },
      {
        "name": "provider_identity",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": "provider_id_missing"
      },
      {
        "name": "permissions",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": null
      },
      {
        "name": "freshness",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": "expires_at_missing"
      },
      {
        "name": "live_check",
        "status": "missing",
        "checked_at": null,
        "evidence_digest": null,
        "reason": "live_check_samples_missing"
      }
    ],
    "verified_at": null,
    "expires_at": null,
    "test_run_digest": null,
    "quality_issues": [
      "live_check_samples_missing",
      "schema_missing",
      "authentication_path_missing",
      "provider_id_missing",
      "permission_disclosure_incomplete",
      "verified_at_missing",
      "expires_at_missing",
      "test_run_digest_missing",
      "verification_status_missing"
    ]
  },
  "execution_restrictions": {
    "callable": false,
    "technical": "unknown",
    "authentication": "unknown",
    "eligibility": "unknown",
    "license": "unknown",
    "regions": {
      "allow": [],
      "deny": []
    },
    "region_status": "unknown",
    "commercial_use": "unknown",
    "freshness": "unknown",
    "price_certainty": "unknown",
    "data_as_of": null,
    "warnings": [],
    "confidence": 0,
    "allowed_actions": [
      "discover",
      "inspect",
      "probe"
    ],
    "blocked_actions": [
      "execute"
    ],
    "next_action": "probe",
    "retryable": true
  }
}

精确契约

相关操作

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

这个页面对你有帮助吗?