Skip to main content

Lookup one endpoint on the Service Locator server

Lookup one endpoint for a given service.

Parameters: fully qualified encoded service name, required user defined properties (optional).

Return: one WS-Addressing EPR, for an endpoint that provides the service and fulfills the required properties. If several endpoints match select one randomly. If none exists return WebApplicationException and status 404.

The Lookup one endpoint for given Service operation is described in LocatorService.wadl as follows:

<resource path="endpoint/{serviceName}">
  <method name="GET" id="lookupEndpoint">
    <request>
      <param name="serviceName" type="xsd:string" style="template"
          required="true" />
      <param name="param" type="xsd:string" style="matrix"
          repeating="true" />
    </request>
    <response status="200">
      <representation mediaType="application/xml" 
          element="wsa:EndpointReference"/>
      <representation mediaType="application/json" 
          element="wsa:EndpointReference"/>
    </response>
  </method>
</resource>

Example of request url with GET method: locator/endpoint/{namespaceURI}localPart?p=key1,value1;p=key2,value2;p=key3,value3. Note that any / in the namespaceURI has to be replaced with %2F, and that { and } that wraps the namespaceURI need to be replaced by %7B and %7D.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!