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