开发电商平台就一定离不开接口,作为产品经理,我们要对接口不要求能实现调用。但要知道接口是什么,有什么用,有哪些要素。
什么是API吗?
API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。
实际开发中,当前端和后端有数据交互时,前端开发人员都会直接向后端询问接口,而不会问他具体的实现,比如APP上需要展现目前天气,那么前端开发直接接入一个天气查询接口就行。另外接口的开放可以帮助第三方应用轻松实现更多功能,如第三方登录、短信接口。第三方支付等等。
item_get-获得1688商品详情 查看演示] 注册KEY测试
1688.item_get
公共参数
请求地址: 申请调用KEY
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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 | 宝贝详情数据 |
API的几个要点:
1.接口地址:请求的网址。
2.请求方法:一般采用的是HTTP协议的POST和GET请求。
3.请求参数:你传过去是什么内容。
4.返回内容:就是你传参数过去之后得到返回的内容,返回内容的格式一般为json或xml格式。
5.错误代码:也是返回内容的一部分,当接口发生一些意外情况时,错误代码会告诉你原因。
我们通常说的http传输形式最基本的方法有4种,分别是GET,POST,PUT,DELETE。我们可以这样认为:一个URL地址,它用于描述一个网络上的资源,而HTTP中的GET,POST,PUT,DELETE就对应着对这个资源的查,改,增,删4个操作。
GET一般用于获取/查询资源信息,而POST一般用于更新资源信息。不过对资源的增,删,改,查操作,其实都可以通过GET/POST完成,不需要用到PUT和DELETE。
电商应用常用API主要分为内部接口和外部接口两个部分:
1.内部接口又分为平台调取后台数据的平台内部接口和toB为商家提供的商品增删改查接口。
a.基础资料上传接口
b.商品下架接口
c.商品资料变更接口
d.店铺基础信息上传接口
e.商品价格、库存同步接口
f.获取电商订单信息接口
g.调换货接口
h.退货接口
i.会员资料获取接口
2.外部接口主要是为用户在购物流程中提供短信验证、快速支付、物流查询等服务以达到最快交货速度、最安全资金支付、最轻松交易方式获得最高品质的用户体验目的。
a.第三方支付接口
b.短信接口
c.物流查询接口
d.权限接口
e.四网合一接口集合(第二代电子商务模式以业务为基础,将传统行业的核心业务与互联网技术完美融合起来,强调赢利模式和利润,将“信息流、资金流、商品流、物流”四流合一为全球企业和个人提供最快交货速度、最安全资金支付、最轻松交易方式获得最高品质的服务。)
f.合作换量接口