淘宝/天猫商品详情API接口调用说明书-参数返回值说明（含调用示例）

对于很多产品小白或求职者而言，API接口是一个产品和研发领域的专业术语，大家可能在文章或者PRD中都已经有接触过API接口的概念。

实际上，接口的应用已经非常广泛和成熟，这个概念主要活跃在公司内部的各系统之间的衔接和对接以及公司间合作的场景。如果你可以认真看完这篇文章，我相信你们对API接口的认识会更深入，甚至超过90%的小白和求职者。

API接口是什么？

我们来以一个常见的数学公式理解API，比如y=x 2，当x=2的时候，y=4，对么？

那此时，我们把y=x 2称为接口，x=2称为参数，y=4称为返回结果，那这个接口的功能就是能把我们输入的数加上2（注意：这里你可以发现接口自身是带有逻辑的）。

类比地，我们来理解一个常见的场景，比如现在有一个可以把经纬度转化为城市的接口，那当我输入经度是55°，纬度是88°的时候，接口通过自己的逻辑运算，返回结果告诉我：杭州市。

这样你就可以清晰地了解百度百科的官方解释了，接口就是预先定义的函数逻辑，他是供其他系统请求，然后返回结果的一个东西。

API接口的核心

对于小白而言，初看API文档可能是一头雾水的——从哪里看，怎么看，看什么是摆在面前的问题。

其实对于产品经理而言，我们应该更关注这个公司可以提供什么样的API接口服务，比如我知道高德可以提供地图API，规划路线的API，这样的话在我们设计功能和工作中就可以想到调用他们的服务或者参考。

所以产品小白们看不懂也不用过于担心，未来工作中你也会更深入了解清楚，因为看懂并不复杂，以下是API接口的核心点，所有的说明文档离不开这5个核心点。

以下说明均以获取淘宝商品详情数据API为例说明。好了，事不宜迟，现在我们来建立一个场景。

我们现在有一个APP，需要用户在购买的时候调起淘宝商品采集API，完成购买。请各位自动进入这个场景，把自己当作一位产品经理。

1. 接口地址 获取电商api调用地址

现在Now，用户点击商品，我们需要告诉淘宝，我们要调起你们的收银台啦！但，去哪里告诉呢？这就需要接口地址了，也就相当于向淘宝的这条链接传输指定的数据。

一个链接地址不是我们理解的一个页面，你可以理解是一个电话号码，小白们要改变这个观念。

此时我们可以看到接口文档告诉我们链接是如下这条，那我们现在已经拨通淘宝的电话了。

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

2. 请求参数（报文）

请求参数：num_iid=652874751412&is_promotion=1

参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

3. 请求示例 

 

4. 响应示例

 

5. 返回结果