简述应用程序接口(API)

来源：互联网发布：淘宝卖家利润编辑：程序博客网时间：2024/04/27 23:21

写下这个文章的原因是,我发现身边一些的朋友可能是因为之前没有接触过API,以至于对API有些不解和抵触.
因为微信开发/地图定位/各种大数据的信息查询,让接口(api)成为了一个非常常用的工具.这篇文章是我自己的一些理解,由于本人也是个小白,肯定有很多地方不到位,希望能指出.首先,我们从API是什么开始说.

1.API是什么?

维基百科的解释是:
应用程序接口 (Application Programming Interface 简称:API)为：“‘电脑操作系统（Operating system）’或‘程序库’提供给应用程序调用使用的代码”。其主要目的是让应用程序开发人员得以调用一组例程功能，而无须考虑其底层的源代码为何、或理解其内部工作机制的细节。API本身是抽象的，它仅定义了一个接口，而不涉及应用程序在实际实现过程中的具体操作。

简而言之接口就是一个抽象的,不需要考虑内部细节的东西.你拿来用就可以了.这么讲可能抽象了一些,我们举个例子:
以百度地图IP定位的API为例:
服务地址:
http://api.map.baidu.com/location/ip

接口参数:

百度地图接口参数

返回结果:

文／linfree（简书作者）
原文链接：http://www.jianshu.com/p/9cbc8094e782

著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

{   address: "CN|北京|北京|None|CHINANET|1|None", #地址    content: #详细内容        { address: "北京市", #简要地址          address_detail: #详细地址信息             { city: "北京市", #城市             city_code: 131, #百度城市代码             district: "", #区县             province: "北京市", #省份             street: "", #街道             street_number: "" #门址             }, point: #百度经纬度坐标值             { x: "116.39564504", y: "39.92998578"             }       },     status: 0 #返回状态码 }

那么,服务地址/接口参数/返回结果分别是什么意思呢?
我们一一来理解:
服务地址: 即我们需要数据请求的页面地址.

请求参数 有的时候我们不只从接口上取值,我们还需要用一种特殊的方式告诉服务器,我们需要什么数据,你给我们需要的就可以了,别瞎给.这种方式通常是URL传参的形式.比如百度的这个api就可以这样传.
http://api.map.baidu.com/location/ip?ak=E4805d16520de693a3fe707cdc962045&ip=202.198.16.3&coor=bd09ll
通过url,我们告诉百度,我们的ak(access key)是:E48....62045,我们要定位的ip是:202.198.16.3,coor是:bd09ll(告诉百度我们需要经纬坐标).
这就是一中最最常用的使用API的方式.

返回结果 上面我们通过URL传参的方式告诉了百度服务器,我们需要的是IP为202.198.16.3的位置信息,而且需要经纬坐标值(coor=bd09ll),并且我们的Ak值是对的,这时候,百度就会输出一个结果在页面里,通常是JSON字符串的形式.如:

文／linfree（简书作者）
原文链接：http://www.jianshu.com/p/9cbc8094e782
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

{   address: "CN|吉林|长春|None|CERNET|1|None",   content: {     address: "吉林省长春市",     address_detail: {       city: "长春市",       city_code: 53,       district: "",       province: "吉林省",       street: "",       street_number: ""     },     point: {       x: "125.31364243", y: "43.89833761"     }   }, status: 0 }

我们可以通过读取url页面的形式来获取返回的json字符串.再应用到我们的项目中.
上述就是一个最简单的API使用,也是最本质/常用的一种.(传值和取值)

从上面的例子中,我们就可以知道,为什么API不需要考虑程序的内部细节了吧?其实它就好像一个封装好的电池,我们放到卡槽里用就行了,不需要去了解内部结构.
对于大型的API内部封装的算法是非常复杂的.但它的原理并不难,我们自己就可以尝试着写上一个小小的API.这里我给个例子:

文／linfree（简书作者）
原文链接：http://www.jianshu.com/p/9cbc8094e782
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

<?php#假设存为index.php到根目录header ('content-type:text/html;charset=utf-8');$con = mysql_connect("localhost","root","root");if (!$con)  {  die('Could not connect: ' . mysql_error());  }mysql_select_db('chaxun',$con);    $token=isset($_GET['token'])?$_GET['token']:"1";if ($token==123) {    $sql="SELECT * FROM data;";    $result = mysql_query($sql);    while($row = mysql_fetch_array($result, MYSQL_ASSOC)){    $rst[]=$row;    }    $rst_json = json_encode($rst);    echo $rst_json;}else{    echo "token错误!";}mysql_close();?>

上面的例子,
我们API服务地址就是:http://localhost/index.php
接口参数我们需要传一个token=123
返回结果就是一个查询数据库的结果,转换的json字符串.
完整的url拼起来就是:http://localhost/index.php?token=123
看吧,其实写个接口就这么简单.

文／linfree（简书作者）
原文链接：http://www.jianshu.com/p/9cbc8094e782
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。

/******************** 问答 *********************/

我想问问在 HTML 中使用ajax方法URL是/a 用PHP 是不是地址是 a.PHP 传参后面要？号，还有PHP如何获得参数

喜欢(0)回复