接口文档了解

接口文档定义---通俗版理解

举例，蓄水池与水泵。

如果把提供接口的一方，比作蓄水池，那么池子里装的就是一些封装好的数据啊函数之类之类。这时候如果蓄水池想把他的水，分享给其他人，他就需要在自己身上造个出水口，这个出水口就是所谓的接口。

这时候水泵出场了，水泵很需要这些水，他找来了一个水管用来把水抽出来，这时候水泵发送一个指令，蓄水池就会放出一点水。同样，今天你想要水，明天你想要果汁，都需要通过指令来命令蓄水池。这样的一去一回，就完成了一次对接口的交互。（来源微信一篇文章）

接口理解示意图

如何读接口文档?

一般接口包含以下几个内容：

接口地址

请求方法

请求参数

返回内容

错误代码