0

我正在开发一个 SOAP 接口，但在决定用什么命名端点地址时遇到了麻烦。

选项：

- {soap,api,service,???}.foo.com.au
- www.foo.com.au/{soap,api,service,???}

SOAP 服务获得的典型名称是什么？

4

2 回答 2

1

我会使用www.foo.com.au/soap，主要是因为它是一种告诉人们它是 SOAP 服务的简单方法，如果您想稍后添加 REST 服务，您可以使用www.foo.com.au/rest

于 2013-05-09T02:17:36.227 回答
1

请记住，在实践中，所有解决方案在技术上都是等效的。一个命名系统相对于另一个命名系统的好处只是容易理解或理解 URL 的含义（对人类而言）或可维护性。因此，如果您正在寻找一个标准，我们最多只能说：

  • 如果您有一家拥有大量应用程序的大公司，请选择 http://api.company.com/application/rest和/或http://api.company.com/application/soap方法
    • 原因：您可以从一开始（网络方面）将 Web 服务服务器 ( http://api.srv.com/app ) 与人类Web 浏览服务器 ( http://www.srv.com/app ) 分开。
    • 所有应用程序都有一个大根“会议”点（根 URL api.company.com），因此如果有人想知道公司范围内可用的内容，只需检查一下http://api.company.com，它就会列出所有可用的服务。
  • 如果您的设置不是那么大，那么可能不值得麻烦，所以不要害怕使用www.. 但请记住，最好至少使用不同的上下文，例如api/，以便任何人立即知道服务 URL 是关于 Web 服务的（！）：http://www.company.com/application/api/rest/http://www.company.com/application/api/soap

注意：它也很常见service，尽管它api似乎更具有描述性（api.something.com毫无疑问该页面是关于什么的）。

一些示例（如您所见，实际上没有全球标准）：

购买许多似乎保留了良好的公司范围的API“交汇点”：

于 2013-05-09T03:54:09.573 回答