前往注册开通测试
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 | 未知错误 | 否 |