web-services - 是否有适用于开发人员团队的 Web 服务 (API) 标准或最佳实践？

Question

如果您要开始为您的 Web 应用程序开发 API。是否有任何类型的指南、最佳实践或标准来构建 Web 服务。我已经看到了一些关于这个主题的讨论，我想获得更多信息。

至少获得有关从何处获取信息的指示。

提前致谢。

Answer 1

关于“Web 服务”存在广泛的多样性和自由度。我发现明确记录我们正在谈论的内容很有用:

web = transported over HTTP(S)
service = remote procedure call (RPC)

请注意，其中的 HTTP(S) 部分仅指定传输介质，而不指定内容。另请注意，此 RPC 部分仅指定行为(本质上是远程调用具有返回结果的参数的命名函数)而不是内容。

出现的一个关键问题是您是否控制了通信的双方。如果是这样，尤其是如果不是，您需要关注互操作性。

SOAP 是用于实现 Web 服务的标准，该服务指定对请求和响应的内容使用特定格式的 XML。它非常繁重，并且在各种实现之间的互操作性方面仍然存在问题。

有很多自定义实现，其中大多数更轻量级，但您几乎肯定会遇到互操作性问题。

由于任何形式的内容都可能用于实现 Web 服务，因此我建议选择能够处理复杂内容(在不同程度上)、标准化、轻量级和健壮性的内容。

我最近倾向于使用 JSON 作为内容格式。我建议考虑相同，特别是如果您正在考虑实现 AJAX。

最好的祝愿。