前往注册开通测试
onebound.suning.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版本  | 
请求参数
请求参数:num_iid=0070517287/000000012389328898
参数说明:num_iid:店铺ID/商品ID
响应参数
Version: Date:
名称  | 类型  | 必须  | 示例值  | 描述  | 
num_iid  | Bigint  | 0  | 商品ID  | |
title  | String  | 0  | 商品标题  | |
desc_short  | String  | 0  | 商品简介  | |
price  | Int  | 0  | 价格  | |
total_price  | Int  | 0  | ||
suggestive_price  | Int  | 0  | ||
orginal_price  | Int  | 0  | 原价  | |
nick  | String  | 0  | 卖家昵称  | |
num  | Int  | 0  | ||
min_num  | Int  | 0  | ||
detail_url  | String  | 0  | 商品链接  | |
pic_url  | String  | 0  | 商品图片  | |
brand  | String  | 0  | 品牌名称  | |
brandId  | String  | 0  | 品牌ID  | |
rootCatId  | String  | 0  | 顶级分类ID  | |
cid  | String  | 0  | ||
crumbs  | Mix  | 0  | 导航列表  | |
created_time  | String  | 0  | ||
modified_time  | String  | 0  | ||
delist_time  | String  | 0  | ||
desc  | String  | 0  | ||
desc_img  | Mix  | 0  | 商品描述图片  | |
item_imgs  | Mix  | 0  | 商品图片  | |
item_weight  | String  | 0  | ||
item_size  | String  | 0  | ||
location  | String  | 0  | 发货地  | |
post_fee  | String  | 0  | 物流费用  | |
express_fee  | String  | 0  | 快递费用  | |
ems_fee  | String  | 0  | EMS费用  | |
shipping_to  | String  | 0  | 发货至  | |
has_discount  | String  | 0  | ||
video  | Mix  | 0  | 商品视频  | |
is_virtual  | String  | 0  | ||
sample_id  | String  | 0  | 商品风格标识ID  | |
is_promotion  | String  | 0  | ||
props_name  | String  | 0  | 商品属性名  | |
prop_imgs  | Mix  | 0  | 商品属性图片列表  | |
property_alias  | String  | 0  | 商品属性别名  | |
props  | Mix  | 0  | 商品详情  | |
total_sold  | String  | 0  | ||
skus  | Mix  | 0  | 商品规格信息  | |
seller_id  | String  | 0  | 卖家ID  | |
sales  | String  | 0  | 销量  | |
shop_id  | String  | 0  | 店铺ID  | |
props_list  | Mix  | 0  | 商品属性  | |
seller_info  | Mix  | 0  | 卖家信息  | |
tmall  | Boolean  | 0  | 是否天猫  | |
error  | String  | 0  | 错误信息  | |
warning  | String  | 0  | 警告信息  | |
url_log  | String  | 0  | ||
sold  | Int  | 0  | ||
props_img  | Mix  | 0  | ||
shopinfo  | String  | 0  | 店铺信息  | |
shop_item  | Mix  | 0  | ||
relate_items  | Mix  | 0  | 
请求示例
- Curl
 - PHP
 - PHPsdk
 - JAVA
 - C#
 - Python
 
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/suning/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=0070517287/000000012389328898"响应示例
"item": {
		"num_iid": "0070517287/000000012389328898",
		"title": "苹果(Apple) iPhone 14 Pro 256GB 暗紫色 2022新款移动联通电信5G全网通手机 国行原装官方正品 苹果iphone14pro 双卡双待",
		"desc_short": "",
		"price": null,
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": null,
		"nick": null,
		"num": "99",
		"min_num": 0,
		"detail_url": "http://product.suning.com/0070517287/000000012389328898.html",
		"pic_url": "//imgservice.suning.cn/uimg1/b2c/image/Il42sgX0BFqzQj5vM-TwNA.jpg_400w_400h_4e",
		"brand": null,
		"brandId": null,
		"rootCatId": null,
		"cid": null,
		"crumbs": {
			"20002": "手机通讯",
			"20006": "手机",
			"20089": "手机/数码/配件"
		},
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/cMr1AytfrWq51Ur14LMzyg.jpg\" /><img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/J4V_C9luBUxoC0xMlFP8NA.jpg\" /><img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/AyCSPM3qSfsu5rCFkBDjbw.jpg\" /><img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/hEiWhtRV85EfZ1g4LiLbgw.jpg\" /><img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/J-ZNCKCYBAoLXUF2dEyN_w.jpg\" /><img src=\"https://uimgproxy.suning.cn/uimg1/sop/commodity/g04phP2LUyHd2oNFhVP1JA.jpg\" /><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.6340d6c60eed9&p=1778786368&k=i_key&t=1665193677\" style=\"display:none\" />",
		"desc_img": [],
		"item_imgs": [
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/ogLZG2oIbtbcaOORKur1AA.png_800w_800h_4e"
			},
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/Il42sgX0BFqzQj5vM-TwNA.jpg_800w_800h_4e"
			},
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/DNdgajX_L-N3i2vTV1BQ6Q.jpg_800w_800h_4e"
			},
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/MAM4PNZzHwZ5OC7UXD6sWQ.jpg_800w_800h_4e"
			},
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/aX4zFpPvx_3yBjJlWh8_Lg.jpg_800w_800h_4e"
			},
			{
				"url": "//imgservice.suning.cn/uimg1/b2c/image/fGmXnjgrRzCmSG_vIFIqAg.jpg_800w_800h_4e"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "",
		"props_name": false,
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": false,
		"props": [
			{
				"name": "品牌",
				"value": "Apple"
			},
			{
				"name": "型号",
				"value": "iPhone 14 Pro"
			},
			{
				"name": "上市年份",
				"value": "2022年"
			},
			{
				"name": "上市月份",
				"value": "9月"
			},
			{
				"name": "入网许可证号",
				"value": "00-8573-217560"
			},
			{
				"name": "整机质保年限",
				"value": "1年"
			},
			{
				"name": "机身内存",
				"value": "256GB"
			},
			{
				"name": "运行内存",
				"value": "6GB"
			},
			{
				"name": "屏幕尺寸",
				"value": "6.1英寸"
			},
			{
				"name": "屏幕分辨率",
				"value": "2556 x 1179"
			},
			{
				"name": "屏幕材质",
				"value": "OLED"
			},
			{
				"name": "屏幕像素密度(ppi)",
				"value": "460"
			},
			{
				"name": "屏幕类型",
				"value": "全面屏"
			},
			{
				"name": "屏幕前摄组合",
				"value": "其他"
			},
			{
				"name": "屏刷新率",
				"value": "120Hz"
			},
			{
				"name": "摄像头类型",
				"value": "以官网信息为准"
			},
			{
				"name": "前摄像头",
				"value": "1200万像素"
			},
			{
				"name": "后摄像头",
				"value": "2556 x 1179万像素"
			},
			{
				"name": "拍照特点",
				"value": "广角拍摄,防抖,自动对焦,HDR,3D深感"
			},
			{
				"name": "后摄光圈大小",
				"value": "f/2.8光圈"
			},
			{
				"name": "变焦模式",
				"value": "光学变焦"
			},
			{
				"name": "颜色",
				"value": "暗紫色"
			},
			{
				"name": "机身长度",
				"value": "147.5毫米"
			},
			{
				"name": "机身宽度",
				"value": "71.5毫米"
			},
			{
				"name": "机身厚度",
				"value": "7.85毫米"
			},
			{
				"name": "重量",
				"value": "206克"
			},
			{
				"name": "机身材质",
				"value": "以官网信息为准"
			},
			{
				"name": "手机操作系统",
				"value": "IOS"
			},
			{
				"name": "CPU品牌",
				"value": "以官方信息为准"
			},
			{
				"name": "CPU型号",
				"value": "A16仿生"
			},
			{
				"name": "CPU核数",
				"value": "以官网信息为准"
			},
			{
				"name": "5G网络制式",
				"value": "全网通5G"
			},
			{
				"name": "双卡机类型",
				"value": "双卡双待"
			},
			{
				"name": "最大支持SIM卡数量",
				"value": "2个"
			},
			{
				"name": "SIM卡尺寸",
				"value": "Nano SIM卡"
			},
			{
				"name": "4G网络制式",
				"value": "全网通"
			},
			{
				"name": "3G网络制式",
				"value": "联通3G,电信3G,移动3G"
			},
			{
				"name": "2G网络制式",
				"value": "电信2G,移动2G/联通2G,联通2G,移动2G"
			},
			{
				"name": "快充瓦数",
				"value": "以官网信息为准"
			},
			{
				"name": "无线充电",
				"value": "支持"
			},
			{
				"name": "快充功能",
				"value": "支持"
			},
			{
				"name": "电池更换",
				"value": "不支持"
			},
			{
				"name": "数据传输接口",
				"value": "蓝牙,NFC,WIFI"
			},
			{
				"name": "耳机接口",
				"value": "以官网信息为准"
			},
			{
				"name": "充电接口类型",
				"value": "Lightning(iPhone)"
			},
			{
				"name": "GPS",
				"value": "支持"
			},
			{
				"name": "重力传感器",
				"value": "支持"
			},
			{
				"name": "光线传感器",
				"value": "支持"
			},
			{
				"name": "距离传感器",
				"value": "支持"
			},
			{
				"name": "选购热点",
				"value": "面部识别"
			},
			{
				"name": "CCC认证编号",
				"value": "2019011606222162"
			},
			{
				"name": "生产者(制造商)名称",
				"value": "美国苹果公司"
			}
		],
		"total_sold": "",
		"skus": {
			"sku": []
		},
		"seller_id": "",
		"sales": "",
		"shop_id": "70517287",
		"props_list": [],
		"seller_info": {
			"nick": null,
			"city": null,
			"shopid": "70517287",
			"shopname": null,
			"title": null,
			"zhuy": "https://shop.suning.com/70517287/index.html",
			"tel": null
		},
		"tmall": "false",
		"warning": "",
		"url_log": [],
		"sold": null,
		"props_img": [],
		"shopinfo": {
			"shop_name": null
		},
		"format_check": "fail"
	},
	"error": "data error",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "zh-CN",
		"current_lang": "cn"
	},异常示例相关资料错误码解释
