发起 POST 请求 (http.post)

声明

HTTP状态码, 返回头JSON文本, 返回主体 = http.post(URL [, 超时秒, 请求头, 请求主体, URL不ESCAPE ])

参数及返回值

• URL
  • 文本型，需要请求的 URL 地址，该方法默认会对 URL 进行 escape 处理，如不需要可参考 URL不ESCAPE 参数说明
• 超时秒
  • 实数型，可选参数，请求超时时间，单位秒，默认 2
  • *1.2-3 版以上默认超时改为 10 秒
• 请求头
  • 表型，可选参数，发出的请求的头部信息，形式 {field1 = value1, field2 = value2, ...}，默认 {}
• 请求主体
  • 字符串型，可选参数，使用 post 发送出去的内容，默认是空字符串
• URL不ESCAPE *1.1.3-1 新增
  • 布尔型，可选参数，true 表示不对 URL 进行 escape 直接请求，默认 false
  • 对 URL 进行自定义 escape 可参考 lcurl 模块 的 easy:escape、easy:unescape
• HTTP状态码
  • 整数型，返回当次请求的 http 状态码，请求超时返回 -1
• 返回头JSON文本
  • 文本型 或 nil，请求完成返回的 JSON 形式头部信息，请求超时返回 nil
• 返回主体
  • 字符串型 或 nil，请求完成返回的内容，请求超时返回 nil

说明

使用 HTTP/1.1 协议的 POST 方法发送数据到网络中
这个函数可能会让出，在这个函数返回之前，其它的 线程 可能会得到运行机会
若服务器协议版本为 HTTP/1.0 或 HTTP/0.9，可使用

返回主体 = httpPost(URL, 请求主体, 超时秒)

这个方法替代

示例

local code, res_headers, body = http.post("http://www.baidu.com", 1, {
    ["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)", -- 模拟 IE8 的请求
    ["Cookie"] = "大佬你会不会啊？"; -- 顺带 Cookie 提交
}, "需要发送过去的数据")
if code == 200 then -- 如果返回的状态码是 HTTP_OK
    sys.alert(body) -- 输出百度首页的网页 HTML 内容
end

注：上述代码中使用了非本章函数 sys.alert

POST 提交表单示例

local c, h, r = http.post('http://httpbin.org/post', 60, {}, 'name=havonz&qq=1004695100&wechat=havonz')
if (c == 200) then
    sys.alert(r, 0, '提交成功')
else
    if (c == -1) then
        sys.alert('请求失败，请检查网络连接', 0, '连接超时')
    else
        sys.alert('错误代码 #'..c..'\n'..r, 0, 'HTTP 错误')
    end
end

注：上述代码中使用了非本章函数 sys.alert