v0.7.0

API 參考

最後更新


HakoRun 三個 HTTP 端點的請求欄位與狀態碼;回應格式見 回應與 SSE。

POST /upload


儲存函式並產生新版本。
欄位型別必要說明
pathstring是函式路徑,不可含 ..
codestring是原始碼
languagestring是python、javascript、typescript

狀態碼內容情境
200{"path", "language", "version"}儲存成功
400Invalid request payload缺欄位或 JSON 錯誤
400Invalid pathpath 含 ..,或 language 不支援(同一訊息)
500Failed to save function儲存後端寫入失敗

POST /run/*path


執行已儲存的函式。body 必須是 JSON;沒有輸入時傳 {}。
參數位置型別說明
versionqueryint64目標版本;省略或非整數時取最新
inputbodystringJSON 字串,腳本內為 event/input
streambodybooltrue 時以 SSE 回應

狀態碼情境
200執行成功(JSON 或 SSE)
400body 不是合法 JSON,或超過 CODE_MAX_SIZE
404script not found、assign version not found
500非串流模式執行失敗或逾時(failed to run: ...)

POST /run-now


不儲存,直接執行請求中的程式碼。
欄位型別必要說明
codestring是原始碼,不可為空白
languagestring是python、javascript、typescript
inputstring否JSON 字串輸入
streambool否true 時以 SSE 回應

狀態碼情境
200執行成功(JSON 或 SSE)
400body 錯誤、unsupported language、code is required
500非串流模式執行失敗或逾時

相關頁面


EN