🔌 API Local — điều khiển kịch bản từ bên ngoài

Automate PC mở HTTP API trên máy bạn để Python, Node, PHP, PowerShell, AutoHotkey… có thể liệt kê, chạy, dừng và xem trạng thái kịch bản .apc.

Chỉ localhost — gọi thẳng URLServer bind 127.0.0.1, không mở ra LAN/Internet. Không cần token, không cần header auth — gọi URL là được.

Đây không phải API website macropc.net (license, thanh toán). API Local chỉ điều khiển phần mềm đang mở trên Windows.

Điều kiện hoạt động

Automate PC đang chạy — thoát app là API tắt.
Bật API Local trong Cài đặt (mặc định bật).
Gọi từ cùng máy (127.0.0.1).

Không cần license riêng cho API — API chỉ điều khiển tool đang mở trên máy.

Cấu hình trong app

Sidebar Cài đặt → mục API Local:

Ô	Ý nghĩa
URL API	Chỉ đọc, ví dụ `http://127.0.0.1:8765/api/v1`
Cổng (port)	Mặc định `8765`, chỉnh 1024–65535 — đổi port → server tự khởi động lại.
Bật API Local	Tắt = không lắng nghe cổng.

Base URL

http://127.0.0.1:{port}/api/v1

# Ví dụ mặc định:
http://127.0.0.1:8765/api/v1

Response: application/json; charset=utf-8. Body POST (nếu có): JSON. Không cần Authorization hay X-APC-Local-Token.

Bắt đầu nhanh

Tạo / import kịch bản, lưu file .apc trong thư mục scripts của app.
Gọi GET /api/v1/health — phải thấy ok: true.
GET /api/v1/scripts lấy tên → POST /api/v1/scripts/TênKịchBản/start.

Một lúc chỉ chạy một kịch bảnEngine không chạy song song hai file .apc. Đang bận → start khác trả 409 already_running — gọi POST /api/v1/run/stop trước.

🔌 API Local — điều khiển kịch bản từ bên ngoài

Automate PC mở HTTP API trên máy bạn để Python, Node, PHP, PowerShell, AutoHotkey… có thể liệt kê, chạy, dừng và xem trạng thái kịch bản .apc.

Chỉ localhost — gọi thẳng URLServer bind 127.0.0.1, không mở ra LAN/Internet. Không cần token, không cần header auth — gọi URL là được.

Đây không phải API website macropc.net (license, thanh toán). API Local chỉ điều khiển phần mềm đang mở trên Windows.

Điều kiện hoạt động

Automate PC đang chạy — thoát app là API tắt.
Bật API Local trong Cài đặt (mặc định bật).
Gọi từ cùng máy (127.0.0.1).

Không cần license riêng cho API — API chỉ điều khiển tool đang mở trên máy.

Cấu hình trong app

Sidebar Cài đặt → mục API Local:

Ô	Ý nghĩa
URL API	Chỉ đọc, ví dụ `http://127.0.0.1:8765/api/v1`
Cổng (port)	Mặc định `8765`, chỉnh 1024–65535 — đổi port → server tự khởi động lại.
Bật API Local	Tắt = không lắng nghe cổng.

Base URL

http://127.0.0.1:{port}/api/v1

# Ví dụ mặc định:
http://127.0.0.1:8765/api/v1

Response: application/json; charset=utf-8. Body POST (nếu có): JSON. Không cần Authorization hay X-APC-Local-Token.

Bắt đầu nhanh

Tạo / import kịch bản, lưu file .apc trong thư mục scripts của app.
Gọi GET /api/v1/health — phải thấy ok: true.
GET /api/v1/scripts lấy tên → POST /api/v1/scripts/TênKịchBản/start.

Một lúc chỉ chạy một kịch bảnEngine không chạy song song hai file .apc. Đang bận → start khác trả 409 already_running — gọi POST /api/v1/run/stop trước.