为了进行此平台API的调用,首先我们需要做下面几件事情。
1、 获取一个KEY。
2、 参考API文档里的接入方式和示例。
3、查看测试工具是否有需要的接口,响应实例的返回字段是否符合参数要求。
4、利用平台的文档中心和API测试工具,对接口进行测试、程序获取。
更多API调用展示以及获取Key和secret请移步
http://console.open.onebound.cn/console/?i=Turbo
公共参数
名称
类型
必须
描述
key
String
是
调用key(点击获取测试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=610947572360
参数说明:num_iid:1688商品IDsales_data:&sales_data=1 获取近30天成交数据agent:&agent=1 获取1688分销代发价格数据
响应参数
名称
类型
必须
示例值
描述
item
item[]
0
宝贝详情数据
num_iid
String
0
610947572360
宝贝ID
title
String
0
厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G
商品标题
desc_short
String
0
商品简介
price
Float
0
799.00
价格
total_price
Float
0
0
suggestive_price
Float
0
0
orginal_price
Float
0
799.00
原价
nick
String
0
qin多亲科技
卖家昵称
num
Int
0
2191
detail_url
String
0
https://detail.1688.com/offer/610947572360.html
宝贝链接
pic_url
String
0
https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg
宝贝图片
brand
String
0
MAJE
品牌
brandId
Int
0
8879363
品牌id
rootCatId
Int
0
0
顶级分类ID
cid
Int
0
124264005
desc
String
0
item_imgs
Mix
0
item_imgs[]
商品图片
item_weight
String
0
post_fee
Float
0
9.00
邮费
express_fee
Float
0
9.00
EMS费用
ems_fee
Float
0
9.00
物流费用
shipping_to
String
0
广东广州白云区
发货至
video
video[]
0
商品视频
sample_id
String
0
props_name
String
0
0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色
商品属性名
prop_imgs
prop_imgs[]
0
商品属性图片列表
property_alias
String
0
0:0:64GB;1:0:铁灰色;1:1:瓷白色
属性别名
props
Mix
0
[{"name": "品牌", "value": "other"}]
商品详情
total_sold
Int
0
1
scale
Int
0
sellUnit
Int
0
skus
skus[]
0
商品规格信息列表
seller_id
Int
0
2206619673102
卖家ID
sales
Int
0
100
销售额
shop_id
Int
0
151372205
店铺ID
props_list
Mix
0
{"0:0": "机身内存:64GB"}
商品属性
seller_info
seller_info[]
0
卖家信息
tmall
Boolean
0
false
是否天猫
data_from
String
0
1688app
错误信息
error
String
0
错误信息
unit
String
0
部;
单位
is_support_mix
Boolean
0
true
mix_amount
Int
0
30
mix_Begin
Int
0
mix_number
Int
0
sales_data
Date
0
location
String
0
广东省 深圳市
发货地
props_img
Mix
0
属性图片
sales_info
Mix
0
desc_img
Mix
0
[{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}]
详情图片列表
shop_item
Mix
0
relate_items
Mix
0
响应示例
{"item": {"num_iid": "610947572360","title": "厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G","desc_short": "","price": "799.00","total_price": 0,"suggestive_price": 0,"orginal_price": "799.00","nick": "qin多亲科技","num": "1763","detail_url": "https://detail.1688.com/offer/610947572360.html","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg","brand": "","brandId": "","rootCatId": "","cid": "50903","desc": "
深圳市多亲科技有限公司(简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发,在人工智能终端设备、系统软件的研发和生产领域,具有深厚的技术沉淀与实力。
多亲产品销售网络覆盖全国各地乃至远销海外,欢迎企业定制、团购、经销代理。
优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。
欢迎有意向者实地考察,垂询电话:13662284449.
温馨提示:
1、可定制--承接各种订单订制!为客户定制机身、开机画面、预装软件、包装等定制!
2、质量保证--本公司专注通讯行业10年,线下线下百花齐放,客户复购率达30%以上。
3、价格实惠--本店是工厂直供,没有中间商差价,一站到客,薄利多销。
4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货(非人为因素)30天内换新。
","item_imgs": [{"url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg"},{"url": "https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg"},{"url": "https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg"},{"url": "https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg"},{"url": "https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg"}],"item_weight": "","post_fee": "","express_fee": "","ems_fee": "","shipping_to": "","video": [],"sample_id": "","props_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色","prop_imgs": {"prop_img": []},"property_alias": "0:0:64GB;1:0:铁灰色;1:1:瓷白色","props": [{"name": "品牌","value": "多亲"},{"name": "型号","value": "Qin 2 Pro"},{"name": "手机类型","value": "老人手机"},{"name": "外形","value": "直板"},{"name": "主屏尺寸","value": "大屏幕(5.0英寸—5.9英寸)"},{"name": "网络制式","value": "移动4G(TD-LTE),联通/电信4G(FDD-LTE)"},{"name": "操作系统","value": "Android 9.0系统"},{"name": "电池容量","value": "2100"},{"name": "摄像头像素","value": "1200万-1999万"},{"name": "存储卡","value": "支持存储卡"},{"name": "处理器核心","value": "八核"},{"name": "运行内存","value": "2GB"},{"name": "手机版本","value": "大陆行货"},{"name": "售后类型","value": "全国联保"},{"name": "上市时间","value": "2019"},{"name": "适用送礼场合","value": "员工福利,颁奖纪念,广告促销,节日,展销会,公关策划,生日,商务馈赠"},{"name": "3C证书编号","value": "2019161606319519"},{"name": "CPU品牌","value": "展讯"},{"name": "运营商","value": "中国移动,中国电信,中国联通"},{"name": "网络模式","value": "单卡单模"},{"name": "机身内存","value": "64GB"},{"name": "颜色","value": "铁灰色,瓷白色"},{"name": "电信设备进网许可证编号","value": "02-B613-192425"}],"total_sold": "1","scale": "","sellUnit": "","skus": {"sku": [{"price": "799.00","total_price": 0,"sales": "55","properties": "0:0;1:1","properties_name": "0:0:机身内存:64GB;1:1:颜色:瓷白色","quantity": "932","sku_id": "4309097072612","spec_id": "63828b15ad641fdb131775f32e4c050c"},{"price": "799.00","total_price": 0,"sales": "159","properties": "0:0;1:0","properties_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色","quantity": "831","sku_id": "4302217872901","spec_id": "0eb631954bfe8fb00a45824fc6193f2f"}]},"seller_id": "2206619673102","sales": 30,"shop_id": "","props_list": {"0:0": "机身内存:64GB","1:0": "颜色:铁灰色","1:1": "颜色:瓷白色"},"seller_info": {"nick": "qin多亲科技","user_num_id": "2206619673102","sid": "b2b-2206619673102e9470","title": "深圳多亲科技实力卖场","zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470","shop_name": "qin多亲科技"},"tmall": "","data_from": "1688app","error": "","unit": "部","is_support_mix": null,"mix_amount": null,"mix_begin": null,"mix_number": null,"min_num": "2","sales_data": "","location": "广东省 深圳市","props_img": [],"sales_info": {"seller_num": "","repeat_rate_purchase": "","per_capita_purchases": "","comment_num": "","comment_url": ""},"desc_img": ["https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg","https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg"],"shop_item": [],"relate_items": []},"secache": "f75c59301daa3fc1610a8563c998f851","secache_time": 1608276252,"secache_date": "2020-12-18 15:24:12","translate_status": "","translate_time": 0,"language": {"default_lang": "cn","current_lang": "cn"},"error": "","reason": "","error_code": "0000","cache": 0,"api_info": "today:12 max:10000","execution_time": 6.65,"server_time": "Beijing/2020-12-18 15:24:17","client_ip": "182.111.155.89","call_args": {"num_iid": "610947572360","area_id": "440111"},"api_type": "1688","translate_language": "zh-CN","translate_engine": "google_cn","server_memory": "4.44MB","request_id": "gw-2.5fdc591b3bdb0"
}