良好的 Web 服务示例

Question

我的任务是为我们的基础架构设计一个新的 API。我想做的一些事情是：

• 实施 oauth 进行身份验证
• 良好的基于​​ xml 的结构，适应 ATOM、GEO-RSS 和其他适用的 xml 模式标准。
• JSON 输出

我一直在考虑的一些事情是应用 REST。在实践中，我发现它不像更“方法、参数、结果”的 RPC 模型那么容易掌握。

特别是因为没有简单的 CRUD 模型，但是大约 250 种不同的操作对我来说没有多大意义。

我想知道的一些事情是，我应该如何在 JSON 格式和命名空间 XML 格式之间创建良好的映射。如果这不能直观地工作，我将手动映射所有数据类型。

所以基本上，我想知道您的想法，以及您是否有任何复杂但易于使用的 API 示例。

如果您想知道，SOAP 是不可能的。

Answer 1

英国报纸Guardian 有一个优秀的（新的）API。它很大，有许多客户端库，并且有一个非常好的API explorer - 它在您的浏览器中用作拆分窗格，并带有一个实时控制台，用于玩弄 API。