良好的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的实时控制台。