建立以 API 为中心的 Web 应用

http://www.oschina.net/translate/creating-an-api-centric-web-application?from=20130818

 

正计划着要开始搞一个新的网络应用？在这篇教程中，咱们将讨论如何建立以API为中心的网络应用，还会解释在今天的多平台世界，这类应用为何是重要的。 引言 API？ 对于还不甚熟悉这个术语的朋友，API是Application Programming Interface（应用编程接口）的简称。根据维基百科： API是以源代码为基础的约定，它用于软件组件之间相互通讯的接口。API可能包含函数、数据结构、对象类、以及变量等的约定。 API可视化 图片蒙惠http://blog.zoho.com 简单地讲，API指的是一组应用中的函数，它们可以被其它应用（或者这些函数所属应用本身，下文中咱们将会看到）用来与应用进行交互。API是一种很棒的向外部应用安全和妥善地代表其功能的方式，由于这些外部应用所能利用的全部功能仅限于API中所表现出的功能。

stoneyang 翻译于 8个月前 8人顶   顶 翻译的不错哦!

什么是“以API为中心的”网络应用？ 以API为中心的网络应用就是基本上经过API调用执行大多数甚或全部功能的一类网络应用。 以API为中心的网络应用就是基本上经过API调用执行大多数甚或全部功能的一类网络应用。举个例子，若是你正要登陆一个用户，你应当将其认证信息发送给API，而后API会向你返回一个结果，说明该用户是否提供了正确的用户名-密码组合。 以API为中心的网络应用的另一个特征就是API一直是无状态的，这意味着这种应用没法辨别由会话发起的API调用。因为API调用一般由后端代码构成，实现对会话的掌控将比较困难，由于这其中一般没有cookies介入。这种局限事实上是好事——它“迫使”开发者建造不基于当前用户状态工做的API，可是相应地在功能上，它使测试易于进行，由于用户的当前状态无需被重建。

stoneyang 翻译于 8个月前 5人顶   顶 翻译的不错哦!

为何要经历这些麻烦？ 做为Web开发者，咱们已经亲眼目击了技术的进步。有一个常识是，当代的人们不会只经过浏览器来使用应用，还会经过其它诸如移动电话和平板电脑之类的设备使用。举个例子，这篇发表在Mashable上的名为“用户在移动应用上花的时间比在网络上的多”的写道： 一项新近的报告代表，用户花在移动应用上的时间首次超过了花在网络上的时间。  Flurry对比了其移动数据与来自comScore和Alexa的统计数据，发如今六月，用户天天花费81分钟使用移动应用，而只花74分钟用于网上冲浪。   这里还有一篇来自ReadWriteWeb的更新的文章“在移动设备上浏览网络的人多于使用IE6和IE7的人数总和”： 来自Sitepoint的  浏览器趋势的最新数据代表，在智能手机上浏览Web的人比使用IE6和IE7浏览的人更多。这两件难有转机的老古董多年来一直是Web开发者的噩梦，它们须要各网站尽量稳当地降格到至少经常使用浏览器所能支持的水平。可是如今时代不一样了；2011年十一月中，6.95%的Web活动在移动浏览器上发生，而发生在IE6或IE7上的则只有6.49%。 正如咱们所见，愈来愈多的人正经过其它途径得到讯息，特别是移动设备。

stoneyang 翻译于 8个月前 2人顶   顶 翻译的不错哦!

这与我建立以API为中心的网络应用有何关系？ 这必将会使咱们的应用更加有用，由于它能够用在任何你须要的地方。 建立以API为中心的网络应用的主要优点之一即是它帮助你创建能够用于任何设备的功能，浏览器、移动电话、甚至是桌面应用。你所须要作的就是建立的API可以使全部这些设备利用它完成通讯，而后，瞧！你将可以建造一个集中式应用，它可以接受来自用户所使用的任何设备的输入并执行相应的功能。 以API为中心的应用的框图

stoneyang 翻译于 8个月前 2人顶   顶 翻译的不错哦!

