1688商品数据采集API的测试对接步骤分享（提供免费测试key）

在电商数据分析和运营中，自动化采集商品数据是一项重要任务。1688作为中国领先的B2B电商平台，提供了丰富的API接口，方便开发者进行数据采集。本文将详细介绍如何通过1688的商品数据采集API进行测试对接，并提供免费测试key以供参考。

一、准备工作

1. 注册账号：首先，你需要在1688开放平台（或其他类似平台）注册一个开发者账号。
2. 申请Key和Secret ：登录开发者中心，申请成为开发者并创建应用，即可获取API的Key和Secret（测试）。这两个参数是调用API时必需的认证信息。

注意：为了安全起见，实际生产环境中不应使用本文提供的测试key和secret，应自行申请。

二、API接口介绍

1688提供了多种API接口，其中与商品数据采集相关的接口主要有：

• item_get：获取商品详情。
• item_search：按关键字搜索商品。
• item_search_img：按图搜索商品（拍立淘）。
• item_fee：获取商品快递费用。

本文将重点介绍item_get接口的使用。

三、API测试对接步骤

1. 确定API端点和参数：

   • 端点：https://api-gw.onebound.cn/taobao/item_get/
   • 参数：
     • key：API Key
     • secret：API Secret
     • num_iid：1688商品ID
     • 其他可选参数，如sales_data（获取近30天成交数据）、agent（获取分销代发价格数据）等。

2. 编写请求代码：

以下是一个使用Java进行API请求的示例代码：

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;

public class Example {
    private static String readAll(Reader rd) throws IOException {
        StringBuilder sb = new StringBuilder();
        int cp;
        while ((cp = rd.read()) != -1) {
            sb.append((char) cp);
        }
        return sb.toString();
    }

    public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
        URL realUrl = new URL(url);
        URLConnection conn = realUrl.openConnection();
        conn.setDoOutput(true);
        conn.setDoInput(true);
        PrintWriter out = new PrintWriter(conn.getOutputStream());
        out.print(body);
        out.flush();
        InputStream instream = conn.getInputStream();
        try {
            BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
            String jsonText = readAll(rd);
            JSONObject json = new JSONObject(jsonText);
            return json;
        } finally {
            instream.close();
        }
    }

    public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
        URL realUrl = new URL(url);
        URLConnection conn = realUrl.openConnection();
        InputStream instream = conn.getInputStream();
        try {
            BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
            String jsonText = readAll(rd);
            JSONObject json = new JSONObject(jsonText);
            return json;
        } finally {
            instream.close();
        }
    }

    public static void main(String[] args) throws IOException, JSONException {
        // 请求示例 url 默认请求参数已经URL编码处理
        String url = "https://api-gw.onebound.cn/taobao/item_get/?key=<Your_API_Key>&secret=<Your_API_Secret>&num_iid=610947572360";
        JSONObject json = getRequestFromUrl(url);
        System.out.println(json.toString());
    }
}

注意：将

<Your_API_Key>和<Your_API_Secret>替换为你自己的API Key和Secret。

1. 查看响应数据：

运行上述代码后，你将获得一个JSON格式的响应数据。以下是一个响应数据的示例：

{
    "item": {
        "num_iid": "520813250866",
        "title": "三刃木折叠刀创意迷你钥匙扣钥匙刀户外随身多功能锋利开箱小刀",
        "desc_short": "",
        "price": 22.7,
        "orginal_price": 25.8,
        "nick": "欢乐购客栈",
        "num": 600,
        "pic_url": "https://gw.alicdn.com/imgextra/O1CN01L8HLol1jaonor67d8_!!2596264565.jpg",
        "brand": null,
        "brandId": 0,
        "rootCatId": 0,
        "cid": 50014822,
        "detail_url": "https://item.taobao.com/item.htm?id=520813250866",
        "desc": "<p><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i2/2596264565/TB2nAHqgyC9MuFjSZFoXXbUzFXa_!!2596264565.jpg\" /><img align=\"absmiddle\" src=\"http://img.alicdn.com/imgextra/i3/2596264565/TB2ahCelVXXXXc_XXXXXXXXXXXX_!!2596264565.jpg\" /></p>",
        "item_imgs": [
            { "url": "https://gw.alicdn.com/imgextra/O1CN01L8HLol1jaonor67d8_!!2596264565.jpg" },
            { "url": "//img.alicdn.com/bao/uploaded/i1/2596264565/O1CN01jcuVBb1jaomeRuMkL_!!0-item_pic.jpg" },
            // 其他图片URL...
        ],
        "item_weight": 0,
        "location": "广东深圳",
        "post_fee": 0,
        "express_fee": 0,
        "ems_fee": 0,
        "has_discount": "true",
        // 其他字段...
    }
}

四、整理后的数据表格

为了更直观地展示采集到的商品数据，可以将其整理成表格形式。以下是一个示例表格：

字段名称	字段类型	示例值
num_iid	String	520813250866
title	String	三刃木折叠刀创意迷你钥匙扣钥匙刀户外随身多功能锋利开箱小刀
desc_short	String	（空）
price	Float	22.7
orginal_price	Float	25.8
nick	String	欢乐购客栈
num	Int	600
pic_url	String	https://gw.alicdn.com/imgextra/O1CN01L8HLol1jaonor67d8_!!2596264565.jpg
brand	String	（空）
brandId	Int	0
rootCatId	Int	0
cid	Int	50014822
detail_url	String	https://item.taobao.com/item.htm?id=520813250866
item_imgs	List	[{ "url": "https://gw.alicdn.com/imgextra/O1CN01L8HLol1jaonor67d8_!!2596264565.jpg" }, ...]