原文:http://yuguo.us/weblog/php-rest-api/
表征状态转移（英文：REpresentational State Transfer，简称REST）是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。
越来越多的公司开放了API，比如腾讯开放平台，淘宝开放平台，百度开放平台，Google Developers等。开放的方式各不相同，有REST和SOAP两种。
REST很容易理解，而且只要是支持HTTP/HTTPS的客户端/服务器就支持它。你可以用HTTP GET方法来执行命令。所以，开发者们感受到的REST的优势是：开发简单、只需依托现有Web基础设施、以及学习成本低。
然而，SOAP作为一种古老的Web服务技术，短期内还不会退出历史舞台。
在我们第三方开发者的PHP应用程序中如果要使用REST API，主要分为两个步骤。一、生成请求。二、处理返回值。
一、生成请求
主要有三种方法来生成一个HTTP请求。
第一种方法就是手动生成请求，使用PHP的header方法。这给了你最大的灵活性，但是需要更多的 编码。
第二种方法是使用PHP内置的file_get_contents()方法或者file()/fopen()/fread()/fclose()方 法，使用这种方法少了一点灵活性，但是代码量非常少。
第三种方法是使用跟API配套的自定义Class，或者叫SDK。如果可以的话，尽量使用第三种方 法，它是最方便的。
手动生成请求
手动生成请求只有在第一次处理的时候才有点棘手，以后的话可以调用方法直接得到结果。此外了解手动生成请求的过程也有助于理解REST和HTTP。
function callAPI($endpoint, $devkey, $action, $type, $keyword)
{
$action = urlencode($action);
$type = urlencode($type);
$keyword = urlencode($keyword);
$url = $endpoint . "?devkey=$devkey&action=$action&type=$type&keyword=$keyword";
$url_info = parse_url($url);
$host = $url_info[‘host‘];
$path = $url_info[‘path‘] . "?" . $url_info[‘query‘];
$data = "";
$fp=fsockopen($host, 80);
fputs($fp, "POST ". $path . "HTTP/1.1\r\n");
fputs($fp, "Host: ". $host ."\r\n");
fputs($fp, "Accept: */*\r\n");
fputs($fp, "Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7\r\n");
fputs($fp, "Connection: close\r\n");
fputs($fp, "Content-Type: application/x-www-form-urlencoded\r\n");
fputs($fp, "Content-Length: ". strlen($data) . "\r\n\r\n");
fputs($fp, "$data");
$response="";
while(!feof($fp))
{
$response.=fgets($fp, 128);
}
fclose($fp);
list($http_headers, $http_content)=explode("\r\n\r\n", $response);
return $http_content;
}
快速方法(使用PHP的内置方法file_get_contents会让代码量少很多（也少了一些灵活性）。)
function callAPIQuick($endpoint, $devkey, $action, $type, $keyword)
{
$action = urlencode($action);
$type = urlencode($type);
$keyword = urlencode($keyword);
$url = $endpoint . "?devkey=$devkey&action=$action&type=$type&keyword=$keyword";
$response = @file_get_contents($url);
return $response;
}
SDK方法
很多开放平台都会提供各语言的SDK下载，比如淘宝开放平台就提供了java、.net、PHP的SDK，并且还能够根据每个应用的API调用权限进行单独打包。
原文作者没有提到curl方法,这个方法也很方便.
二、处理返回值
返回值要么是JSON格式，要么是XML格式。
如果是XML的话，可以使用PHP5的simplexml来解析。自从PHP 5.2，也已经默认加入了JSON格式的支持。