快速開始
這一節帶你把整條路徑跑一次。三頁:
- 認證與 Base URL:拿 token、認識 base URL、API key scope 與 404/503 語意。
- 五分鐘跑一次:從建環境到取回執行結果的實際呼叫序列。
前置條件
- 一組 TeamSync 認證(使用者 JWT,或 API key)。取得方式見 認證。
- 你的公司已啟用 sandbox 模組(
SANDBOX_ENABLED);未啟用時,非 GET 的變更呼叫會回 503sandbox_disabled。 - 建立環境/任務、改設定等變更操作需要 company manager(角色 ≥ 3)。
心智模型(30 秒版)
環境 → 版本(給 digest → 建置 → ready) → 任務版本(綁 ready 版本+腳本 → 發布)
→ 綁定到聊天室 → 在聊天室提交執行 → 輪詢狀態 → 取產出物- 前端只跟
/private/module/sandbox對話。 - 沒有 streaming,用輪詢。
- 提交執行要帶
Idempotency-Key。 - 下載產出物拿的是短效 capability token,不是 URL。
Last updated on