状态代码(error_code)  | 状态信息  | 详细描述  | 是否收费  | 
0000  | success  | 接口调用成功并返回相关数据  | 是  | 
2000  | Search success but no result  | 接口访问成功,但是搜索没有结果  | 是  | 
4000  | Server internal error  | 服务器内部错误  | 否  | 
4001  | Network error  | 网络错误  | 否  | 
4002  | Target server error  | 目标服务器错误  | 否  | 
4003  | Param error  | 用户输入参数错误  | 忽略  | 
4004  | Account not found  | 用户帐号不存在  | 忽略  | 
4005  | Invalid authentication credentials  | 授权失败  | 忽略  | 
4006  | API stopped  | 您的当前API已停用  | 忽略  | 
4007  | Account stopped  | 您的账户已停用  | 忽略  | 
4008  | API rate limit exceeded  | 并发已达上限  | 忽略  | 
4009  | API maintenance  | API维护中  | 忽略  | 
4010  | API not found with these values  | API不存在  | 忽略  | 
4012  | Please add api first  | 请先添加api  | 忽略  | 
4013  | Number of calls exceeded  | 调用次数超限  | 忽略  | 
4014  | Missing url param  | 参数缺失  | 忽略  | 
4015  | Wrong pageToken  | 参数pageToken有误  | 忽略  | 
4016  | Insufficient balance  | 余额不足  | 忽略  | 
4017  | timeout error  | 请求超时  | 否  | 
5000  | unknown error  | 未知错误  | 否  | 










