编写基于.NET的RESTful API的最佳实践

Question

今年早些时候，StackOverflow的强悍人员竭力为我们提供StackExchange Universe的API。他们按照他们做其他事情的方式做到了这一点 - 非常谨慎地确保API具有防弹性和精心设计。

我正在开始编写基于SaaS的ERP系统的项目，似乎公共API可能是应用程序集成的未来需求。 Jeff和公司在StackApps的讨论中明确表示，编写一个好的公共API是 hard 。

我的问题是：

编写公共RESTful API时需要考虑哪些事项，特别是在.NET平台上？

Answer 1

您需要做的第一个决定是，您是否真的想要构建RESTful系统，或者您是否想要创建HTTP API。这是两个不同的问题。

过去四年来，我一直在构建RESTful ERP系统，这与创建集成API不同。

如果您确实想构建RESTful系统，那么媒体类型和链接关系的设计将是该过程中最重要的部分。