如何创建以API为中心的Web应用

如何创建以API为中心的Web应用，针对这个问题，这篇文章详细介绍了相对应的分析和解答，希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。

创新互联公司坚持“要么做到，要么别承诺”的工作理念，服务领域包括：成都网站设计、网站制作、企业官网、英文网站、手机端网站、网站推广等服务，满足客户于互联网时代的中阳网站设计、移动媒体设计的需求，帮助企业找到有效的互联网解决方案。努力成为您成熟可靠的网络建设合作伙伴！

正计划着要开始搞一个新的网络应用？在这篇教程中，我们将讨论如何创建以API为中心的网络应用，还会解释在今天的多平台世界，这类应用为什么是重要的。

引言

API？

对于还不甚熟悉这个术语的朋友，API是Application Programming Interface（应用编程接口）的简称。根据维基百科：

API可视化

图片蒙惠http://blog.zoho.com

简单地讲，API指的是一组应用中的函数，它们能够被其它应用（或者这些函数所属应用自己，下文中我们将会看到）用来与应用进行交互。API是一种很棒的向外部应用安全和妥善地表明其功能的方式，因为这些外部应用所能利用的所有功能仅限于API中所表现出的功能。

什么是“以API为中心的”网络应用？

以API为中心的网络应用就是基本上通过API调用执行大多数甚或所有功能的一类网络应用。举个例子，如果你正要登录一个用户，你应当将其认证信息发送给API，然后API会向你返回一个结果，说明该用户是否提供了正确的用户名-密码组合。

以API为中心的网络应用的另外一个特征就是API一直是无状态的，这意味着这种应用无法辨别由会话发起的API调用。由于API调用通常由后端代码构成，实现对会话的掌控将比较困难，因为这其中通常没有cookies介入。这种局限事实上是好事——它“迫使”开发者建造不基于当前用户状态工作的 API，但是相应地在功能上，它使测试易于进行，因为用户的当前状态无需被重建。

为什么要经历这些麻烦？

作为Web开发者，我们已经亲眼目睹了技术的进步。有一个常识是，当代的人们不会只通过浏览器来使用应用，还会通过其它诸如移动电话和平板电脑之类的设备使用。举个例子，这篇发表在Mashable上的名为“用户在移动应用上花的时间比在网络上的多”的写道：

这里还有一篇来自ReadWriteWeb的更新的文章“在移动设备上浏览网络的人多于使用IE6和IE7的人数总和”：

正如我们所见，越来越多的人正通过其它途径获得讯息，特别是移动设备。

这与我创建以API为中心的网络应用有何关系？

创建以API为中心的网络应用的主要优势之一便是它帮助你建立可以用于任何设备的功能，浏览器、移动电话、甚至是桌面应用。你所需要做的就是创建的API 能够使所有这些设备利用它完成通信，然后，瞧！你将能够建造一个集中式应用，它能够接受来自用户所使用的任何设备的输入并执行相应的功能。

以API为中心的应用的框图

通过以这种方式创建应用，我们能够从容地利用不同的人使用不同的媒介这一优势。这必将使应用更加有用，因为它能用在用户需要的任何地方。

为了证明我们的观点，这里有一篇关于Twitter的重新设计的网站的文章，文章告诉我们他们现在如何利用他们的API来驱动Twitter.com的，实质上是使其以API为中心：

在本篇教程中，我们将创建一个简单的TODO列表应用，该应用以API为中心；还要创建一个浏览器上的前端客户端，该客户端与我们的TODO列表应用进行交互。文末，你就能了解一个以API为中心的应用的有机组成部分，同时，还能了解怎样使应用和客户端两者之间的安全通信变得容易。记住这些，我们开始吧！

步骤 1: 规划该应用的功能

本教程中我们将要构建的这个 TODO 应用将会有下面几个基本的CRUD功能:

• 创建 TODO 条目

• 读取 TODO 条目

• 更新 TODO 条目 (重命名，标记为完成，标记为未完成)

• 删除 TODO 条目

每一个 TODO 条目将拥有:

• 一个标题 Title

• 一个截止日期 Date Due

• 一个描述 Description

• 一个判断 TODO 条目是否完成的标志 Is Done

让我们模拟一下该应用，使我们考虑该应用以后会是什么样子时，能有有一个直观的参考:

 
简单的TODO 模拟示例

步骤 2: 创建API服务器

既然我们是在开发一个以API为中心的应用，我们将创建两个“项目”: API 服务器，和前端客户端。 我们首先从创建API服务器开始。

在你的web server文件夹，创建一个文件夹，命名为simpletodo_api，然后创建一个index.php文件。这个index.php文件将作为一个访问API的前端控制器，所以，所有访问API服务器的请求都会由该文件产生。打开它并往里输入下列代码:

