调 AI 接口、抓数据、同步文件、推送日志——这些都绕不开 HTTP。
AutoHotkey 没有内置网络库,但用 Windows 自带的 WinHttp 就够。这篇把它封装成能直接用的几个函数,并把常见的坑一次说完。
一、核心封装:一个函数搞定 GET / POST
#Requires AutoHotkey v2.0
; 返回 {status, body, headers},失败时 status=0
Http(url, method := "GET", body := "", headers := "", timeoutMs := 30000) {
try {
req := ComObject("WinHttp.WinHttpRequest.5.1")
req.Open(method, url, false)
req.SetTimeouts(5000, 5000, timeoutMs, timeoutMs)
; 默认头
; UA 很重要:很多接口会拒绝空的 User-Agent
req.SetRequestHeader("User-Agent", "AutoAHK/1.0 (Windows)")
if IsObject(headers) {
for k, v in headers
req.SetRequestHeader(k, v)
}
if (body != "")
req.Send(body)
else
req.Send()
return {status: req.Status, body: req.ResponseText, headers: req.GetAllResponseHeaders()}
} catch as e {
return {status: 0, body: "", err: e.Message}
}
}
为什么用 false(同步):异步要处理事件回调,脚本里没必要,同步 + 设置超时更简单可控。
二、GET 一个 JSON 接口
r := Http("https://api.example.com/v1/status")
if (r.status != 200) {
MsgBox "请求失败:" r.status " " r.body
return
}
data := JsonParse(r.body)
MsgBox "返回条数:" data["count"]
三、POST JSON(调大模型最常见的写法)
payload := '{'
. '"model":"deepseek-chat",'
. '"messages":[{"role":"user","content":"你好"}]'
. '}'
r := Http("https://api.deepseek.com/chat/completions", "POST", payload,
Map("Content-Type", "application/json",
"Authorization", "Bearer " API_KEY))
if (r.status != 200) {
MsgBox "调用失败:" r.status "`n" SubStr(r.body, 1, 300)
return
}
resp := JsonParse(r.body)
content := resp["choices"][1]["message"]["content"]
注意:中文要保证 UTF-8。如果接口返回乱码,检查 req.Option(2)(是否 UTF-8 转换)或手动转码。
四、下载大文件(带进度)
Download(url, savePath) {
try {
req := ComObject("WinHttp.WinHttpRequest.5.1")
req.Open("GET", url, false)
req.SetTimeouts(5000, 5000, 120000, 120000)
; 关键:以二进制流方式接收,避免文本转换损坏文件
req.Send()
if (req.Status != 200)
return false
stream := ComObject("ADODB.Stream")
stream.Type := 1 ; 1 = 二进制
stream.Open()
stream.Write(req.ResponseBody) ; 注意某些版本是 ResponseStream
stream.SaveToFile(savePath, 2) ; 2 = 覆盖
stream.Close()
return true
} catch as e {
return false
}
}
大文件的坑:WinHttp 会把整个响应读进内存,超过几百 MB 容易失败。真要大文件,建议调用 curl.exe(Windows 10 之后自带):
RunWait A_ComSpec ' /c curl.exe -L -o "' savePath '" "' url '"', , "Hide"
五、解析 JSON:三种选择
方案 A:用现成库(推荐)
社区有成熟的 JSON.ahk / cJson 库,直接 #Include 进来用,支持嵌套与数组。
方案 B:调 PowerShell(零依赖,最稳)
JsonParse(text) {
tmpIn := A_Temp "json_in.txt"
tmpOut := A_Temp "json_out.txt"
FileDelete tmpIn
FileAppend text, tmpIn, "UTF-8"
cmd := 'powershell -NoProfile -Command "'
. '$j = Get-Content -Raw -Encoding UTF8 ''' tmpIn ''' | ConvertFrom-Json; '
. '$j | ConvertTo-Json -Depth 20 -Compress | Set-Content -Encoding UTF8 ''' tmpOut '''"'
RunWait A_ComSpec ' /c ' cmd, , "Hide"
if !FileExist(tmpOut)
return ""
out := FileRead(tmpOut, "UTF-8")
FileDelete tmpIn
FileDelete tmpOut
return out
}
输出仍是 JSON 文本,便于后续正则或再交给 PowerShell 处理。
方案 C:正则硬抠(只适合极简结构)
; 只取一个字段,快但脆
if RegExMatch(body, '"count"s*:s*(d+)', &m)
count := m[1]
六、上传文件(multipart)
UploadFile(url, filePath, fieldName := "file", extra := "") {
boundary := "----AutoAHK" Format("{:08X}", Random(0, 0xFFFFFFFF))
f := FileOpen(filePath, "r")
size := f.Length
content := f.Read(size)
f.Close()
head := "--" boundary "`r`n"
. 'Content-Disposition: form-data; name="' fieldName '"; filename="' A_LoopFileName '"`
. "`r`nContent-Type: application/octet-stream`r`n`r`n"
tail := "`r`n--" boundary "--`r`n"
; 拼二进制
st := ComObject("ADODB.Stream")
st.Type := 1
st.Open()
st.Write(ToUtf8Bytes(head))
st.Write(content)
st.Write(ToUtf8Bytes(tail))
body := ReadAll(st)
return Http(url, "POST", body, Map("Content-Type", "multipart/form-data; boundary=" boundary))
}
这个写法偏底层。**更省事的办法**:用 curl.exe -F,一行搞定。
RunWait A_ComSpec ' /c curl.exe -s -X POST -F "file=@' filePath '" ' url ' > "' A_Temp 'resp.json"', , "Hide"
七、七个坑
- User-Agent 为空:很多 CDN / 接口直接 403,必须设
- 中文乱码:请求体和响应都要确认 UTF-8;POST 时显式
Content-Type: application/json; charset=utf-8 - 没设超时:默认可能很久,脚本会”假死”;一定
SetTimeouts - HTTPS 证书:WinHttp 走系统证书库,自签证书会失败;测试环境可临时忽略(生产别关)
- 代理:公司网络走代理时,WinHttp 默认用系统代理;如要直连需显式设置
- 大响应占内存:>100MB 改用 curl
- 频率限制:接口 429 时别狂重试,加退避(见下)
八、带退避的重试
HttpRetry(url, method := "GET", body := "", headers := "", tries := 3) {
delay := 1000
loop tries {
r := Http(url, method, body, headers)
if (r.status >= 200 && r.status = 500) {
Sleep delay
delay *= 2 ; 1s → 2s → 4s
continue
}
return r ; 4xx 不重试
}
return r
}
九、一个实战:把脚本日志推到自己的服务器
; 每 5 分钟把新增日志 POST 上去
PushLog() {
global LOG_FILE
if !FileExist(LOG_FILE)
return
txt := FileRead(LOG_FILE, "UTF-8")
if (StrLen(txt) < 10)
return
r := HttpRetry("https://你的域名/api/log", "POST",
'{"host":"' A_ComputerName '","log":' JsonEscape(txt) '}',
Map("Content-Type", "application/json"))
if (r.status = 200)
FileDelete LOG_FILE ; 推成功再清
}
这样几十台机器上的脚本运行情况,就能在一个后台统一看。
这些封装(含 JSON 库、上传、重试、日志推送)都整理在 AI 自动化工具包里;企业侧要部署到多台机器,可以留个联系方式。

