Skip to Content
快速開始總覽

快速開始

這一節帶你把整條路徑跑一次。三頁:

  1. 認證與 Base URL:拿 token、認識 base URL、API key scope 與 404/503 語意。
  2. 五分鐘跑一次:從建環境到取回執行結果的實際呼叫序列。

前置條件

  • 一組 TeamSync 認證(使用者 JWT,或 API key)。取得方式見 認證
  • 你的公司已啟用 sandbox 模組(SANDBOX_ENABLED);未啟用時,非 GET 的變更呼叫會回 503 sandbox_disabled
  • 建立環境/任務、改設定等變更操作需要 company manager(角色 ≥ 3)

心智模型(30 秒版)

環境 → 版本(給 digest → 建置 → ready) → 任務版本(綁 ready 版本+腳本 → 發布) → 綁定到聊天室 → 在聊天室提交執行 → 輪詢狀態 → 取產出物
  • 前端只跟 /private/module/sandbox 對話。
  • 沒有 streaming,用輪詢。
  • 提交執行要帶 Idempotency-Key
  • 下載產出物拿的是短效 capability token,不是 URL。

先讀完 認證,再照 五分鐘跑一次 做。

Last updated on