📋 Luồng thực tế

1. GET /health — app sống.
2. GET /scripts — đúng name.
3. GET /exes?process=dnplayer.exe (hoặc /windows?q=ldplayer) — còn đủ cửa sổ, alive, kích thước client đúng với lúc cắt ảnh.
4. POST /scripts/{name}/start-mt với windows + max_threads + variables.
5. Poll GET /scripts/{name}/status đến running: false (hoặc running_count == 0). Hàng queued sẽ tự lên khi slot trống.
6. Lỗi một máy → POST /scripts/{name}/stop với hwnd đó; các luồng khác vẫn chạy.
7. Dừng gấp → POST /run/stop.

Biến trên node Bắt đầu phải khai báo tên; giá trị điền ở Cài đặt kịch bản hoặc variables trong API. Chi tiết: Khai báo biến.

Lưu ý vận hành

1. Tool phải mở — thoát app thì API tắt.
2. Chỉ localhost — máy khác không gọi được (không khuyến nghị forward port).
3. Đổi port — sửa URL trong script tích hợp.
4. File kịch bản: data/scripts/*.apc — tạo/import trên UI trước.
5. Đa luồng API không bật lịch hẹn giờ; lịch vẫn do UI. variables API ghi đè biến đã lưu, không ghi đè file .apc.
6. queued chỉ sống khi app còn mở. Restart app = mất hàng đợi.
7. Node Chọn App trong script: khi API đã bind HWND, runner giữ cửa sổ đó (không nhảy instance khác).

Python: check exe → đa luồng → poll → stop một máy

import time
import requests

BASE = "http://127.0.0.1:8765/api/v1"
NAME = "NhiemVuNgay"

def api(method, path, **kw):
    r = requests.request(method, BASE + path, timeout=30, **kw)
    r.raise_for_status()
    return r.json()

assert api("GET", "/health").get("ok")
exes = api("GET", "/exes", params={"process": "dnplayer.exe"})["exes"]
windows = exes[0]["windows"] if exes else []
assert windows, "Không thấy dnplayer"

api("POST", f"/scripts/{NAME}/start-mt", json={
    "windows": windows,
    "max_threads": min(3, len(windows)),
    "variables": {"taikhoan": "acc01"},
})

for _ in range(600):
    st = api("GET", f"/scripts/{NAME}/status")
    if not st["running"]:
        print("xong")
        break
    time.sleep(1)
else:
    api("POST", "/run/stop")