📡 Chi tiết endpoint

Health

{
  "ok": true,
  "service": "automate-pc-local-api",
  "ts": 1756800000
}

Danh sách kịch bản

Liệt kê mọi file data/scripts/*.apc.

{
  "ok": true,
  "scripts": [
    {
      "name": "DemoFlow",
      "path": "D:\\...\\data\\scripts\\DemoFlow.apc",
      "modified_at": 1756800000
    }
  ]
}

Trạng thái

{
  "ok": true,
  "name": "DemoFlow",
  "path": "D:\\...\\DemoFlow.apc",
  "running": true,
  "error": "",
  "started_at": 1756800010.5,
  "engine": {
    "running": true,
    "running_script": "D:\\...\\DemoFlow.apc",
    "error": "",
    "started_at": 1756800010.5
  }
}

Chạy kịch bản

Body tùy chọn. variables truyền vào runner như biến custom (giống lịch hẹn / ô ⚙️ trên danh sách kịch bản).

{
  "variables": {
    "user_id": "123",
    "mode": "fast"
  }
}

Thành công → HTTP 200:

{
  "ok": true,
  "message": "started",
  "name": "DemoFlow",
  "path": "D:\\...\\DemoFlow.apc"
}

Engine bận → HTTP 409:

{
  "ok": false,
  "error": "already_running",
  "message": "Đang có kịch bản chạy. Gọi POST /api/v1/run/stop trước.",
  "running_script": "..."
}

Dừng theo tên

{ "ok": true, "message": "stop_requested", "name": "DemoFlow" }

Không active:

{
  "ok": true,
  "message": "not_running",
  "name": "DemoFlow",
  "engine_running": false
}

Dừng mọi thứ

{ "ok": true, "message": "stop_requested" }