准策
智能体可读的核验 API

面向智能体(A2A)经济的 Trust API

让 AI 智能体、平台与应用程序核验 Trusgent ID、信任分、智能体可读的资料以及基于证据的信号。

JSON 响应
{
  "trusgentId": "TG-S-839201",
  "trustScore": 86,
  "agentReadinessScore": 88,
  "verificationLevel": "VERIFIED",
  "capabilities": [
    "business reception",
    "factory visit ops"
  ],
  "apiVersion": "2026-05-01"
}

Trust API 能做什么?

核验 Trusgent ID

检查某个 Trusgent ID 是否有效且处于活跃状态。

获取智能体可读的资料

检索结构化的能力与资料数据。

获取 Trust Score

读取基于证据的评分与核验状态。

获取智能体就绪分

了解某份资料是否已准备好被智能体推荐。

搜索可信服务提供者

按查询词、国家与类型查找服务提供者。

获取智能体预览

查看智能体应如何概括一个 Trusgent。

身份认证

使用来自控制台的 API 密钥。密钥仅显示一次,以哈希形式存储,可吊销,并通过用量日志与每月限额进行追踪。请发送 Authorization: Bearer YOUR_API_KEY。

端点

当前的公开 API 范围。

GET /api/v1/verify?trusgentId=TG-C-839201
GET /api/v1/trusgents/{id}
GET /api/v1/trusgents/{id}/trust-score
GET /api/v1/search?q=travel&country=CN&type=SERVICE_PROVIDER
GET /api/v1/agent-preview/{id}

代码示例

curl
curl "https://www.trusgent.com/api/v1/verify?trusgentId=TG-S-839201" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const res = await fetch("https://www.trusgent.com/api/v1/trusgents/TG-S-839201", {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
});
const profile = await res.json();
Python
import requests

res = requests.get(
    "https://www.trusgent.com/api/v1/search?q=travel&country=CN&type=SERVICE_PROVIDER",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(res.json())

速率限制与方案

免费资料包含基础 JSON。Pro 与 Business 解锁更广泛的 API 访问权限。API 方案面向大批量查询、批量查询与集成。

OpenAPI 与 llms.txt

使用 /openapi.json 获取机器可读的端点文档,使用 /llms.txt 获取面向 AI 智能体的简明说明文件。它们并不保证 AI 排名;而是提供结构化发现的基础。

常见问题

我需要 API 密钥吗?

部分公开核验端点可直接读取;经过身份认证的 API 调用支持密钥、用量日志与限额。

在哪里创建密钥?

在「控制台 API Keys」中,用户可以创建并吊销经过哈希存储的 API 密钥。

可以搜索服务提供者吗?

可以。搜索端点支持 q、country 和 type 参数。

可以获取 Trust Score 吗?

可以。Trust Score 有专门的端点,并提供评分拆解基础。

智能体可以使用该 API 吗?

可以。该 API 专为智能体与企业系统进行结构化检索而设计。

有 OpenAPI 吗?

有。/openapi.json 暴露当前的公开 API 范围。

有每月限额吗?

API 密钥可以设置每月限额并记录用量日志。

可以批量查询吗?

批量访问面向 API 与企业方案。