命名SOAP Web服务端点地址

时间:2013-05-09 02:15:25

标签: web-services soap

我正在开发一个SOAP接口,无法确定端点地址的名称。

选项:

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

SOAP服务的典型名称是什么?

2 个答案:

答案 0 :(得分:1)

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

答案 1 :(得分:1)

请记住,在实践中,所有解决方案在技术上都是等同的。一个命名系统优于另一个命名系统的好处仅在于易于理解URL(对于人类)或可维护性。所以,如果你正在寻找一个标准我们可以告诉,充其量:

  • 如果您有一家拥有大量应用程序的大公司,请选择http://api.company.com/application/rest和/或http://api.company.com/application/soap方法
    • 原因:您可以从人类网络浏览服务器(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 / {{ 1}}

注意:使用http://www.company.com/application/api/soap也很常见,虽然service似乎更具描述性(api对该页面的内容毫无疑问)。

一些例子(如您所见,实际上没有全球标准):

买很多似乎保持良好的'公司范围的 API“会面点”: