利用 Java 爬蟲獲取京東商品詳情 API 返回值說明及代碼示例

在電商領域，京東作為國內知名的電商平臺，提供了豐富的商品信息。通過調用京東商品詳情 API，我們可以獲取商品的詳細信息，如商品標題、價格、圖片、描述等。這些信息對于數據分析、價格監控、商品推薦等場景具有重要價值。本文將詳細介紹如何使用 Java 爬蟲技術調用京東商品詳情 API，并對返回值進行詳細說明。

一、準備工作

1. 注冊京東開放平臺賬號

要使用京東商品詳情 API，首先需要在京東開放平臺（https://open.jd.com/）注冊賬號，并創建應用以獲取 App Key 和 App Secret。這些是調用 API 所必需的憑證。

2. 安裝必要的 Java 庫

確保你的 Java 開發環境中安裝了以下庫：

• HttpClient：用于發送 HTTP 請求。
• Jackson：用于解析 JSON 數據。
• 如果你使用 Maven 進行項目管理，可以在 pom.xml 文件中添加以下依賴：

xml

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.12.3</version>
</dependency>

二、代碼實現

以下是一個完整的 Java 示例代碼，展示如何調用京東商品詳情 API，并處理返回的數據。

1. 發送 HTTP 請求

使用 HttpClient 發送請求，并獲取 API 返回的數據。

java

import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;

public class JDProductDetailCrawler {
    public static void main(String[] args) {
        String appKey = "your_app_key"; // 替換為你的 App Key
        String appSecret = "your_app_secret"; // 替換為你的 App Secret
        String skuId = "123456"; // 替換為商品的 SKU ID
        String timestamp = String.valueOf(System.currentTimeMillis() / 1000); // 當前時間戳
        String signature = generateSignature(appKey, appSecret, timestamp); // 生成簽名

        String apiUrl = "https://api.jd.com/routerjson";
        String url = apiUrl + "?method=item_detail&app_key=" + appKey +
                     "×tamp=" + timestamp + "&v=2.0&sign_method=md5&sign=" + signature +
                     "?m_json={\"skuIds\":\"" + skuId + "\"}";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpGet request = new HttpGet(url);
            try (CloseableHttpResponse response = httpClient.execute(request)) {
                if (response.getStatusLine().getStatusCode() == 200) {
                    String jsonResponse = EntityUtils.toString(response.getEntity());
                    System.out.println("API Response: " + jsonResponse);
                    parseResponse(jsonResponse);
                } else {
                    System.out.println("請求失敗，狀態碼：" + response.getStatusLine().getStatusCode());
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private static String generateSignature(String appKey, String appSecret, String timestamp) {
        // 這里需要根據京東 API 文檔實現簽名生成邏輯
        // 示例：MD5(appKey + timestamp + appSecret)
        return "generated_signature"; // 替換為實際生成的簽名
    }

    private static void parseResponse(String jsonResponse) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            JsonNode rootNode = objectMapper.readTree(jsonResponse);
            JsonNode itemsNode = rootNode.path("jingdong_item_detail_response").path("items");

            for (JsonNode itemNode : itemsNode) {
                String numIid = itemNode.path("num_iid").asText();
                String title = itemNode.path("title").asText();
                String detailUrl = itemNode.path("detail_url").asText();
                String picUrl = itemNode.path("pic_url").asText();
                double price = itemNode.path("price").asDouble();
                String description = itemNode.path("description").asText();

                System.out.println("商品 ID: " + numIid);
                System.out.println("商品標題: " + title);
                System.out.println("商品詳情頁 URL: " + detailUrl);
                System.out.println("商品圖片 URL: " + picUrl);
                System.out.println("商品價格: " + price);
                System.out.println("商品描述: " + description);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

2. 解析返回的 JSON 數據

解析 API 返回的 JSON 數據，并提取商品的詳細信息。

java

private static void parseResponse(String jsonResponse) {
    try {
        ObjectMapper objectMapper = new ObjectMapper();
        JsonNode rootNode = objectMapper.readTree(jsonResponse);
        JsonNode itemsNode = rootNode.path("jingdong_item_detail_response").path("items");

        for (JsonNode itemNode : itemsNode) {
            String numIid = itemNode.path("num_iid").asText();
            String title = itemNode.path("title").asText();
            String detailUrl = itemNode.path("detail_url").asText();
            String picUrl = itemNode.path("pic_url").asText();
            double price = itemNode.path("price").asDouble();
            String description = itemNode.path("description").asText();

            System.out.println("商品 ID: " + numIid);
            System.out.println("商品標題: " + title);
            System.out.println("商品詳情頁 URL: " + detailUrl);
            System.out.println("商品圖片 URL: " + picUrl);
            System.out.println("商品價格: " + price);
            System.out.println("商品描述: " + description);
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}

三、API 返回值說明

京東商品詳情 API 的返回值是一個 JSON 對象，其結構如下：

返回值示例

JSON

{
    "code": "0",
    "errorMessage": "success",
    "jingdong_item_detail_response": {
        "items": [
            {
                "num_iid": "1234567890",
                "title": "商品標題",
                "detail_url": "https://item.jd.com/1234567890.html",
                "pic_url": "https://img10.360buyimg.com/n1/s200x200_jfs/t1/123456/1/1234567890.jpg",
                "price": "120.00",
                "description": "商品詳細描述"
            }
        ]
    }
}

返回值字段說明

• code：返回的狀態碼，表示請求的結果。0 表示成功，其他值表示失敗。
• errorMessage：錯誤信息，描述了返回狀態碼對應的錯誤原因。
• jingdong_item_detail_response：商品詳情信息的響應數據。items：商品列表，包含多個商品的詳細信息。num_iid：商品的唯一標識 ID。title：商品標題。detail_url：商品詳情頁的 URL。pic_url：商品圖片的 URL。price：商品當前價格。description：商品詳細描述。

四、注意事項

1. API 使用限制

京東 API 可能對請求頻率和數據量有限制。建議在實際使用中合理安排請求間隔，避免被封禁。

2. 數據隱私

確保遵守京東開放平臺的使用條款，不要濫用數據。

3. 異常處理

在請求過程中可能會遇到網絡問題、API 限制或其他錯誤。建議使用 try-catch 語句捕獲異常，并合理處理。

4. 簽名生成

根據京東 API 文檔，生成簽名是調用 API 的必要步驟。確保正確實現簽名生成邏輯。

五、總結

通過上述步驟和代碼，你可以使用 Java 爬蟲技術獲取京東商品的詳細信息，并將其保存到本地文件或數據庫中。希望這個示例對你有所幫助！