为了进行此平台API的调用,首先我们需要做下面几件事情。
1、 获取一个KEY。
2、 参考API文档里的接入方式和示例。
3、查看测试工具是否有需要的接口,响应实例的返回字段是否符合参数要求。
4、利用平台的文档中心和API测试工具,对接口进行测试、程序获取。
更多API调用展示以及获取Key和secret请移步
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
- 请求参数:seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=
-
- 参数说明:seller_nick:店铺昵称或sid(目前只支持sid))
- sort:排序[bid,_bid,_sale,_credit]
- (bid:总价(升序)_bid:总价(降序),sale:销量,默认综合排序,time:新品)
- sort=new为店铺上新数据,格式不统一,请注意
- page:页数
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | items[] | 0 | 店铺的所有商品 | |
num_iid | Bigint | 0 | 628675986215 | 宝贝ID |
title | String | 0 | 圆形服装店吊牌定做女装衣服吊卡订制800g加厚烘培礼品花卉卡片 | 商品标题 |
pic_url | String | 0 | https://cbu01.alicdn.com/img/ibank/2020/386/208/22202802683_1873238575.search.jpg | 宝贝图片 |
price | Float | 0 | 138.00 | 价格 |
detail_url | String | 0 | https://detail.1688.com/offer/628675986215.html | 商品链接 |
响应参数
- {
- "user": {
- "id": null,
- "nick": null,
- "good_num": null,
- "level": null,
- "created": null,
- "shop_type": null,
- "user_num_id": null,
- "company_id": null,
- "company_dj": null,
- "company_time": null,
- "company_info": null,
- "cid": "-1",
- "sid": null,
- "pic_url": null,
- "video": null,
- "title": null,
- "address": null,
- "phone": null,
- "zhuy": "./page/contactinfo.htm",
- "fh_score": null,
- "hm_score": null,
- "xy_score": null,
- "ht_score": null,
- "menu": null
- },
- "items": {
- "item": [
- {
- "num_iid": "629206406356",
- "title": "天语欧博信米图手机X27S Mate30 P40 Pro个性简约时尚手机壳批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/782/417/21694714287_2101792098.jpg",
- "price": "19.9",
- "detail_url": "https://m.1688.com/offer/629206406356.html"
- },
- {
- "num_iid": "606991177049",
- "title": "大容量10000毫安全新爆款移动电源自带线充电宝礼品厂家直销",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/517/800/12487008715_2101792098.jpg",
- "price": "39.9",
- "detail_url": "https://m.1688.com/offer/606991177049.html"
- },
- {
- "num_iid": "603067013582",
- "title": "P3跨境新爆款现货6.5寸水滴大屏全网通4G智能手机海外代发OEM定制",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/492/814/12111418294_2101792098.jpg",
- "price": "52.0",
- "detail_url": "https://m.1688.com/offer/603067013582.html"
- },
- {
- "num_iid": "613515982791",
- "title": "5.8寸大屏工作室root纯净版2+16G云群控抖音快手微信手机OEM批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/270/438/13682834072_2101792098.jpg",
- "price": "66.0",
- "detail_url": "https://m.1688.com/offer/613515982791.html"
- },
- {
- "num_iid": "637339319017",
- "title": "P40 Pro品牌爆款6.5寸水滴大屏8+256G全网通5G安卓智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/278/368/16085863872_2101792098.jpg",
- "price": "298.0",
- "detail_url": "https://m.1688.com/offer/637339319017.html"
- },
- {
- "num_iid": "632168014097",
- "title": "新款30pro 7.5寸水滴大屏8+256G全网通5G低价智能手机正品代批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/048/299/12073992840_2101792098.jpg",
- "price": "298.0",
- "detail_url": "https://m.1688.com/offer/632168014097.html"
- },
- {
- "num_iid": "624579363633",
- "title": "mate30 pro新款6.5英寸水滴大屏8+256G全网通5G低价智能手机批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/285/407/17053704582_2101792098.jpg",
- "price": "298.0",
- "detail_url": "https://m.1688.com/offer/624579363633.html"
- },
- {
- "num_iid": "624015201074",
- "title": "新款X27 6.5寸全面水滴大屏8+128G全网通5G安卓智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/469/649/11428946964_2101792098.jpg",
- "price": "298.0",
- "detail_url": "https://m.1688.com/offer/624015201074.html"
- },
- {
- "num_iid": "634673693747",
- "title": "真新款mate40 pro 7.2寸水滴大屏8+256G全网通5G低价智能手机批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vYUdfL1ZrAfnyJVZy_!!6000000003247-0-cib.jpg",
- "price": "299.0",
- "detail_url": "https://m.1688.com/offer/634673693747.html"
- },
- {
- "num_iid": "634599513272",
- "title": "新款mate40 pro 7.2寸水滴大屏10+256G全网通5G低价智能手机批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01hXorlV24Cdi8vAod4_!!6000000007355-0-cib.jpg",
- "price": "299.0",
- "detail_url": "https://m.1688.com/offer/634599513272.html"
- },
- {
- "num_iid": "589766232746",
- "title": "新款X27 6.5寸全面水滴大屏8+128G全网通5G安卓智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/976/670/13387076679_2101792098.jpg",
- "price": "308.0",
- "detail_url": "https://m.1688.com/offer/589766232746.html"
- },
- {
- "num_iid": "636684457600",
- "title": "爆款hviv mate30 pro6.8寸水滴大屏256G全网通低价智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/610/814/19520418016_2101792098.jpg",
- "price": "398.0",
- "detail_url": "https://m.1688.com/offer/636684457600.html"
- },
- {
- "num_iid": "622583886323",
- "title": "爆款Hviv Mate40Pro+6.8寸水滴大屏512G全网通低价智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01O9vUUY285Y3UOWbWL_!!2200733087881-0-cib.jpg",
- "price": "399.0",
- "detail_url": "https://m.1688.com/offer/622583886323.html"
- },
- {
- "num_iid": "589984649469",
- "title": "6.5寸大屏安卓9.0工作室root纯净版4+64G云群控抖音快手阅读手机",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/242/368/10339863242_902098348.jpg",
- "price": "469.0",
- "detail_url": "https://m.1688.com/offer/589984649469.html"
- },
- {
- "num_iid": "617854475887",
- "title": "电视话购物工作室root纯净版4+64G云群控抖音快手微信手机OEM批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2019/382/361/12287163283_2101792098.jpg",
- "price": "698.0",
- "detail_url": "https://m.1688.com/offer/617854475887.html"
- },
- {
- "num_iid": "624494524174",
- "title": "爆款hviv mate30 pro6.8寸水滴大屏256G全网通低价智能手机批代发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/876/517/19593715678_2101792098.jpg",
- "price": "998.0",
- "detail_url": "https://m.1688.com/offer/624494524174.html"
- },
- {
- "num_iid": "630981381989",
- "title": "品牌P40 Pro+7.5寸水滴大屏10+256G全网通低价智能手机正品代批发",
- "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/062/412/20219214260_2101792098.jpg",
- "price": "1199.0",
- "detail_url": "https://m.1688.com/offer/630981381989.html"
- }
- ],
- "total_results": "17",
- "page_size": 20,
- "pagecount": 1,
- "page": "1",
- "url": null
- },
- "error": "",
- "secache": "3bbcb618f225b45561bbb1686d15b91c",
- "secache_time": 1615280560,
- "secache_date": "2021-03-09 17:02:40",
- "translate_status": "",
- "translate_time": 0,
- "language": {
- "default_lang": "cn",
- "current_lang": "cn"
- },
- "reason": "",
- "error_code": "0000",
- "cache": 0,
- "api_info": "today:8 max:10000",
- "execution_time": 7.492,
- "server_time": "Beijing/2021-03-09 17:02:40",
- "client_ip": "106.6.35.144",
- "call_args": {
- "nick": "b2b-2200733087881719de"
- },
- "api_type": "1688",
- "translate_language": "zh-CN",
- "translate_engine": "google_cn",
- "server_memory": "3.56MB",
- "request_id": "gw-4.604739a9443f6"
- }