经过以这种方式建立应用，咱们可以从容地利用不一样的人使用不一样的媒介这一优点。这必将使应用更加有用，由于它能用在用户须要的任何地方。 为了证实咱们的观点，这里有一篇关于Twitter的从新设计的网站的文章，文章告诉咱们他们如今如何利用他们的API来驱动Twitter.com的，实质上是使其以API为中心： 最重要的架构改动之一就是Twitter.com如今是咱们本身API的客户。它从终端提取数据，此终端与移动网站，咱们为iPhone、iPad、Android，以及全部第三方应用所用端点相同。这一转变使咱们能向API团队分配更多的资源，同时生成了40多个补丁。在初始页面负载和来自客户端的每一个调用上，全部的数据如今都是从一个高度优化的JSON段缓存中获取的。 在本篇教程中，咱们将建立一个简单的TODO列表应用，该应用以API为中心；还要建立一个浏览器上的前端客户端，该客户端与咱们的TODO列表应用进行交互。文末，你就能了解一个以API为中心的应用的有机组成部分，同时，还能了解怎样使应用和客户端二者之间的安全通讯变得容易。记住这些，咱们开始吧！

stoneyang 翻译于 8个月前 3人顶   顶 翻译的不错哦!

步骤 1: 规划该应用的功能 本教程中咱们将要构建的这个 TODO 应用将会有下面几个基本的CRUD功能: 建立 TODO 条目 读取 TODO 条目 更新 TODO 条目 (重命名，标记为完成，标记为未完成) 删除 TODO 条目 每个 TODO 条目将拥有: 一个标题 Title 一个截止日期 Date Due 一个描述 Description 一个判断 TODO 条目是否完成的标志 Is Done 让咱们模拟一下该应用，使咱们考虑该应用之后会是什么样子时，能有有一个直观的参考:   简单的TODO 模拟示例

lwei 翻译于 8个月前 4人顶   顶 翻译的不错哦!

步骤 2: 建立API服务器 既然咱们是在开发一个以API为中心的应用，咱们将建立两个“项目”: API 服务器，和前端客户端。 咱们首先从建立API服务器开始。 在你的web server文件夹，建立一个文件夹，命名为simpletodo_api，而后建立一个index.php文件。这个index.php文件将做为一个访问API的前端控制器，因此，全部访问API服务器的请求都会由该文件产生。打开它并往里输入下列代码: 01 <?php 02 // 定义数据目录的路径 03 define('DATA_PATH', realpath(dirname(__FILE__).'/data')); 04   05 //引入咱们的models 06 include_once 'models/TodoItem.php'; 07   08 //在一个try-catch块中包含全部代码，来捕获全部可能的异常! 09 try { 10     //得到在POST/GET request中的全部参数 11     $params = $_REQUEST; 12       13     //获取controller并把它正确的格式化使得第一个字母老是大写的 14     $controller = ucfirst(strtolower($params['controller'])); 15       16     //获取action并把它正确的格式化，使它全部的字母都是小写的，并追加一个'Action' 17     $action = strtolower($params['action']).'Action'; 18   19     //检查controller是否存在。若是不存在，抛出异常 20     if( file_exists("controllers/{$controller}.php") ) { 21         include_once "controllers/{$controller}.php"; 22     } else { 23         throw new Exception('Controller is invalid.'); 24     } 25       26     //建立一个新的controller实例，并把从request中获取的参数传给它 27     $controller = new $controller($params); 28       29     //检查controller中是否存在action。若是不存在，抛出异常。 30     if( method_exists($controller, $action) === false ) { 31         throw new Exception('Action is invalid.'); 32     } 33       34     //执行action 35     $result['data'] = $controller->$action(); 36     $result['success'] = true; 37       38 } catch( Exception $e ) { 39     //捕获任何一次样而且报告问题 40     $result = array(); 41     $result['success'] = false; 42     $result['errormsg'] = $e->getMessage(); 43 } 44   45 //回显调用API的结果 46 echo json_encode($result); 47 exit(); 实质上，这里咱们建立的是一个简单的前端控制器，它实现了下列功能: 接受一次拥有任意个参数的API调用 为本次API调用抽取出Controller和Action 进行必要的检查确保Controller和Action都存在 执行API调用 捕获异常，若是有的话 返回一个结果给调用者

