因此,我一直在浏览有关创建REST API的文章。其中一些建议使用所有类型的HTTP请求:like PUT DELETE POST GET。我们将创建例如 index.php 并以这种方式编写API:
PUT
DELETE
POST
GET
$method = $_SERVER['REQUEST_METHOD']; $request = split("/", substr(@$_SERVER['PATH_INFO'], 1)); switch ($method) { case 'PUT': ....some put action.... break; case 'POST': ....some post action.... break; case 'GET': ....some get action.... break; case 'DELETE': ....some delete action.... break; }
好的,理所当然-我对Web服务还不太了解。但是,通过常规或(包含方法名称和所有参数)接受 JSON 对象,然后也以JSON进行响应,会不会更容易。我们可以轻松地通过PHP进行序列化/反序列化,并且无需处理不同的HTTP请求方法就可以对数据进行任何处理。POST``GET``json_encode()``json_decode()
POST``GET``json_encode()``json_decode()
我想念什么吗?
更新1:
好的-在研究了各种API并学习了很多有关 XML-RPC , JSON-RPC , SOAP 和 REST的知识之后, 我得出了这样的API合理的结论。实际上,堆栈交换实际上是在他们的站点上使用这种方法的,我确实认为这些人知道他们在做什么堆栈交换API。
的想法 RE 表象 小号 泰特 Ť 转让(BOT)是不是在可能的最简单的方法访问数据。
您建议使用发布请求来访问JSON,这是访问/处理数据的一种完全有效的方法。
REST是一种 有意义 的数据访问方法。当您在REST中看到请求时,应该立即了解数据的情况。
例如:
GET: /cars/make/chevrolet
可能会返回雪佛兰汽车的清单。 好的REST api甚至可以在querystring中包含一些输出选项,例如?output=json或?output=html,这将允许访问者决定信息应以哪种格式编码。
?output=json
?output=html
关于如何合理地一体化的数据类型为REST API比特思考后,我已经得出结论,最好的办法明确指定的数据类型是通过已存在的文件扩展名,例如.js,.json,.html,或.xml。缺少的文件扩展名将默认为默认格式(例如JSON);不支持的文件扩展名可能返回501 Not Implemented状态码。
.js
.json
.html
.xml
501 Not Implemented
另一个例子:
POST: /cars/ { make:chevrolet, model:malibu, colors:[red, green, blue, grey] }
可能会在db中创建具有关联颜色的新雪佛兰马里布。我说的 可能 是因为REST api不需要与数据库结构直接相关。它只是一个屏蔽接口,因此可以保护真实的数据(例如数据库结构的访问器和变异器)。
现在我们需要讨论幂等问题。通常,REST 通过HTTP 实现CRUD。HTTP使用GET,PUT,POST和DELETE为请求。
REST的一个非常简单的实现 可以 使用以下CRUD映射:
Create -> Post Read -> Get Update -> Put Delete -> Delete
此实现存在一个问题:Post被定义为非幂等方法。这意味着相同Post方法的后续调用将导致 不同的 服务器状态。Get,Put和Delete是幂等的;这意味着多次调用它们应导致相同的服务器状态。
这意味着请求如下:
Delete: /cars/oldest
实际上可以实现为:
Post: /cars/oldest?action=delete
鉴于
Delete: /cars/id/123456
如果调用一次或调用1000次,将导致相同的服务器状态。
处理该oldest物品移除的更好方法是要求:
oldest
Get: /cars/oldest
并使用ID结果数据中的发出delete请求:
ID
delete
Delete: /cars/id/[oldest id]
这种方法的问题是,是否/cars在/oldest请求时间和delete发布时间之间添加了另一个项目。
/cars
/oldest