在电商数据采集与分析场景中，1688 作为国内知名的 B2B 电商平台，其 API 提供了获取商品详情、价格、库存等实时数据的便捷途径。本文将详细介绍如何使用 Java 调用 1688 的
alibaba.product.get 接口获取商品的详细信息，并提供完整的代码示例。一、前期准备
（一）Java 开发环境
确保你的 Java 开发环境已经安装了以下必要的库：
- OkHttp：用于发送 HTTP 请求。
- commons-codec：用于生成 MD5 签名。
- FastJSON：用于解析 JSON 数据。
可以通过 Maven 来管理这些依赖，在你的
pom.xml 文件中添加以下依赖：xml
<dependencies>
<!-- OkHttp：HTTP请求库 -->
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>4.9.3</version>
</dependency>
<!-- commons-codec：MD5加密工具 -->
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.15</version>
</dependency>
<!-- FastJSON：JSON解析工具 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.83</version>
</dependency></dependencies>（二）注册 1688 开放平台账号
在 1688 开放平台上注册成为开发者，并创建应用以获取
AppKey 和 AppSecret。这些凭证将用于构建访问 API 的请求。二、调用 1688 商品详情接口
（一）生成签名
在使用 1688 API 时，需要生成签名以验证请求的合法性。以下是一个生成签名的工具方法：
java
import java.security.MessageDigest;import java.net.URLEncoder;public class SignatureUtil {
public static String md5(String str) throws Exception {
MessageDigest md = MessageDigest.getInstance("MD5");
byte[] bytes = md.digest(str.getBytes("UTF-8"));
StringBuilder sb = new StringBuilder();
for (byte b : bytes) {
sb.append(String.format("%02x", b));
}
return sb.toString();
}}（二）发送请求
以下是一个完整的 Java 示例代码，展示如何调用 1688 的
alibaba.product.get 接口获取商品详情：java
import okhttp3.OkHttpClient;import okhttp3.Request;import okhttp3.Response;import com.alibaba.fastjson.JSONObject;import java.util.*;import java.net.URLEncoder;public class AlibabaProductApi {
// 配置参数（替换为实际信息）
private static final String APP_KEY = "你的appkey";
private static final String APP_SECRET = "你的secret";
private static final String PRODUCT_ID = "694567890123";
private static final String API_URL = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get";
public static void main(String[] args) throws Exception {
// 1. 组装参数（TreeMap 自动按 key 升序排序）
Map<String, String> params = new TreeMap<>();
params.put("app_key", APP_KEY);
params.put("method", "alibaba.product.get");
params.put("timestamp", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
params.put("v", "1.0");
params.put("format", "json");
params.put("productId", PRODUCT_ID);
params.put("fields", "productId,title,priceRange,moq,stock");
// 2. 生成签名
StringBuilder signStr = new StringBuilder();
for (Map.Entry<String, String> entry : params.entrySet()) {
signStr.append(entry.getKey()).append("=")
.append(URLEncoder.encode(entry.getValue(), "UTF-8")).append("&");
}
// 拼接 secret 并去除末尾 &
signStr.append("secret=").append(APP_SECRET);
String sign = SignatureUtil.md5(signStr.toString()).toUpperCase();
params.put("sign", sign);
// 3. 构建请求 URL
StringBuilder urlBuilder = new StringBuilder(API_URL).append("?");
for (Map.Entry<String, String> entry : params.entrySet()) {
urlBuilder.append(entry.getKey()).append("=")
.append(URLEncoder.encode(entry.getValue(), "UTF-8")).append("&");
}
String url = urlBuilder.substring(0, urlBuilder.length() - 1);
// 4. 发送请求与解析
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder().url(url).build();
try (Response response = client.newCall(request).execute()) {
String result = response.body().string();
JSONObject json = JSONObject.parseObject(result);
if (json.getBoolean("success")) {
JSONObject product = json.getJSONObject("result").getJSONObject("product");
System.out.println("商品标题：" + product.getString("title"));
System.out.println("起订量：" + product.getString("moq") + "件");
} else {
System.out.println("错误：" + json.getString("errorMessage"));
}
}
}}三、注意事项
（一）遵守 API 使用规则
- 遵守 1688 开放平台的 API 使用规则，不要频繁发起请求或超出请求限制。
- 保护好
AppKey和AppSecret，不要泄露给任何人。 - 及时关注 1688 开放平台的更新与变动，以便及时调整代码以适应新的 API 接口。
（二）优化代码性能
- 数据缓存：对于短期内重复请求的数据，利用内存缓存（如 Java 的 Guava Cache）或分布式缓存（如 Redis）存储，下次请求时优先从缓存读取，减少 API 调用开销。
- 优化请求频率：除遵循平台规则外，可采用延迟加载策略，在数据非紧急需求时，适当延长请求间隔，结合异步编程（如 Java 的
CompletableFuture），让请求在后台执行，不阻塞主线程，提升整体响应性能。
四、总结
通过上述步骤和代码示例，你可以高效地利用 Java 调用 1688 商品详情 API 接口，获取商品的详细信息。在实际应用中，需注意遵守 1688 开放平台的 API 使用规则，保护好
AppKey 和 AppSecret，并根据需求优化代码性能，以实现高效、稳定的数据获取。