Cách POST dữ liệu tới API bằng Java

Bài viết này hướng dẫn cách gửi dữ liệu tới API bằng phương thức POST trong Java, sử dụng thư viện HttpURLConnection và thư viện org.json để xử lý dữ liệu JSON.

Trong bài viết này, chúng ta sẽ học cách sử dụng HttpURLConnection để thực hiện một yêu cầu HTTP POST gửi dữ liệu JSON tới một API. Đoạn mã sẽ minh họa chi tiết từng bước thực hiện.

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;

public class PostJsonExample {
    public static void main(String[] args) {
        try {
            // URL của API
            URL url = new URL("https://api.example.com/data");

            // Tạo kết nối HTTP
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json; utf-8");
            conn.setRequestProperty("Accept", "application/json");
            conn.setDoOutput(true);

            // Dữ liệu JSON cần gửi
            JSONObject jsonInput = new JSONObject();
            jsonInput.put("name", "John Doe");
            jsonInput.put("email", "[email protected]");

            // Gửi dữ liệu JSON
            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = jsonInput.toString().getBytes("utf-8");
                os.write(input, 0, input.length);
            }

            // Kiểm tra phản hồi từ server
            int responseCode = conn.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                System.out.println("Dữ liệu đã được gửi thành công!");
            } else {
                System.out.println("Lỗi khi gửi dữ liệu: " + responseCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Giải thích chi tiết từng dòng code

1. import java.io.OutputStream; và import java.net.HttpURLConnection;: Nhập các thư viện cần thiết để tạo kết nối HTTP.
2. import org.json.JSONObject;: Nhập thư viện org.json để tạo đối tượng JSON.
3. URL url = new URL("https://api.example.com/data");: Đặt URL của API mà bạn muốn gửi dữ liệu tới.
4. HttpURLConnection conn = (HttpURLConnection) url.openConnection();: Mở kết nối HTTP tới API.
5. conn.setRequestMethod("POST");: Đặt phương thức của yêu cầu HTTP là POST.
6. conn.setRequestProperty("Content-Type", "application/json; utf-8");: Đặt loại dữ liệu là JSON.
7. conn.setDoOutput(true);: Cho phép gửi dữ liệu qua kết nối.
8. JSONObject jsonInput = new JSONObject();: Tạo một đối tượng JSON chứa dữ liệu cần gửi.
9. os.write(input, 0, input.length);: Gửi dữ liệu JSON tới API.
10. int responseCode = conn.getResponseCode();: Lấy mã phản hồi từ API để kiểm tra trạng thái yêu cầu.

Yêu cầu hệ thống

• Phiên bản Java: JDK 8 trở lên
• Thư viện: org.json (có thể tải xuống từ Maven hoặc thêm thủ công)

Cách cài đặt các thư viện để chạy được đoạn mã Java trên

Bạn có thể thêm thư viện org.json vào dự án Maven của mình bằng cách thêm phần sau vào file pom.xml:

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20210307</version>
</dependency>

Lời khuyên

• Hãy kiểm tra kỹ URL API và đảm bảo nó là chính xác.
• Đọc tài liệu của API để biết thêm về cấu trúc dữ liệu mà API yêu cầu.
• Luôn kiểm tra mã phản hồi từ API để xử lý các trường hợp lỗi một cách thích hợp.