lwei 翻译于 8个月前 3人顶   顶 翻译的不错哦!

除了须要建立index.php外你还须要建立三个文件夹:   controllers,  models 和   data. controllers  文件夹存放的是全部咱们API服务器将会用到的的控制器。咱们用MVC架构来使API服务器结构更清楚合理。 models 文件夹存放全部API服务器要用到的数据模型。 data 文件夹将会用来保存API服务器的任何数据。 在controllers文件夹下建立一个叫Todo.php的文件。这将是任何TODO列表有关任务的控制器。按照TODO应用所需提供的功能，向Todo控制器里面添加必要的方法： 01 <?php 02 class Todo 03 { 04     private $_params; 05       06     public function __construct($params) 07     { 08         $this->_params = $params; 09     } 10       11     public function createAction() 12     { 13         //create a new todo item 14     } 15       16     public function readAction() 17     { 18         //read all the todo items 19     } 20       21     public function updateAction() 22     { 23         //update a todo item 24     } 25       26     public function deleteAction() 27     { 28         //delete a todo item 29     } 30 } 如今为每一个action中添加必要的功能实现。我将会提供createAction()方法的源码，其余方法将留做做业。若是你以为毫无头绪，你也能够下载示例的源码，从那里拷贝。 01 public function createAction() 02 { 03     //create a new todo item 04     $todo = new TodoItem(); 05     $todo->title = $this->_params['title']; 06     $todo->description = $this->_params['description']; 07     $todo->due_date = $this->_params['due_date']; 08     $todo->is_done = 'false'; 09       10     //pass the user's username and password to authenticate the user 11     $todo->save($this->_params['username'], $this->_params['userpass']); 12       13     //return the todo item in array format 14     return $todo->toArray(); 15 }

bigtiger02 翻译于 8个月前 3人顶   顶 翻译的不错哦!

在文件夹models下建立TodoItem.php，这样咱们就能够建立“条目添加”的代码了。注意：我并无和数据库进行链接，相反我将信息保存到文件中，虽然这能够用任何数据库来实现,可是  这样作相对来讲要容易些。 01 <?php 02 class TodoItem 03 { 04     public $todo_id; 05     public $title; 06     public $description; 07     public $due_date; 08     public $is_done; 09       10     public function save($username, $userpass) 11     { 12         //get the username/password hash 13         $userhash = sha1("{$username}_{$userpass}"); 14         if( is_dir(DATA_PATH."/{$userhash}") === false ) { 15             mkdir(DATA_PATH."/{$userhash}"); 16         } 17           18         //if the $todo_id isn't set yet, it means we need to create a new todo item 19         if( is_null($this->todo_id) || !is_numeric($this->todo_id) ) { 20             //the todo id is the current time 21             $this->todo_id = time(); 22         } 23           24         //get the array version of this todo item 25         $todo_item_array = $this->toArray(); 26           27         //save the serialized array version into a file 28         $success= file_put_contents(DATA_PATH."/{$userhash}/{$this->todo_id}.txt", serialize($todo_item_array)); 29           30         //if saving was not successful, throw an exception 31         if( $success === false ) { 32             throw new Exception('Failed to save todo item'); 33         } 34           35         //return the array version 36         return $todo_item_array; 37     } 38       39     public function toArray() 40     { 41         //return an array version of the todo item 42         return array( 43             'todo_id' => $this->todo_id, 44             'title' => $this->title, 45             'description' => $this->description, 46             'due_date' => $this->due_date, 47             'is_done' => $this->is_done 48         ); 49     } 50 } 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调用！

bigtiger02 翻译于 8个月前 4人顶   顶 翻译的不错哦!

步骤3：确保API服务器具备APP ID和APP SECRET 目前，API服务器被设置为接受所有API请求。咱们将须要将之限制在咱们本身的应用上，以确保只有咱们本身的前端客户端可以完成API请求。另外，你实际上也能够建立一个系统，其中的用户能够建立他们本身的应用，而那些应用也用用对你的API服务器的访问权，这与Facebook和Twitter的应用的的工做原理相似。 咱们从为使用API服务器的用户建立一组id-密码对开始。因为这只是一个Demo，咱们可使用任何随机的、32位字符串。对于APP ID，咱们将其设定为APP001。 再次打开index.php文件，而后用下列代码更新之： 01 <?php 02 // Define path to data folder 03 define('DATA_PATH', realpath(dirname(__FILE__).'/data')); 04   05 //Define our id-key pairs 06 $applications = array( 07     'APP001'=> '28e336ac6c9423d946ba02d19c6a2632', //randomly generated app key 08 ); 09 //include our models 10 include_once 'models/TodoItem.php'; 11   12 //wrap the whole thing in a try-catch block to catch any wayward exceptions! 13 try { 14     //*UPDATED* 15     //get the encrypted request 16     $enc_request = $_REQUEST['enc_request']; 17       18     //get the provided app id 19     $app_id = $_REQUEST['app_id']; 20       21     //check first if the app id exists in the list of applications 22     if( !isset($applications[$app_id]) ) { 23         throw new Exception('Application does not exist!'); 24     } 25       26     //decrypt the request 27     $params= json_decode(trim(mcrypt_decrypt(MCRYPT_RIJNDAEL_256, $applications[$app_id], base64_decode($enc_request), MCRYPT_MODE_ECB))); 28       29     //check if the request is valid by checking if it's an array and looking for the controller and action 30     if( $params== false || isset($params->controller) == false || isset($params->action) == false ) { 31         throw new Exception('Request is not valid'); 32     } 33       34     //cast it into an array 35     $params = (array) $params; 36     ... 37     ... 38     ...

stoneyang 翻译于 8个月前 4人顶   顶 翻译的不错哦!

咱们在这里已经完成的其实是实现一个很是简单的认证咱们的前端客户端的方法，它利用了与公共-私有密钥认证类似的系统。基本上，这里给出的就是认证过程的步骤分解： 公钥加密 完成一个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服务器的前端客户端了。

stoneyang 翻译于 8个月前 2人顶   顶 翻译的不错哦!

步骤4：建立浏览器客户端 咱们从为前端客户端设定新建文件夹开始。在你的Web服务器上的文件夹中建立一个名为simpletodo_client_browser的文件夹。完成后，建立一个index.php文件，并将下列代码写进去： 01 <!DOCTYPE html> 02 <html> 03 <head> 04     <title>SimpleTODO</title> 05       06     <link rel="stylesheet" href="css/reset.css" type="text/css" /> 07     <link rel="stylesheet" href="css/bootstrap.min.css" type="text/css" /> 08       09     <script src="js/jquery.min.js"></script> 10     <script src="js/jquery-ui-1.8.16.custom.min.js"></script> 11       12     <style> 13     body { 14         padding-top: 40px; 15     } 16     #main { 17         margin-top: 80px; 18         text-align: center; 19     } 20     </style> 21 </head> 22 <body> 23     <div class="topbar"> 24         <div class="fill"> 25             <div class="container"> 26                 <a class="brand" href="index.php">SimpleTODO</a> 27             </div> 28         </div> 29     </div> 30     <div id="main" class="container"> 31         <form class="form-stacked" method="POST" action="login.php"> 32             <div class="row"> 33                 <div class="span5 offset5"> 34                     <label for="login_username">Username:</label> 35                     <input type="text" id="login_username" name="login_username"placeholder="username" /> 36                   37                     <label for="login_password">Password:</label> 38                     <input type="password" id="login_password" name="login_password"placeholder="password" /> 39                       40                 </div> 41             </div> 42             <div class="actions"> 43                 <button type="submit" name="login_submit" class="btn primary large">Login orRegister</button> 44             </div> 45         </form> 46     </div> 47 </body> 48 </html> 这段代码的运行结果看起来就像这样： SimpleTODO的登陆页 须要注意的是我在这里已经包含了两个JavaScript文件和两个CSS文件： reset.css是你的标准CSS重置脚本。我使用了meyerweb.com css reset. bootstrap.min.css是Twitter Bootstrap jquery.min.js是最新版的jQuery library jquery-ui-1.8.16.custom.min.js是最新版的jQuery UI library 接下来，咱们建立login.php文件来存储客户端会话中的用户名和密码。 1 <?php 2 //get the form values 3 $username = $_POST['login_username']; 4 $userpass = $_POST['login_password']; 5 session_start(); 6 $_SESSION['username'] = $username; 7 $_SESSION['userpass'] = $userpass; 8 header('Location: todo.php'); 9 exit(); 这里，咱们简单地为用户开启一次会话，所依据的是用户所提供的用户名和密码组合。这充当了简单的组合密钥，它容许用户访问某个特定用户名和密码组合所存储的TODO项。而后咱们重定向至todo.php，那里是咱们开始与API服务器交互的地方。然而在咱们开始编写todo.php文件以前，先建立一个 ApiCaller类，它将封装咱们所需的所有API调用方法，包括请求的加密。 建立apicaller.php，并把下面的代码写进去： 01 <?php 02 class ApiCaller 03 { 04     //some variables for the object 05     private $_app_id; 06     private $_app_key; 07     private $_api_url; 08       09     //construct an ApiCaller object, taking an 10     //APP ID, APP KEY and API URL parameter 11     public function __construct($app_id, $app_key, $api_url) 12     { 13         $this->_app_id = $app_id; 14         $this->_app_key = $app_key; 15         $this->_api_url = $api_url; 16     } 17       18     //send the request to the API server 19     //also encrypts the request, then checks 20     //if the results are valid 21     public function sendRequest($request_params) 22     { 23         //encrypt the request parameters 24         $enc_request= base64_encode(mcrypt_encrypt(MCRYPT_RIJNDAEL_256, $this->_app_key, json_encode($request_params), MCRYPT_MODE_ECB)); 25           26         //create the params array, which will 27         //be the POST parameters 28         $params = array(); 29         $params['enc_request'] = $enc_request; 30         $params['app_id'] = $this->_app_id; 31           32         //initialize and setup the curl handler 33         $ch = curl_init(); 34         curl_setopt($ch, CURLOPT_URL, $this->_api_url); 35         curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 36         curl_setopt($ch, CURLOPT_POST, count($params)); 37         curl_setopt($ch, CURLOPT_POSTFIELDS, $params); 38   39         //execute the request 40         $result = curl_exec($ch); 41           42         //json_decode the result 43         $result = @json_decode($result); 44           45         //check if we're able to json_decode the result correctly 46         if( $result == false || isset($result['success']) == false ) { 47             throw new Exception('Request was not correct'); 48         } 49           50         //if there was an error in the request, throw an exception 51         if( $result['success'] == false ) { 52             throw new Exception($result['errormsg']); 53         } 54           55         //if everything went great, return the data 56         return $result['data']; 57     } 58 }

stoneyang 翻译于 8个月前 1人顶   顶 翻译的不错哦!

咱们将利用ApiCaller类向咱们的API服务器发送请求。这样，全部必需的加密和cURL初始化代码将会写在一个地方，咱们就不用重复代码了。 __construct函数接受三个参数： $app_id——客户端的APP ID（浏览器端是APP001） $app_key——客户端的APP KEY（浏览器端是28e336ac6c9423d946ba02d19c6a2632） $api_url——API服务器的URL，此处为http://localhost/simpletodo_api/ sendRequest()函数： 利用mcrypt库以API服务对其解密的一样方式来对请求参数进行加密 生成发往API服务器的$_POST参数 经过cURL执行API调用 查验API调用的结果是否正确 当一切都按计划进行的时候返回数据 如今，咱们开始写todo.php。首先，咱们建立一些代码来为密码为test1234的用户nikko（这是咱们先前用来测试API服务器的那个用户名/密码组合）获取当前的todo项。 01 <?php 02 session_start(); 03 include_once 'apicaller.php'; 04   05 $apicaller = newApiCaller('APP001', '28e336ac6c9423d946ba02d19c6a2632', 'http://localhost/simpletodo_api/'); 06   07 $todo_items = $apicaller->sendRequest(array( 08     'controller' => 'todo', 09     'action' => 'read', 10     'username' => $_SESSION['username'], 11     'userpass' => $_SESSION['userpass'] 12 )); 13   14 echo ''; 15 var_dump($todo_items); 打开index.php，以nikko/tes1234登陆，而后你应该看到咱们先前建立的TODO项的avar_dump()。 恭喜，你已经成功地作好了一个向API服务器的API调用！在这段代码中，咱们已经： 开启会话，使咱们拥有了对$_SESSION中的username以及userpass的访问权 实例化了一个新的ApiCaller类，为其提供了APP ID，APP KEY，以及API服务器的URL 经过sendRequest()方法发送了一个请求

stoneyang 翻译于 8个月前 2人顶   顶 翻译的不错哦!

如今，咱们来从新格式化一下数据，让它们开起来更好看些。向todo.php中添加下列HTML。别忘了移去var_dump()！ 001 <!DOCTYPE html> 002 <html> 003 <head> 004     <title>SimpleTODO</title> 005       006     <link rel="stylesheet" href="css/reset.css" type="text/css" /> 007     <link rel="stylesheet" href="css/bootstrap.min.css" type="text/css" /> 008     <link rel="stylesheet" href="css/flick/jquery-ui-1.8.16.custom.css" type="text/css" /> 009       010     <script src="js/jquery.min.js"></script> 011     <script src="js/jquery-ui-1.8.16.custom.min.js"></script> 012       013     <style> 014     body { 015         padding-top: 40px; 016     } 017     #main { 018         margin-top: 80px; 019     } 020       021     .textalignright { 022         text-align: right; 023     } 024       025     .marginbottom10 { 026         margin-bottom: 10px; 027     } 028     #newtodo_window { 029         text-align: left; 030         display: none; 031     } 032     </style> 033       034     <script> 035     $(document).ready(function() { 036         $("#todolist").accordion({ 037             collapsible: true 038         }); 039         $(".datepicker").datepicker(); 040         $('#newtodo_window').dialog({ 041             autoOpen: false, 042             height: 'auto', 043             width: 'auto', 044             modal: true 045         }); 046         $('#newtodo').click(function() { 047             $('#newtodo_window').dialog('open'); 048         }); 049     }); 050     </script> 051 </head> 052 <body> 053     <div class="topbar"> 054         <div class="fill"> 055             <div class="container"> 056                 <a class="brand" href="index.php">SimpleTODO</a> 057             </div> 058         </div> 059     </div> 060     <div id="main" class="container"> 061         <div class="textalignright marginbottom10"> 062             <span id="newtodo" class="btn info">Create a new TODO item</span> 063             <div id="newtodo_window" title="Create a new TODO item"> 064                 <form method="POST" action="new_todo.php"> 065                     <p>Title:<br /><input type="text" class="title" name="title"placeholder="TODO title" /></p> 066                     <p>Date Due:<br /><input type="text" class="datepicker" name="due_date"placeholder="MM/DD/YYYY" /></p> 067                     <p>Description:<br /><textarea class="description"name="description"></textarea></p> 068                     <div class="actions"> 069                         <input type="submit" value="Create" name="new_submit" class="btn primary"/> 070                     </div> 071                 </form> 072             </div> 073         </div> 074         <div id="todolist"> 075             <?php foreach($todo_items as $todo): ?> 076             <h3><a href="#"><?php echo $todo->title; ?></a></h3> 077             <div> 078                 <form method="POST" action="update_todo.php"> 079                 <div class="textalignright"> 080                     <a href="delete_todo.php?todo_id=<?php echo $todo->todo_id; ?>">Delete</a> 081                 </div> 082                 <div> 083                     <p>Date Due:<br /><input type="text"id="datepicker_<?php echo $todo->todo_id; ?>" class="datepicker" name="due_date" value="12/09/2011" /></p> 084                     <p>Description:<br /><textarea class="span8"id="description_<?php echo $todo->todo_id; ?>" class="description" name="description"><?phpecho $todo->description; ?></textarea></p> 085                 </div> 086                 <div class="textalignright"> 087                     <?php if( $todo->is_done == 'false' ): ?> 088                     <input type="hidden" value="false" name="is_done" /> 089                     <input type="submit" class="btn" value="Mark as Done?" name="markasdone_button"/> 090                     <?php else: ?> 091                     <input type="hidden" value="true" name="is_done" /> 092                     <input type="button" class="btn success" value="Done!" name="done_button" /> 093                     <?php endif; ?> 094                     <input type="hidden" value="<?php echo $todo->todo_id; ?>" name="todo_id" /> 095                     <input type="hidden" value="<?php echo $todo->title; ?>" name="title" /> 096                     <input type="submit" class="btn primary" value="Save Changes"name="update_button" /> 097                 </div> 098                 </form> 099             </div> 100             <?php endforeach; ?> 101         </div> 102     </div> 103 </body> 104 </html> 这段代码的运行结果以下： 很酷哈？但它目前啥也干不了，那么让咱们开始添加一些功能吧。我将为new_todo.php提供代码，它们调用todo/createAPI调用来建立新的TODO项。建立其余页（update_todo.php和delete_todo.php）应该与此十分类似，所以我把它们留给你。打开new_todo.php，而后把下面的代码添进去： 01 <?php 02 session_start(); 03 include_once 'apicaller.php'; 04   05 $apicaller = newApiCaller('APP001', '28e336ac6c9423d946ba02d19c6a2632', 'http://localhost/simpletodo_api/'); 06   07 $new_item = $apicaller->sendRequest(array( 08     'controller' => 'todo', 09     'action' => 'create', 10     'title' => $_POST['title'], 11     'due_date' => $_POST['due_date'], 12     'description' => $_POST['description'], 13     'username' => $_SESSION['username'], 14     'userpass' => $_SESSION['userpass'] 15 )); 16   17 header('Location: todo.php'); 18 exit(); 19 ?> 正如你所看到的，new_todo.php页再次使用了ApiCaller调用来简化向API服务器所发送的  todo/create请求。这主要完成了与以前相同的事情： 开启一个会话，以使其得到对存储于$_SESSION中的$username和$userpass的访问权 实例化一个新的ApiCaller类，为它提供APP ID， APP KEY，以及API服务器的URL 经过sendRequest()方法发送请求 重定向回todo.php 恭喜，它好用了！你已经成功地建立了一个以API为中心的应用！

stoneyang 翻译于 8个月前 2人顶   顶 翻译的不错哦!

结论 围绕API建立并开发应用具备如此之多的优点。想建立一个Android版的SimpleTODO？你须要的全部功能都已经在API服务器上了，因此你所要作的就是建立客户端！想重构或者优化某些类？没问题——只要确保输出相同便可。想添加更多的功能？你能够在不影响任何客户端代码的前提下作到！ 尽管存在着某些像是更长的开发时间或者更加复杂，可是以这种方式开发网络应用的优点却远比其劣势更重要。今天的这种开发由咱们本身权衡取舍，从而使咱们可以在未来获益。 你是准备使用一台API服务器做为你的下一个Web应用，仍是已经在过去的项目中使用了相同的技术？请在评论中告知！