产品经理必须懂的api接口文档，淘宝京东1688api接口系列

很多产品经理刚接触 API 接口工作时，脑子一片空白，不理解接口（API）是什么，更看不懂接口开发文档。那么，作为一个不懂技术的产品经理，该如何看懂接口文档。今天这篇文章就跟大家好好巴拉巴拉。

什么是API接口

在项目开发汇总，web项目的前后端是分离开发的。应用程序的开发，需要由前后端工程师共同定义接口，编写接口文档，之后大家都根据这个接口文档进行开发，到项目结束前都要一直维护。

为什么有API接口文档

1）项目开发过程中前后端工程师有一个统一的文件进行沟通交流开发

2）项目维护中或者项目人员更迭的时候，方便后期人员查看、维护

怎么看懂API文档

API 接口文档一般分为接口描述、接口地址、请求方法、请求参数、相应内容、错误代码、实例几个部分。

1、接口描述：简单描述接口的逻辑和作用

2、接口地址：接口的正式 url 和接口测试的 url，需求方通过调用接口 url，获取响应内容

3、请求方法：一般来说，接口最常见的请求方法为 GET 和 POST 两种方式，即读接口和写接口。通过这两种方式，实现对数据的增删查改。增删改本质都是写的动作。

4、请求参数：即需要请求的字段名的名称和规则：都是哪些字段，字段的类型是什么，是否必填字段等等

5、响应内容：接口返回的字段名称和规则。注意：大部分开发往往不会把所有的字段罗列，只会列出比较重要的字段。当你发现，接口文档中没有你需求的字段，别着急找开发，可以看下实例中，有没有需求的字段。

6、错误代码：对接口的错误用代码进行归类，以便能快速找到错误原因，解决问题。

7、实例实际：调用时的响应的内容。
淘宝京东1688api接口系列：

taobao.item_get

公共参数

请求地址:https://o0b.cn/anzexi

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）获取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=652874751412&is_promotion=1

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

请求示例

响应示例