Web services 命名soapweb服务端点地址

Web services 命名soapweb服务端点地址,web-services,soap,Web Services,Soap,我正在开发一个SOAP接口,在决定端点地址的名称时遇到了困难 选项: - {soap,api,service,???}.foo.com.au - www.foo.com.au/{soap,api,service,???} SOAP服务的典型名称是什么?我会使用www.foo.com.au/SOAP,主要是因为这是一种告诉人们它是SOAP服务的简单方法,如果您以后想添加REST服务,可以使用www.foo.com.au/REST请记住,在实践中,所有解决方案在技术上都是等效的。一种命名系统相对于

我正在开发一个SOAP接口,在决定端点地址的名称时遇到了困难

选项:

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

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

我会使用
www.foo.com.au/SOAP
,主要是因为这是一种告诉人们它是SOAP服务的简单方法,如果您以后想添加REST服务,可以使用
www.foo.com.au/REST
请记住,在实践中,所有解决方案在技术上都是等效的。一种命名系统相对于另一种命名系统的好处在于,它可以轻松地理解URL的含义(对于人类而言),或者说它的可维护性。因此,如果您正在寻找一个标准,我们最多只能告诉您:

  • 如果您有一家拥有大量应用程序的大公司,请选择
    http://api.company.com/application/rest
    和/或
    http://api.company.com/application/soap
    方法
    • 原因:您可以从一开始(从网络角度)就将web服务服务器()与人类web浏览服务器()分离
    • 所有应用程序都有一个大的根“汇合点”(根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:
  • Twitter的搜索API:
  • Facebook的图形API:
  • Facebook的对话API:(请参阅,甚至在Facebook中也没有标准)
  • 天气预报:
Buy many似乎保持了良好的公司范围API“汇合点”:

我一直觉得“约翰”是个好名字。我建议你把它命名为
john.foo.com.au
,因为
john
应该总是在最上面。