0
点赞
收藏
分享

微信扫一扫

学会通过商品id来获得商品详情


 前往注册开通测试

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

未知错误


举报

相关推荐

0 条评论