準策
智能體可讀的核驗 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 與企業方案。