当前位置：首页 > news >正文

使用 Java 获取咸鱼（微店）商品详情接口（micro.item_get）的完整指南

news 来源：原创 2025/5/10 22:35:16

在电商领域，获取商品详情数据是实现商品推荐、数据分析和用户体验优化的重要基础。本文将详细介绍如何使用 Java 编写程序，通过微店的 micro.item_get 接口获取商品详情数据。我们将使用 HttpClient 发送 HTTP 请求，并通过 JSON 解析工具处理返回数据。

一、接口概述

micro.item_get 是微店开放平台提供的接口，用于获取指定商品的详细信息，包括商品标题、价格、库存、销量、描述、图片等。这些信息可用于构建商品详情页、数据分析或个性化推荐。

接口功能

获取商品基本信息（标题、价格、库存等）。
获取商品描述和图片链接。
获取商品销量和评价信息。

二、准备工作

1. 注册开发者账号

在微店开放平台注册开发者账号，并创建应用以获取 API 凭证（App Key 和 App Secret）。这些凭证将用于身份验证。

2. 获取 Access Token

调用接口需要使用 Access Token 进行身份验证。以下是获取 Access Token 的方法。

3. 添加依赖

在项目中引入 HttpClient 和 JSON 解析库（如 Gson 或 Jackson）。如果使用 Maven，可在 pom.xml 中添加以下依赖：

xml

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.9</version>
</dependency>

三、Java 实现

1. 获取 Access Token

java

import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

public class WeidianApi {
    private static final String AUTH_URL = "https://open.weidian.com/api/oauth2/token";

    public static String getAccessToken(String clientId, String clientSecret) throws Exception {
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpPost post = new HttpPost(AUTH_URL);
            post.addHeader("Content-Type", "application/x-www-form-urlencoded");
            post.setEntity(new org.apache.http.entity.StringEntity(
                    "grant_type=client_credentials&client_id=" + clientId + "&client_secret=" + clientSecret));
            org.apache.http.HttpResponse response = client.execute(post);
            String jsonResponse = EntityUtils.toString(response.getEntity());
            JsonObject json = JsonParser.parseString(jsonResponse).getAsJsonObject();
            return json.get("access_token").getAsString();
        }
    }
}

2. 调用 `micro.item_get` 接口

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;

public class WeidianApi {
    private static final String ITEM_GET_URL = "https://open.weidian.com/api/v3/item/detail";

    public static String getItemDetails(String accessToken, String numIid) throws Exception {
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpGet get = new HttpGet(ITEM_GET_URL + "?num_iid=" + numIid);
            get.addHeader("Authorization", "Bearer " + accessToken);
            org.apache.http.HttpResponse response = client.execute(get);
            return EntityUtils.toString(response.getEntity());
        }
    }
}

3. 解析返回数据

java

import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

public class Main {
    public static void main(String[] args) {
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";
        String numIid = "2749499386"; // 商品 ID

        try {
            String accessToken = WeidianApi.getAccessToken(clientId, clientSecret);
            String response = WeidianApi.getItemDetails(accessToken, numIid);
            JsonObject json = JsonParser.parseString(response).getAsJsonObject();
            if (json.get("code").getAsInt() == 0) {
                JsonObject data = json.getAsJsonObject("data");
                System.out.println("商品标题: " + data.get("title").getAsString());
                System.out.println("商品价格: " + data.get("price").getAsString());
                System.out.println("商品库存: " + data.get("inventory").getAsInt());
                System.out.println("商品图片: " + data.get("pic_url").getAsString());
            } else {
                System.out.println("获取商品详情失败: " + json.get("message").getAsString());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

四、接口返回数据示例

以下是接口返回的部分数据示例：

JSON

{
    "code": 0,
    "message": "success",
    "data": {
        "id": "2749499386",
        "title": "旗舰智能手机 8GB+256GB",
        "price": "2999",
        "inventory": 150,
        "pic_url": "https://...",
        "desc": "这款手机性能强大，适合游戏玩家和商务人士。",
        "sales": 1500,
        "shop_id": "778899"
    }
}