API 參考
最後更新
HakoRun 三個 HTTP 端點的請求欄位與狀態碼;回應格式見 回應與 SSE。
POST /upload
儲存函式並產生新版本。
| 欄位 | 型別 | 必要 | 說明 |
|---|---|---|---|
path | string | 是 | 函式路徑,不可含 .. |
code | string | 是 | 原始碼 |
language | string | 是 | python、javascript、typescript |
| 狀態碼 | 內容 | 情境 |
|---|---|---|
200 | {"path", "language", "version"} | 儲存成功 |
400 | Invalid request payload | 缺欄位或 JSON 錯誤 |
400 | Invalid path | path 含 ..,或 language 不支援(同一訊息) |
500 | Failed to save function | 儲存後端寫入失敗 |
POST /run/*path
執行已儲存的函式。body 必須是 JSON;沒有輸入時傳
{}。| 參數 | 位置 | 型別 | 說明 |
|---|---|---|---|
version | query | int64 | 目標版本;省略或非整數時取最新 |
input | body | string | JSON 字串,腳本內為 event/input |
stream | body | bool | true 時以 SSE 回應 |
| 狀態碼 | 情境 |
|---|---|
200 | 執行成功(JSON 或 SSE) |
400 | body 不是合法 JSON,或超過 CODE_MAX_SIZE |
404 | script not found、assign version not found |
500 | 非串流模式執行失敗或逾時(failed to run: ...) |
POST /run-now
不儲存,直接執行請求中的程式碼。
| 欄位 | 型別 | 必要 | 說明 |
|---|---|---|---|
code | string | 是 | 原始碼,不可為空白 |
language | string | 是 | python、javascript、typescript |
input | string | 否 | JSON 字串輸入 |
stream | bool | 否 | true 時以 SSE 回應 |
| 狀態碼 | 情境 |
|---|---|
200 | 執行成功(JSON 或 SSE) |
400 | body 錯誤、unsupported language、code is required |
500 | 非串流模式執行失敗或逾時 |