getInstance

The getInstance method creates an instance of the Unica Interact API that communicates with the specified runtime server.

getInstance(String URL)
Important: Every application you write using the Unica Interact API must call getInstance to instantiate an InteractAPI object which is mapped to a runtime server specified by the URL parameter.

For server groups, if you are using a load balancer, use the hostname and port you configure with the load balancer. If you do not have a load balancer, you will have to include logic to rotate between the available runtime servers.

This method is applicable for the Java™ serialization over HTTP adapter only. There is no corresponding method defined in the SOAP WSDL. Each SOAP client implementation has its own way of establishing the endpoint URL.

  • URL - A string identifying the URL for the runtime instance. For example, http://localhost:7001/Interact/servlet/InteractJSService.

Return value

The runtime server returns the InteractAPI.

Example

The following example shows how to instantiate an InteractAPI object that points to a runtime server instance running on the same machine as your touchpoint.

InteractAPI api=InteractAPI.getInstance("http://localhost:7001/interact/servlet/InteractJSService");