跳至主要內容

YOTRON AI Developer Resources

YOTRON Developer Portal & Machine-Readable Interface・OpenAPI 3.1、MCP 伺服器、零門檻 Sandbox

YOTRON AI 開發者資源與標準化 AI 代理串接協定

YOTRON 全站採用開放標準,支援 AI 代理自主探索服務、工具呼叫、OAuth 2.0 授權與即時沙盒驗證。

OpenAPI 3.1.0

REST API 規範

機器可讀的端點定義,涵蓋潛在客戶需求提交、服務目錄查詢與企業 AI 健檢。

MCP Server

Model Context Protocol

Streamable HTTP 傳輸,支援 Claude、ChatGPT 等 AI Agent 原生工具呼叫。

OAuth 2.0 & RFC 9728

身分驗證與權限

宣告明確最小權限 Scope(read:content、write:lead、read:catalog)。

Agent Skills & LLMs.txt

上下文與技能索引

Cloudflare Agent Skills RFC v0.2.0 索引與標準 llms.txt 網站地圖。

即時沙盒環境(Zero-Friction Sandbox Mode)

AI 代理與開發者無須事先審核或寄信,即可測試潛在客戶需求提交與諮詢 API。只需在請求中加入 ?sandbox=true 或標頭 X-Sandbox: true,系統將立即執行完整資料驗證,並回傳 200 JSON 與速率限制標頭。

也可先讀取 /sandbox 確認免授權測試環境已開啟;Sandbox 不會寫入正式資料或發送通知。

curl -X POST "https://yotron-ai.com/api/v1/lead?sandbox=true" \
  -H "Content-Type: application/json" \
  -d '{"name": "AI Agent Tester", "phone": "0912345678", "email": "[email protected]", "need": "測試諮詢接口", "source": "sandbox"}'

速率限制與標頭標準(Rate Limit Headers)

所有公開 API 均附帶標準 RFC 速率限制標頭,方便 AI 代理自動調整請求頻率:

  • X-RateLimit-Limit:每分鐘允許最大請求數(預設 100)。
  • X-RateLimit-Remaining:目前計算期間內的剩餘可用額度。
  • X-RateLimit-Reset:距離額度重置的秒數。

API 版本、棄用與停用政策

目前版本固定在 /api/v1。正式淘汰前至少提前 6 個月公告;已標示棄用的端點會回傳 Deprecation: true、依 RFC 8594 的 Sunset 日期與 Link: rel="deprecation"。目前啟用中的 v1 端點會明確回傳 Deprecation: false。

閱讀完整 API 版本政策 →

準備好讓 AI 幫你工作了嗎?

現在開始你的數位轉型,預約 30 分鐘諮詢,我們協助你找到最合適的 AI 切入點。

30 分鐘深度了解你的業務,給你具體建議