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

虾皮shopee根据ID取商品详情 API 返回值说明

news 来源：原创 2024/5/7 2:50:43

1、公共参数

请求地址: https://api-gw.onebound.cn/shopee/item_get

名称	类型	必须	描述
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版本

2、请求参数

请求参数：num_iid=264070136/5637247041&country=.com.my

参数说明：num_iid:商品ID-country:网站后缀（.com.my;.vn;.ph）

3、响应参数

Version: Date:

名称	类型	示例值	描述
num_iid	Bigint	5637247041	宝贝ID
title	String	Fashionable plus size womens dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit	宝贝标题
price	Float	22.17	价格
orginal_price	String	31.68	原价
num	Int	3836	库存
detail_url	String	https://shopee.com.my/product/264070136/5637247041	宝贝链接
pic_url	String	https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a	宝贝图片
brand	String	No Brand	品牌名称
favcount	Int	2027
desc	String
skus	Mix	{"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "0:0", "properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】", "quantity": "305", "sku_id": "3166598625985"}]	商品规格信息列表
has_discount	String	true
item_size	String
cid	Int	16
currency	String	MYR
size_chart	String	https://cf.shopee.com.my/file/6105b7c64414c2012908bff679b9321d
sales	Int	138	销量
item_imgs	Mix	[{ "url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"}	商品图片
discount	String	30%
location	String	Mainland China	发货地
shop_id	Int	151372205	店铺ID
seller_info	Mix	{"nick": "qzq1274334183.my", "city": "Mainland China", "level": 12, "seller_promotion_refresh_time": "2021-01-19 02:00:00", "zhuy": "https://shopee.com.my/shop/264070136/search", "shop_type": "A"}	卖家信息
prop_imgs	Mix	[]	属性图片
props_list	Mix	{20509:9974422: 尺码:36}	商品属性
props_name	String	0:0:T-shirt+skirt:M 建议【42.5-50KG】;0:1:T-shirt+skirt:L 建议【50-57.5kg】;	商品属性名
props	Mix	[{ "name": "产地","value": "中国" }]	商品详情
current_lang	String	en
currency_code	String	MYR
props_img	Mix	1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg	属性图片
shop_item	Mix	[]
relate_items	Mix	[]
tmall	Boolean	false	是否天猫
error	String		错误信息
warning	String	price_json error;skus miss;	警告信息
url_log	Mix	[]
method	String	item_tmall:pget_item
promo_type	String

4、请求示例

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/shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}