$action();      $result['success'] = true;        } catch( Exception $e ) {      //捕获任何一次样并且报告问题      $result = array();      $result['success'] = false;      $result['errormsg'] = $e->getMessage();  }   //回显调用API的结果  echo json_encode($result);  exit();

实质上，这里我们创建的是一个简单的前端控制器，它实现了下列功能:

• 接受一次拥有任意个参数的API调用

• 为本次API调用抽取出Controller和Action

• 进行必要的检查确保Controller和Action都存在

• 执行API调用

• 捕获异常，如果有的话

• 返回一个结果给调用者

除了需要创建index.php外你还需要创建三个文件夹:  controllers, models和  data.

• controllers 文件夹存放的是所有我们API服务器将会用到的的控制器。我们用MVC架构来使API服务器结构更清楚合理。

• models 文件夹存放所有API服务器要用到的数据模型。

• data 文件夹将会用来保存API服务器的任何数据。

在controllers文件夹下创建一个叫Todo.php的文件。这将是任何TODO列表有关任务的控制器。按照TODO应用所需提供的功能，向Todo控制器里面添加必要的方法：

_params = $params;      }            public function createAction()      {          //create a new todo item      }            public function readAction()      {          //read all the todo items      }            public function updateAction()      {          //update a todo item      }            public function deleteAction()      {          //delete a todo item      }  }

现在为每个action中添加必要的功能实现。我将会提供createAction()方法的源码，其他方法将留作作业。如果你觉得毫无头绪，你也可以下载示例的源码，从那里拷贝。

public function createAction()  {      //create a new todo item      $todo = new TodoItem();      $todo->title = $this->_params['title'];      $todo->description = $this->_params['description'];      $todo->due_date = $this->_params['due_date'];      $todo->is_done = 'false';            //pass the user's username and password to authenticate the user      $todo->save($this->_params['username'], $this->_params['userpass']);            //return the todo item in array format      return $todo->toArray();  }

在文件夹models下创建TodoItem.php，这样我们就可以创建“条目添加”的代码了。注意：我并没有和数据库进行连接，相反我将信息保存到文件中，虽然这可以用任何数据库来实现,但是 这样做相对来说要容易些。

todo_id) || !is_numeric($this->todo_id) ) {              //the todo id is the current time              $this->todo_id = time();          }                    //get the array version of this todo item          $todo_item_array = $this->toArray();                    //save the serialized array version into a file          $success = file_put_contents(DATA_PATH."/{$userhash}/{$this->todo_id}.txt", serialize($todo_item_array));                    //if saving was not successful, throw an exception          if( $success === false ) {              throw new Exception('Failed to save todo item');          }                    //return the array version          return $todo_item_array;      }            public function toArray()      {          //return an array version of the todo item          return array(              'todo_id' => $this->todo_id,              'title' => $this->title,              'description' => $this->description,              'due_date' => $this->due_date,              'is_done' => $this->is_done          );      }  }

createAction方法使用到TodoItem模型里面两个方法：

• save()– 该方法将TodoItem保存到一个文件中，如有必要，需要设置todo_id。

• toArray()– 该方法返回一个以变量为索引的数组Todo条目。

由于API需要通过HTTP请求调用，在浏览器输入如下地址测试API：

http://localhost/simpletodo_api/?controller=todo&action=create&title=test%20title&description=test%20description&due_date=12/08/2011&username=nikko&userpass=test1234

如果没有错，你应该在data文件夹下看到一个新的文件夹，在该文件夹里面有一个文件，文件内容如下：

 

createAction()结果

恭喜！您已经成功创建了一个的API服务器和API调用！

步骤3：确保API服务器具有APP ID和APP SECRET

目前，API服务器被设置为接受全部API请求。我们将需要将之限制在我们自己的应用上，以确保只有我们自己的前端客户端能够完成API请求。另外，你实际上也可以创建一个系统，其中的用户可以创建他们自己的应用，而那些应用也用用对你的API服务器的访问权，这与Facebook和Twitter的应用的的工作原理类似。

我们从为使用API服务器的用户创建一组id-密码对开始。由于这只是一个Demo，我们可以使用任何随机的、32位字符串。对于APP ID，我们将其设定为APP001。

再次打开index.php文件，然后用下列代码更新之：

 '28e336ac6c9423d946ba02d19c6a2632', //randomly generated app key   );  //include our models  include_once 'models/TodoItem.php';   //wrap the whole thing in a try-catch block to catch any wayward exceptions!  try {      //*UPDATED*      //get the encrypted request      $enc_request = $_REQUEST['enc_request'];            //get the provided app id      $app_id = $_REQUEST['app_id'];            //check first if the app id exists in the list of applications      if( !isset($applications[$app_id]) ) {          throw new Exception('Application does not exist!');      }            //decrypt the request      $params = json_decode(trim(mcrypt_decrypt(MCRYPT_RIJNDAEL_256, $applications[$app_id], base64_decode($enc_request), MCRYPT_MODE_ECB)));            //check if the request is valid by checking if it's an array and looking for the controller and action      if( $params == false || isset($params->controller) == false || isset($params->action) == false ) {          throw new Exception('Request is not valid');      }            //cast it into an array      $params = (array) $params;      ...      ...      ...

我们在这里已经完成的实际上是实现一个非常简单的认证我们的前端客户端的方法，它利用了与公共-私有密钥认证相似的系统。基本上，这里给出的就是认证过程的步骤分解：

 
公钥加密

• 完成一个API调用，其中提供了$app_id和$enc_request

• $enc_request的值是API调用的参数，利用APP KEY进行加密。APP KEY绝对不会被发送到服务器，它只是被用来散列请求。此外，该请求只能利用APP KEY被解密

• 一旦API调用到达API服务器，它会查验它自己的应用列表是否与APP ID所提供的一致

• 当调用被发现，API服务器尝试利用与APP ID发送的密钥相匹配的密钥进行解密

• 如果请求被解密成功，那么继续执行程序

既然API服务器已经确保具有APP ID和APP SECRET，那么我们就可以开始编写使用API服务器的前端客户端了。

步骤4：创建浏览器客户端

我们从为前端客户端设定新建文件夹开始。在你的Web服务器上的文件夹中创建一个名为simpletodo_client_browser的文件夹。完成后，创建一个index.php文件，并将下列代码写进去：

                                                                                                SimpleTODO