http - http 客户端

已适配 Air101/Air103 Air105 ESP32C3 ESP32S3 Air780E

备注

本页文档由这个文件自动生成。如有错误，请提交issue或帮忙修改后pr，谢谢！

小技巧

本库有专属demo，点此链接查看http的demo例子

示例

-- 使用http库,需要引入sysplus库, 且需要在task内使用
require "sys"
require "sysplus"

sys.taskInit(function()
	sys.wait(1000)
	local code,headers,body = http.request("GET", "http://www.example.com/abc").wait()
	log.info("http", code, body)
end)

http.request(method,url,headers,body,opts,ca_file,client_ca, client_key, client_password)

http客户端

参数

传入值类型	解释
string	请求方法, 支持 GET/POST 等合法的HTTP方法
string	url地址, 支持 http和https, 支持域名, 支持自定义端口
tabal	请求头 可选 例如 {[“Content-Type”] = “application/x-www-form-urlencoded”}
string	body 可选, 对POST/PUT等请求方式有效
table	额外配置 可选 包含 timeout:超时时间单位ms 可选,默认10分钟,写0即永久等待 dst:下载路径,可选 adapter:选择使用网卡,可选 debug:是否打开debug信息,可选,ipv6:是否为ipv6 默认不是,可选
string	服务器ca证书数据, 可选, 一般不需要
string	客户端ca证书数据, 可选, 一般不需要, 双向https认证才需要
string	客户端私钥加密数据, 可选, 一般不需要, 双向https认证才需要
string	客户端私钥口令数据, 可选, 一般不需要, 双向https认证才需要

返回值

返回值类型	解释
int	code , 服务器反馈的值>=100, 最常见的是200.如果是底层错误,例如连接失败, 返回值小于0
tabal	headers 当code>100时, 代表服务器返回的头部数据
string/int	body 服务器响应的内容字符串,如果是下载模式, 则返回文件大小

例子

-- GET请求
local code, headers, body = http.request("GET","http://site0.cn/api/httptest/simple/time").wait()
log.info("http.get", code, headers, body)
-- POST请求
local code, headers, body = http.request("POST","http://httpbin.com/post", {}, "abc=123").wait()
log.info("http.post", code, headers, body)

-- GET请求,但下载到文件
local code, headers, body = http.request("GET","http://httpbin.com/", {}, "", {dst="/data.bin"}).wait()
log.info("http.get", code, headers, body)

-- 自定义超时时间, 5000ms
http.request("GET","http://httpbin.com/", nil, nil, {timeout=5000}).wait()

---