Gửi yêu cầu POST (http.post)
Khai báo
mã trạng thái HTTP, văn bản JSON của header phản hồi, nội dung phản hồi = http.post(URL [, thời gian chờ tính bằng giây, header yêu cầu, dữ liệu nội dung yêu cầu, không escape URL ])
Khai báo (đối số có tên)
Hỗ trợ từ phiên bản 20250625; các tùy chọn tiến trình được hỗ trợ từ phiên bản 20260402
mã trạng thái HTTP, văn bản JSON của header phản hồi, nội dung phản hồi = http.post{
url = URL;
timeout = thời gian chờ tính bằng giây;
headers = header yêu cầu;
params = tham số query;
-- các tham số nội dung yêu cầu sau không thể cùng tồn tại; thứ tự ưu tiên là multipart > data > json > upload_file
multipart = biểu mẫu multipart trong nội dung yêu cầu;
data = dữ liệu nội dung yêu cầu;
json = JSON trong nội dung yêu cầu;
upload_file = đường dẫn tệp tải lên trong nội dung yêu cầu;
download_file = đường dẫn lưu nội dung phản hồi khi yêu cầu thành công;
progress = hàm gọi lại tiến độ;
progress_interval_ms = khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây;
}
Tham số
- URL
Kiểu chuỗi. URL yêu cầu. Hàm mặc định escape URL; xemkhông escape URLnếu không muốn xử lý này. - thời gian chờ tính bằng giây
Kiểu số, không bắt buộc. Thời gian chờ tính bằng giây. Mặc định: 10. - header yêu cầu
Kiểu bảng, không bắt buộc. Header yêu cầu có dạng{ field1 = value1, ... }. Mặc định:{}. - tham số query
Kiểu bảng, không bắt buộc. Tham số chuỗi truy vấn có dạng{ field1 = value1, ... }. Mặc định:{}. - dữ liệu nội dung yêu cầu
Kiểu chuỗi hoặc bảng, không bắt buộc. Nội dung yêu cầu. Mặc định: chuỗi rỗng.
Từ phiên bản 20250625, nếu truyền bảng thì bảng sẽ được mã hóa theo application/x-www-form-urlencoded. - biểu mẫu multipart trong nội dung yêu cầu
Kiểu bảng, không bắt buộc. Dữ liệu biểu mẫu multipart cần gửi. Mặc định:{}. - JSON trong nội dung yêu cầu
Kiểu bảng, không bắt buộc. Nội dung được mã hóa theo application/json. - đường dẫn tệp tải lên trong nội dung yêu cầu
Kiểu chuỗi, không bắt buộc. Gửi trực tiếp nội dung tệp làm nội dung yêu cầu. - đường dẫn lưu nội dung phản hồi khi yêu cầu thành công
Kiểu chuỗi, không bắt buộc. Nếu được cung cấp và yêu cầu thành công, nội dung phản hồi trả về là đường dẫn tệp đã lưu. - hàm gọi lại tiến độ
Kiểu hàm, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Được gọi khi tiến trình tải lên hoặc tải xuống thay đổi; đối số đầu tiên là thông tin tiến trình hiện tại. - khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây
Kiểu số nguyên, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Khoảng thời gian giữa các lần gọi lại tiến độ, tính bằng mili giây. - không escape URL
Kiểu boolean, không bắt buộc. true = không escape URL. Mặc định: false.
Để tự escape, hãy xem mô-đunlcurl, easy:escape và easy:unescape.
Giá trị trả về
- mã trạng thái HTTP
Kiểu số nguyên. Mã trạng thái HTTP; trả về -1 khi hết thời gian chờ. - văn bản JSON của header phản hồi
Kiểu chuỗi hoặc nil. Header phản hồi ở định dạng JSON; trả về nil khi hết thời gian chờ. - nội dung phản hồi
Kiểu chuỗi hoặc nil. Nội dung phản hồi; nếu đã lưu vào tệp thì đây là đường dẫn tệp. Trả về nil khi hết thời gian chờ.
Mô tả
Gửi dữ liệu bằng phương thức POST của HTTP/1.1.
Hàm này có thể nhường quyền thực thi; các luồng khác có thể được chạy trước khi hàm trả về.
Với máy chủ HTTP/1.0 hoặc HTTP/0.9, bạn có thể dùng:
nội dung phản hồi = httpPost(URL, dữ liệu nội dung yêu cầu kiểu chuỗi, thời gian chờ tính bằng giây)
Bảng info được truyền cho hàm gọi lại tiến độ có cấu trúc như sau:
{
count_of_bytes_sent = bytes_sent;
count_of_bytes_expected_to_send = bytes_expected_to_send;
count_of_bytes_received = bytes_received;
count_of_bytes_expected_to_receive = bytes_expected_to_receive;
}
Ví dụ
local code, res_headers, body = http.post("https://httpbin.org/post?hello=world&你好=世界", 15, {
["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)", -- mô phỏng yêu cầu của IE8
["Cookie"] = "a=1; b=2; c=3"; -- gửi kèm cookie
}, "dữ liệu cần gửi")
if code == 200 then -- HTTP_OK
sys.alert(body)
end
Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.
Ví dụ (đối số có tên)
local code, res_headers, body = http.post{
url = "https://httpbin.org/post";
timeout = 15;
headers = {
["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)";
["Cookie"] = "a=1; b=2; c=3";
};
params = {
["hello"] = "world";
["你好"] = "世界";
};
data = "dữ liệu cần gửi";
}
if code == 200 then
sys.alert(body)
end
Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.
Ví dụ: gửi biểu mẫu
local c, h, r = http.post('https://httpbin.org/post', 60, {}, 'name=alice&email=alice%40example.com')
if (c == 200) then
sys.alert(r, 0, 'Đã gửi')
else
if (c == -1) then
sys.alert('Yêu cầu thất bại, vui lòng kiểm tra kết nối mạng', 0, 'Hết thời gian chờ')
else
sys.alert('Lỗi #'..c..'\n'..r, 0, 'Lỗi HTTP')
end
end
Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.