api接口技术开发分享，快手app根据ID获取商品详情接口，采集商品规格信息列表说明

Cris20230328 / 2023-07-08 / 原文

快手商品详情API接口的作用是获取快手平台上商品的详细信息。通过该接口，可以获取到商品的名称、描述、价格、图片、评论等相关信息。以下是快手商品详情API接口的一些重要作用：

提供商品详细信息：快手商品详情API接口可以提供全面的商品信息，包括商品的名称、品牌、产地、规格、包装等详细信息。这些信息有助于用户全面了解商品的特点和属性。
支持用户购买决策：商品详情API接口提供商品的价格、优惠活动以及其他用户的评价和评论。这些信息可以帮助用户更好地评估商品的性价比，做出更明智的购买决策。
展示商品图片和描述：通过商品详情API接口可以获取到商品的图片和描述信息。这些素材可以用于在应用或网站上展示商品，吸引用户的注意力，并提供更直观的购物体验。
促进销售和推广：快手商品详情API接口可以提供商品的推广信息，包括促销活动和限时优惠等。开发者可以利用这些信息在应用或网站中展示商品，吸引用户进行购买。
进行市场研究和竞品分析：通过商品详情API接口，可以获取到快手平台上其他商家的商品信息。这些数据可以用于市场研究和竞品分析，帮助商家了解市场需求和竞争态势，制定更有效的销售策略。

总而言之，快手商品详情API接口的作用是为开发者提供获取商品详细信息、支持用户购买决策、展示商品、促进销售和推广以及进行市场研究和竞品分析等功能，以提供更好的用户体验和增加商家的销售额。

ks.item_get-根据ID取商品详情

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中），注册key和secret接入
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版本

请求参数

请求参数：num_iid=79356974

参数说明：num_iid:商品ID ; delist_time不为空代表商品已下架;数据会获取异常。

响应参数

Version: Date:2023-05-29

名称	类型	必须	示例值	描述
item	item[]	1		商品详情数据
num_iid	Bigint	1	20046611202546	商品ID
title	String	1	重磅200克男款休闲百搭【招财猫】纯棉短袖T恤	宝贝标题
desc_short	String	0		商品简介
price	Float	1	11.93	价格
total_price	Float	0
orginal_price	String	0	11.93	原价
suggestive_price	Float	0
nick	String	1	达人丽丽教搭配	掌柜昵称
num	Int	0	0	库存
min_num	Int	0	0	最小购买数
detail_url	String	0	https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546	宝贝链接
pic_url	String	1	https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg	宝贝图片
brand	String	0	其他/other	品牌名称
brandId	Int	0		品牌ID
rootCatId	Int	0		顶级分类ID
cid	Int	0	0
crumbs	Mix	0	[]	导航菜单
desc	String	0	https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg	商品详情
desc_img	Mix	0	[]	商品详情图片
item_imgs	Mix	0	item_imgs[]	商品图片
props_name	String	0		商品属性名
prop_imgs	prop_imgs[]	0		商品属性图片列表
property_alias	String	0		销售属性值别名
props	Mix	0	[{name: "品牌",value: "其他/other"}]	商品属性
skus	skus[]	0		商品规格信息列表
seller_id	Int	0	407236546	卖家ID
shop_id	Int	0	407236546	店铺ID
seller_info	seller_info[]	0	卖家信息	Array

Java请求示例

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

}

响应示例

{
        "item": {
            "num_iid": "20046611202546",
            "title": "重磅200克男款休闲百搭【招财猫】纯棉短袖T恤",
            "desc_short": "",
            "price": 19.9,
            "total_price": 0,
            "suggestive_price": 0,
            "orginal_price": 0,
            "nick": "达人丽丽教搭配",
            "num": 0,
            "min_num": 0,
            "detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546",
            "pic_url": "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg",
            "brand": "其他/other",
            "brandId": null,
            "rootCatId": 0,
            "cid": 0,
            "crumbs": [],
            "created_time": "",
            "modified_time": "",
            "delist_time": "",
            "desc": [
                "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg",
                "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-56e029ac29624b3bb984bc11730bfe12.jpg",
            ],
            "desc_img": [],
            "item_imgs": [
                {
                    "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg"
                },
                {
                    "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-68b7ad1802a9475e929adad9efe06bf2.jpg"
                }
            ],
            "item_weight": "",
            "item_size": "",
            "location": "",
            "post_fee": "",
            "express_fee": "",
            "ems_fee": "",
            "shipping_to": "",
            "has_discount": "",
            "video": [],
            "is_virtual": "",
            "sample_id": "",
            "is_promotion": "",
            "props_name": null,
            "prop_imgs": {
                "prop_img": []
            },
            "property_alias": "",
            "props": [
                {
                    "name": "品牌",
                    "value": "其他/other"
                },
                {
                    "name": "主材质",
                    "value": "棉"
                }
            ],
            "total_sold": "",
            "skus": {
                "sku": [
                    {
                        "price": 19.9,
                        "total_price": 0,
                        "orginal_price": 0,
                        "properties": "20601742184:20601742196",
                        "properties_name": "20601742184:20601742196:白色:4XL 170-185斤;",
                        "quantity": 679,
                        "sku_id": 70581398202546
                    },
                    {
                        "price": 19.9,
                        "total_price": 0,
                        "orginal_price": 0,
                        "properties": "20601742184:20601742197",
                        "properties_name": "20601742184:20601742197:白色:5XL 185-200斤;",
                        "quantity": 685,
                        "sku_id": 70581398203546
                    }
                ]
            },
            "seller_id": 407236546,
            "sales": "311",
            "shop_id": 407236546,
            "props_list": [],
            "seller_info": {
                "nick": "达人丽丽教搭配",
                "shop_type": null,
                "user_num_id": 407236546,
                "sid": 407236546,
                "title": "达人丽丽教搭配",
                "zhuy": "https://app.kwaixiaodian.com/page/kwaishop-c-shoplist?layoutType=4&enableWK=1&id=407236546",
                "shop_name": "达人丽丽教搭配"
            },
            "tmall": "false",
            "warning": "",
            "url_log": [],
            "shop_name": "达人丽丽教搭配",
            "_ddf": "jf",
            "props_img": [],
            "format_check": "fail"
        },
        "error": "",
        "translate_status": "",
        "translate_time": 0,
        "language": {
            "default_lang": "cn",
            "current_lang": "cn"
        },
        "reason": "",
        "error_code": "0000",
        "cache": 0,
        "api_info": "today:5 max:30000 all[7=5+0+2];expires:2024-05-20",
        "execution_time": "0.579",
        "server_time": "Beijing/2023-05-29 11:21:26",
        "client_ip": "106.6.37.94",
        "call_args": {
            "num_iid": "20046611202546"
        },
        "api_type": "ks",
        "translate_language": "zh-CN",
        "translate_engine": "baidu",
        "server_memory": "3.08MB",
        "request_id": "1.64741a35a4d99",
        "last_id": "1770033004"}

异常示例

{
            "error": "item-not-found",
            "reason": "商品没找到",
            "error_code": "2000",
            "success": 0,
            "cache": 0,
            "api_info": "today:0 max:10000",
            "execution_time": 0.081,
            "server_time": "Beijing/2020-06-10 23:44:00",
            "call_args": [],
            "api_type": "ks",
            "request_id": "20046611202546"}
    }