YOTRON AI 開發者資源與標準化 AI 代理串接協定
YOTRON 全站採用開放標準,支援 AI 代理自主探索服務、工具呼叫、OAuth 2.0 授權與即時沙盒驗證。
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。
