使用 Java 获取咸鱼商品详情接口（item_get）返回数据的完整指南

最新推荐文章于 2025-04-17 19:04:06 发布

JelenaAPI小小爬虫

最新推荐文章于 2025-04-17 19:04:06 发布

阅读量1.4k

点赞数 23

文章标签： java 开发语言

本文链接：https://blog.csdn.net/2401_89446003/article/details/146262605

版权

在电商领域，获取商品详情数据是实现商品推荐、数据分析和用户体验优化的重要基础。咸鱼作为国内知名的二手商品交易平台，提供了丰富的商品详情接口（item_get），允许开发者通过商品 ID 获取商品的详细信息。本文将详细介绍如何使用 Java 编写程序，通过咸鱼的 item_get 接口获取商品详情数据，并处理返回结果。

一、接口概述

咸鱼的 item_get 接口允许开发者通过商品 ID（item_id）获取商品的详细信息，包括商品标题、价格、描述、图片、销量等。这些信息可用于构建商品详情页、数据分析或个性化推荐。

接口功能

获取商品基本信息：包括商品标题、价格、库存、销量等。
获取商品描述：包括商品的详细描述、规格参数等。
获取图片信息：包括商品主图和详情页图片。
获取卖家信息：包括卖家昵称、信誉等。

二、准备工作

（一）注册开发者账号

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

（二）获取 Access Token

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

（三）添加依赖

在项目中引入 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 实现

（一）获取 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 XianyuApi {
    private static final String AUTH_URL = "https://api.xianyu.com/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();
        }
    }
}

（二）调用 `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 XianyuApi {
    private static final String ITEM_GET_URL = "https://api.xianyu.com/item/get";

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

（三）解析返回数据

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 itemId = "123456789"; // 商品 ID

        try {
            String accessToken = XianyuApi.getAccessToken(clientId, clientSecret);
            String response = XianyuApi.getItemDetails(accessToken, itemId);
            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());
                System.out.println("商品描述: " + data.get("desc").getAsString());
            } else {
                System.out.println("获取商品详情失败: " + json.get("message").getAsString());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

四、接口返回数据示例

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

JavaScript

{
    "code": 0,
    "message": "success",
    "data": {
        "item_id": "123456789",
        "title": "二手 iPhone 13，95 新",
        "price": "2500",
        "inventory": 1,
        "pic_url": "https://...",
        "desc": "手机 95 新，无拆无修，支持验机。",
        "sales": 5,
        "shop_id": "987654321",
        "shop_name": "二手数码店",
        "shop_rating": 4.8
    }
}