Skip to content

k.net.httpClient ​

出站 HTTP:统一 send、多种请求体与批量任务

概述 ​

k.net.httpClient 基于 HttpClient 封装出站请求,支持 JSON、表单、multipart 与并行批量下载。在 API 中代理转发第三方接口时,优先使用本模块。

返回值为 KHttpResponse,通过 success、statusCode、bodyString() 等读取结果。

创建请求体 ​

方法说明
createJsonContent(body)application/json
createStringContent(body)纯文本
createFormUrlEncodedContent(dict)application/x-www-form-urlencoded
createMultipartFormDataContent()multipart,见下
ts
const json = k.net.httpClient.createJsonContent({ name: "kooboo" })
const text = k.net.httpClient.createStringContent("plain text")
const form = k.net.httpClient.createFormUrlEncodedContent({ key: "value" })

const multipart = k.net.httpClient.createMultipartFormDataContent()
multipart.add("name", "jobs")
multipart.addFile("sticker", "1.png", k.file.readBinary("1.png"))

send() ​

发送单次 HTTP 请求。

ts
k.api.post("proxy", () => {
    const content = k.net.httpClient.createJsonContent({ q: "hello" })
    const response = k.net.httpClient.send("https://httpbin.org/post", "post", content)
    return {
        ok: response.success,
        status: response.statusCode,
        body: response.bodyString()
    }
})
参数类型必填说明
urlstring是完整 URL
methodstring是get、post、put、delete、options(不区分大小写)
contentKHttpContent否请求体;GET 通常省略
headersobject否额外请求头键值对
timeoutnumber否超时秒数

返回: KHttpResponse

KHttpResponse 常用成员 ​

成员说明
successHTTP 是否成功状态码
statusCode数字状态码
bodyString()响应正文文本
bodyBinary()响应正文字节数组
getHeader(name)读取响应头(字符串数组)
contentType{ mediaType, charSet }
contentDisposition{ fileName, size }
save(path) / saveBinary(path)将响应写入站点 k.file 路径
ts
const response = k.net.httpClient.send("https://example.com/file.zip", "get")
if (response.success) {
    response.save("downloads/archive.zip")
}

批量请求 ​

ts
const batch = k.net.httpClient.createBatchRequest()
const imgTask = batch.addTask("https://www.kooboo.com/img/logo-white.png", "get")
imgTask.responseType = "File"
imgTask.savePath = "logo-white.png"

const jsonTask = batch.addTask("https://httpbin.org/json", "get")
jsonTask.responseType = "String"

k.net.httpClient.send(batch)

return {
    imageOk: batch.tasks[0].isSuccess,
    jsonSnippet: batch.tasks[1].stringResult?.slice(0, 80)
}

RequestTask 常用字段:

字段说明
responseType"String"、"Binary"、"File"
savePathresponseType 为 "File" 时必填,相对站点文件路径
isSuccess任务是否成功
statusCodeHTTP 状态码
errorMessage失败时的错误信息
stringResult / binaryResult / fileResult按类型存放结果

相关文档 ​