Gửi yêu cầu PUT (http.put)

Khai báo

code, res_headers_json, body = http.put(URL [, timeout_secs, headers, data, url_no_escape])

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

code, res_headers_json, body = http.put{
    url = URL;
    timeout = timeout_secs;
    headers = headers;
    params = query_params;

    -- Các tùy chọn nội dung yêu cầu dưới đây loại trừ lẫn nhau; thứ tự ưu tiên: multipart > data > json > upload_file
    multipart = multipart_form;
    data = body_data;
    json = body_json;
    upload_file = upload_file_path;

    download_file = save_response_body_file_path;
    progress = progress_callback;
    progress_interval_ms = progress_interval_ms;
}

Tham số

URL
Kiểu chuỗi. URL yêu cầu. Hàm mặc định escape URL; xem url_no_escape nếu không muốn xử lý này.
timeout_secs
Kiểu số, không bắt buộc. Thời gian chờ tính bằng giây. Mặc định: 10.
headers
Kiểu bảng, không bắt buộc. Header yêu cầu có dạng { field1 = value1, ... }. Mặc định: {}.
query_params
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: {}.
body_data
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.
multipart_form
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: {}.
body_json
Kiểu bảng, không bắt buộc. Nội dung được mã hóa theo application/json.
upload_file_path
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.
save_response_body_file_path
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, body trả về là đường dẫn tệp đã lưu.
progress_callback
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.
progress_interval_ms
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 trình, tính bằng mili giây.
url_no_escape
Kiểu boolean, không bắt buộc. true = không escape URL. Mặc định: false.
Để tự escape, hãy xem mô-đun lcurl, easy:escape và easy:unescape.

Giá trị trả về

code
Kiểu số nguyên. Mã trạng thái HTTP; trả về -1 khi hết thời gian chờ.
res_headers_json
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ờ.
body
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ả

Dùng phương thức PUT của HTTP/1.1 để gửi dữ liệu; cách dùng tương tự POST.
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ề.

Bảng info được truyền cho hàm gọi lại tiến trình 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.put("https://httpbin.org/put?hello=world&你好=世界", 15, {
    ["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)",
    ["Cookie"] = "a=1; b=2; c=3";
}, "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ụ (đối số có tên)

local code, res_headers, body = http.put{
    url = "https://httpbin.org/put";
    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.

Khai báo​

Khai báo (đối số có tên)​

Tham số​

Giá trị trả về​

Mô tả​

Ví dụ​

Ví dụ (đối số có tên)​