智能体可读的核验 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 与企业方案。