1688：item_search_shop-获得店铺的所有商品接口接入解决方案

为了进行1688平台店铺商品API接口开发，正常会有以下几个步骤操作：

1）开发者注册一个账号。

2）然后为每个淘宝应用注册一个应用程序键（App Key) 。

3）下载API的SDK并掌握基本的API基础知识和调用，具体可以参考博客的信息（1688商品详情介绍）里面的技术分享区等。

4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。

5）利用开放平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取。

6）无需以上五点，可直接注册账号调用接口，点击注册获取key和secret测试账号

以上是一般1688开放平台API应用开发的关键流程，其中通过淘宝文档中心和API测试工具，进行概念了解和接口信息查询很重要。支持平台有淘宝、天猫、1688、京东、阿里巴巴、阿里妈妈、亚马逊、Eaby、lazada、拼多多、翻译接口等25个平台数据。

一、item_search_shop-获得店铺的所有商品接口请求参数：
名称 类型 必须 描述
key String 是 调用key（必须以GET方式拼接在URL中）
secret String 是 调用密钥
api_name String 是 API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache String 否 [yes,no]默认yes，将调用缓存的数据，速度比较快
result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang String 否 [cn,en,ru]翻译语言，默认cn简体中文
version String 否 API版本
二、请求参数
请求参数：seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=
参数说明：seller_nick:店铺昵称或sid(目前只支持sid))
start_price:开始价格
end_price:结束价格
q:搜索关键字
page:页数
cid:分类ID
三、响应参数
名称 类型 示例值 描述
items items[] 店铺的所有商品
num_iid Bigint 628675986215 宝贝ID
title String 圆形服装店吊牌定做女装衣服吊卡订制800g加厚烘培礼品花卉卡片 商品标题
pic_url String https://cbu01.alicdn.com/img/ibank/2020/386/208/22202802683_1873238575.search.jpg 宝贝图片
price Float 138.00 价格
detail_url String https://detail.1688.com/offer/628675986215.html 商品链接

四、请求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python…)

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/1688/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}

API 工具
API SDK调用示例
APISDK下载
API测试工具

如何开通API测试，点击立即开通