为什么要用api接口，此处用1688商品详情接口举例前言随着电商的蓬勃发展，现在已经进入了全民电商的时代；从国内电商到

1688以批发和采购业务为核心，通过专业化运营，完善客户体验，全面优化企业电子商务的业务模式。1688已覆盖原材料、工业品、服装服饰、家居百货、小商品等16个行业大类，提供从原料采购--生产加工--现货批发等一系列的供应服务。 2018年4月12日，阿里巴巴1688在广州举办峰会，上线一周年的阿里1688跨境专供市场平台，首次对外披露了成绩单：截至3月底，近五十万中小企业通过1688跨境平台，为速卖通、亚马逊、Wish、eBay、lazada等平台提供服务，遍布全球220个国家和地区；一年时间内，跨境专供市场的交易规模和买家增长超过4倍。

前言

随着电商的蓬勃发展，现在已经进入了全民电商的时代；从国内电商到跨境电商，可以说是百家争艳，同时，电商运营也变得更精细化，各种运营工具也相继涌现，为店铺业绩做保障，电商API就是这样一个工具。

一、api是什么？

API接口：应用程序接口（API：Application Program Interface），是一组定义、程序及协议的集合，通过 API 接口实现计算机软件之间的相互通信。

二、使用步骤

1.1688已知接口展示如下：

1688.readme接入文档 item_get获得1688商品详情 item_search按关键字搜索商品 item_search_img按图搜索1688商品（拍立淘） item_search_suggest获得搜索词推荐 item_fee获得商品快递费用 seller_info获得店铺详情 item_search_shop获得店铺的所有商品 item_password获得淘口令真实url upload_img上传图片到1688 item_search_seller搜索店铺列表 img2text图片识别商品接口 item_get_app获取1688app上原数据 cat_get获得1688商品分类 item_cat_get获得1688商品类目 item_review获得1688商品评论 item_search_factory按关键字搜索工厂数据 item_search_new按关键字搜索新品数据

2.演示item_get获得1688商品详情具体操作

代码如下：

-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "api-gw.onebound.cn/1688/item_g…<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"

响应示例

{ "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": "detail.1688.com/offer/61094…", "pic_url": "cbu01.alicdn.com/img/ibank/2…", "brand": "", "brandId": "", "rootCatId": "", "cid": "50903", "desc": "<div id="offer-template-0">

深圳市多亲科技有限公司（简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发，在人工智能终端设备、系统软件的研发和生产领域，具有深厚的技术沉淀与实力。

多亲产品销售网络覆盖全国各地乃至远销海外，欢迎企业定制、团购、经销代理。

优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。

欢迎有意向者实地考察，垂询电话：13662284449.

温馨提示：

1、可定制--承接各种订单订制！为客户定制机身、开机画面、预装软件、包装等定制！
2、质量保证--本公司专注通讯行业10年，线下线下百花齐放，客户复购率达30%以上。
3、价格实惠--本店是工厂直供，没有中间商差价，一站到客，薄利多销。
4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货（非人为因素）30天内换新。

", "item_imgs": [ { "url": "cbu01.alicdn.com/img/ibank/2…" }, { "url": "cbu01.alicdn.com/img/ibank/2…" }, { "url": "cbu01.alicdn.com/img/ibank/2…" }, { "url": "cbu01.alicdn.com/img/ibank/2…" }, { "url": "cbu01.alicdn.com/img/ibank/2…" } ], "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": "winport.m.1688.com/page/index.…", "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": [ "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…", "cbu01.alicdn.com/img/ibank/2…" ], "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" }

异常示例

{ "error": "item-not-found", "reason": "商品没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "1688", "request_id": "15ee0ffc041242" }

相关资料

错误码解释

状态代码(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 未知错误否演示图片展示

公共参数

前往注册测试

名称类型必须描述 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=610947572360

参数说明：num_iid:1688商品ID sales_data:&sales_data=1 获取近30天成交数据 agent:&agent=1 获取1688分销代发价格数据

响应参数

Version: Date:

名称类型必须示例值描述 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 detail.1688.com/offer/61094… 宝贝链接 pic_url

String 0 cbu01.alicdn.com/img/ibank/2… 宝贝图片 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 [{"cbu01.alicdn.com/img/ibank/2…"}] 详情图片列表 shop_item

Mix 0 relate_items

Mix 0 总结： 1、API可以将多个平台的数据和功能相互集成。例如，您可以将您的电商网站/平台与物流运输服务供应商的账户集成，并导入订单和运输数据。这样，你就只需在一个平台上进行快递运输操作。

2、API可以快速获取电商平台商品信息，如淘宝、天猫、1688、京东、亚马逊等平台商品，再通过API接口，可实现一键铺货，节省大量上传商品的时间，把时间花在更有价值的事情上。

3、电商订单仓储管理API可以通过集成API进行诸如订单履行、快递管理、标签管理、发票管理、订单打印、货运信息、物流跟踪和签收通知等等的功能来帮助企业实现订单管理、发货管理和运输管理的自动化，简化其物流仓储运营，从而实现成本降低。

感兴趣的小伙伴们可以试试：登录 - 跨境电商平台接口提供商数据采集公司数据接口定制服务企业级数据服务商