为了进行此平台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=520813250866
参数说明:num_iid:淘宝商品ID
响应参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | Mix | 0 | 获得淘宝app商品详情原数据 | |
item | Mix | 0 | [] | 商品信息 |
apiStack | Mix | 0 | [] | 价格销量 |
seller | Mix | 0 | [] | 店铺信息 |
more | Mix | 0 | [] | 参数多不一一介绍,详细请看接口返回 |
返回部分数据
{
"item": {
"apiStack": [
{
"name": "esi",
"value": {
"consumerProtection": {
"items": [
{
"title": "付款后48小时内发货"
},
{
"desc": "8天退货,退货邮费买家承担",
"title": "8天退货"
},
{
"desc": "商品在运输途中出现破损的,消费者可向卖家提出补寄申请,可补寄1次,补寄邮费由买家承担",
"title": "1次破损补寄"
},
{
"desc": "购买该商品,每笔成交都会有相应金额捐赠给公益。感谢您的支持,愿公益的快乐伴随您每一天。",
"title": "公益宝贝"
},
{
"title": "集分宝"
},
{
"title": "支付宝支付"
}
],
"passValue": "all"
},
"debug": {
"app": "alidetail",
"host": "taodetail033005068013.center.na610@33.5.68.13"
},
"delivery": {
"addressWeexUrl": "https://market.m.taobao.com/apps/market/detailrax/address-picker.html?spm=a2116h.app.0.0.16d957e9nDYOzv&wh_weex=true",
"areaId": "330102",
"completedTo": "杭州 上城 小营",
"extras": [],
"from": "广东深圳",
"overseaContraBandFlag": "false",
"postage": "快递: 快递包邮",
"to": "杭州上城"
},
"diversion": {
"detailTopSearch": {
"url": "https://s.m.taobao.com/h5entry?g_channelSrp=detail&placeholder=合法刀 随身&showText=合法刀 随身&g_historyOn=true&g_csearchdoor_spm=a2141.13130650&itemId=520813250866&detailShopId=127203758"
},
"productRecommend": {
"preloadUrl": "https://gw.alicdn.com/tfs/TB1PS8nBAPoK1RjSZKbXXX1IXXa-1125-1335.png?getAvatar=avatar",
"request": {
"api": "mtop.relationrecommend.WirelessRecommend.recommend",
"params": {
"appId": "10777",
"from": "dinamicX",
"params": "{\"itemid\":520813250866,\"spm\":\"0.0.0.0.hUro0P\",\"sellerid\":2596264565,\"appId\":\"10777\"}"
},
"version": "2.0"
},
"template": {
"android": "https://ossgw.alicdn.com/rapid-oss-bucket/template_online/tb_shop_recommend/64005743/tb_shop_recommend_android.xml",
"ios": "https://ossgw.alicdn.com/rapid-oss-bucket/template_online/tb_shop_recommend/64005743/tb_shop_recommend_ios.plist",
"name": "tb_shop_recommend",
"version": "37"
}
}
},
"extendedData": [],
"feature": {
"UTABForceNewSku": "true",
"bigImageSkuProp": "true",
"cainiaoNoramal": "true",
"dailyPrice": "true",
"enableDpbModule": "false",
"freshmanRedPacket": "true",
"guessYouLike": "true",
"hasCoupon": "true",
"hasNewCombo": "false",
"hasSku": "true",
"newAddress": "true",
"newIndicator": "true",
"newPrice": "true",
"newTaobaoActivity": "true",
"noShareGroup": "true",
"openAddOnTools": "false",
"openGradient": "true",
"openNewSku": "true",
"promotion2018": "true",
"promotion2019": "true",
"showSku": "true",
"showSkuThumbnail": "true",
"superActTime": "false",
"taobao2018": "true"
},
"gallery": [],
"hybrid": {
"shopRecommendItems": {
"height": "445",
"spm": "",
"url": "https://market.m.taobao.com/apps/market/detailrax/recommend-shop-bigpage.html?spm=a2116h.app.0.0.16d957e9B7oLGw&wh_weex=true&sellerId=2596264565&itemId=520813250866&detail_v=3.1.1&selfRmdFlag=true"
}
},
"item": {
"couponUrl": "//h5.m.taobao.com/present/hongbao.html?sellerId=2596264565",
"picGallaryOverScroll": {
"mainPic": {
"action": [
{
"fields": {
"url": "https://market.m.taobao.com/app/detail-project/pages/pages/banner-recommend?wx_navbar_hidden=true&_wx_statusbar_hidden=true&wh_weex=true&sellerId=2596264565&shopId=127203758&itemId=520813250866&spm=a2141.7631564&detailAlgoParam=&list_param=&abtest=76992_63166&detailUniqueId=02288d69701058eca52532215b7fed17"
},
"type": "open_url"
},
{
"fields": {
"trackName": "Page_Detail_Button-ItemDetailRecommend",
"trackParams": {
"spm": "a2141.7631564"
}
},
"type": "user_track"
}
],
"text": "滑\n动\n查\n看\n更\n多\n宝\n贝"
}
},
"showShopActivitySize": "2",
"skuText": "请选择 颜色分类 ",
"titleIcon": "",
"vagueSellCount": "16"
},
"layout": {
"config": {
"dependActionConfigID": "TB1Llk4UwHqK1RjSZFEhA3GMXXa",
"dependComponentConfigID": "TB1pw4VcQ9E3KVjSZFGhA319XXa",
"dependThemeConfigID": "TB1MfiMsQyWBuNjy0FphA1ssXXa"
},
"detailTemplateData": {
"homePage": [
{
"ID": "navi_bar",
"id": "navi_bar",
"key": "navi_bar",
"ruleId": ""
},
{
"ID": "pic_gallery",
"id": "pic_gallery",
"key": "pic_gallery",
"ruleId": ""
},
{
"ID": "main_layout",
"children": [
{
"key": "uniform_price",
"ruleId": "TB_default"
},
{
"key": "dinamic",
"ruleId": "tb_detail_price_cheapie_shadow"
},
{
"key": "dinamic",
"ruleId": "tb_detail_price_ttsale_shadow"
},
{
"key": "dinamic",
"ruleId": "TB_jhs_main_Belt_shadow"
},
{
"key": "tip",
"ruleId": "TB_presaleTmall2"
},
{
"key": "tip",
"ruleId": "TB_priceTip2"
},
{
"key": "tip",
"ruleId": "TB_pricedCouponTip2"
},
{
"key": "tip",
"ruleId": "TB_shipTime2"
},
{
"key": "dinamic",
"ruleId": "TB_coupon_promotion2019"
},
{
"key": "dinamic",
"ruleId": "TB_detail_black_card_brand_info"
},
{
"key": "dinamic",
"ruleId": "TB_detail_brand_info"
},
{
"key": "dinamic",
"ruleId": "TB_detail_title_normal"
},
{
"key": "dinamic",
"ruleId": "TB_detail_title_tmallMarket"
},
{
"key": "dinamic",
"ruleId": "TB_detail_title_xinxuan"
},
{
"key": "dinamic",
"ruleId": "TB_detail_kernel_params"
},
{
"key": "dinamic",
"ruleId": "TB_detail_small_activity"
},
{
"key": "dinamic",
"ruleId": "TB_detail_subInfo_default"
},
{
"key": "dinamic",
"ruleId": "TB_detail_appointment_store3"
},
{
"key": "dinamic",
"ruleId": "TB_detail_appointment_store"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_detail_entrance_artascope"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_detail_pick"
},
{
"key": "dinamic",
"ruleId": "TB_detail_coupon"
},
{
"key": "dinamic",
"ruleId": "TB_detail_promotion"
},
{
"key": "dinamic",
"ruleId": "TB_detail_price_coupon"
},
{
"key": "dinamic",
"ruleId": "TB_detail_share"
},
{
"key": "dinamic",
"ruleId": "TB_jk_detail_coupon_share"
},
{
"key": "dinamic",
"ruleId": "TB_detail_tmallfeature"
},
{
"key": "dinamic",
"ruleId": "TB_detail_cuntao_pinchegou"
},
{
"key": "dinamic",
"ruleId": "TB_detail_creditbuy"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_msfx_tmall_banner"
},
{
"key": "dinamic",
"ruleId": "TB_detail_logistics"
},
{
"key": "dinamic",
"ruleId": "TB_detail_sub_logistics"
},
{
"key": "dinamic",
"ruleId": "TB_detail_tax"
},
{
"key": "dinamic",
"ruleId": "TB_detail_trade_guarantee"
},
{
"key": "dinamic",
"ruleId": "TB_detail_guarantee"
},
{
"key": "dinamic_o2o",
"ruleId": "TB_detail_o2o"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_detail_sku_cross_upgrade"
},
{
"key": "xsku",
"ruleId": "TB_Default"
},
{
"key": "dinamic",
"ruleId": "TB_detail_sku_transform"
},
{
"key": "dinamic",
"ruleId": "TB_detail_product_props"
},
{
"key": "vessel",
"ruleId": "TB_guess_u_like_promotion"
},
{
"key": "dinamic",
"ruleId": "TB_detail_miniapp_diliver"
},
{
"key": "dinamic",
"ruleId": "TB_detail_miniapp_rmd"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider_rateLocator"
},
{
"key": "dinamic",
"ruleId": "TB_detail_comment_empty"
},
{
"key": "dinamic",
"ruleId": "TB_detail_comment_head"
},
{
"key": "dinamic",
"ruleId": "TB_detail_comment_tag"
},
{
"key": "dinamic",
"ruleId": "TB_detail_comment_single_hot"
},
{
"key": "dinamic",
"ruleId": "TB_detail_buyer_photo"
},
{
"key": "dinamic",
"ruleId": "TB_detail_ask_all_no_question"
},
{
"key": "dinamic",
"ruleId": "TB_detail_ask_all_two_questions"
},
{
"key": "dinamic",
"ruleId": "TB_detail_ask_all_aliMedical"
},
{
"key": "dinamic",
"ruleId": "TB_detail_vipComment"
},
{
"key": "dinamic",
"ruleId": "TB_detail_medical_official_case_card"
},
{
"key": "vessel",
"ruleId": "TB_guess_u_like"
},
{
"key": "dinamic",
"ruleId": "TB_detail_divider"
},
{
"key": "dinamic",
"ruleId": "TB_detail_shop"
},
{
"key": "dinamic",
"ruleId": "TB_detail_endorsement"
},
{
"key": "dinamic_async",
"ruleId": "TB_tblive_detail"
},
{
"key": "vessel",
"ruleId": "TB_shop_recommend"
}
],
"id": "main_layout",
"key": "sys_list",
"ruleId": ""
},
{
"ID": "bottom_bar",
"id": "bottom_bar",
"key": "bottom_bar",
"ruleId": "TB_promo2019_get_voucher_buy"
}
]
},
"hierarchyData": {
"actions": {
"gotoDescRecommend": {
"event": "click",
"params": {
"locatorId": "divisionDescRecmd"
},
"type": "locator"
},
"gotoDetailDesc": {
"event": "click",
"params": {
"locatorId": "divisionDesc"
},
"type": "locator"
},
"gotoDetailInfo": {
"event": "click",
"params": {
"locatorId": "detailInfo"
},
"type": "locator"
},
"gotoDetailRate": {
"event": "click",
"params": {
"locatorId": "divisionRate"
},
"type": "locator"
},
"gotoPreviewPage": {
"type": "go_back"
},
"gotoUserTalk": {
"event": "click",
"params": {
"locatorId": "userSay"
},
"type": "locator"
},
"naviShowBigPic": {
"type": "show_big_pic"
},
"openPageCart": {
"params": {
"url": "https://h5.m.taobao.com/awp/base/cart.htm",
"urlParams": {
"cartfrom": "detail",
"itemId": "${item.itemId}"
}
},
"type": "open_url"
},
"openPageCartForInter": {
"params": {
"url": "https://pages.tmall.com/wow/trade/act/cart?wh_weex=true",
"urlParams": {
"cartfrom": "detail",
"itemId": "${item.itemId}"
}
},
"type": "open_url"
},
"openPageSearch": {
"params": {
"url": "https://s.m.tmall.com/m/searchbar.htm",
"urlParams": {
"cartfrom": "tmall_supermarket",
"tpId": "${vertical.supermarket.tpId}"
}
},
"type": "open_url"
},
"showMenu": {
"type": "show_menu"
},
"utClickDescRecommend": {
"event": "click",
"params": {
"trackName": "GotoShopRecommend",
"trackNamePre": "Button-"
},
"type": "user_track"
},
"utClickDetailDesc": {
"event": "click",
"params": {
"trackName": "GotoDetailDesc",
"trackNamePre": "Button-"
},
"type": "user_track"
},
"utClickDetailInfo": {
"event": "click",
"params": {
"trackName": "GotoDetailHome",