SOAP Interfaces

The SOAP services offer the primary interface to the GRID including all features of any other offered API layer. The endpoints are fully standards compliant including WSDL (& XMLSchema).

All SOAP interfaces are implemented using the JAX-WS technology and published inside the JEE environment via Servlet 3.0 annotations (e.g. @WebServlet("/ws/path/*")). The effective path to interface mapping can be seen inside the overview table below.

Note: Services can be identified easily inside the ApiDocs by looking for interfaces that derive from the com.trendmicro.grid.acl.Service.

[M] WSDL Location Endpoint Interface / XML Namespace
http://host:port/ws/level-0/internal/cache-control?wsdl com.trendmicro.grid.acl.l0.CacheControlService
http://grid.trendmicro.com/services/level-0
9 Methods
http://host:port/ws/level-0/internal/filecontent-request?wsdl com.trendmicro.grid.acl.l0.FileRequestService
http://grid.trendmicro.com/services/level-0
2 Methods
http://host:port/ws/level-0/internal/files?wsdl com.trendmicro.grid.acl.l0.FileService
http://grid.trendmicro.com/services/level-0
2 Methods (not showing 15, inherited from com.trendmicro.grid.acl.l0.PublicFileService)
http://host:port/ws/level-0/internal/packages?wsdl com.trendmicro.grid.acl.l0.PackageService
http://grid.trendmicro.com/services/level-0
6 Methods (not showing 29, inherited from com.trendmicro.grid.acl.l0.PublicPackageService)
http://host:port/ws/level-0/internal/processing?wsdl com.trendmicro.grid.acl.l0.ProcessingService
http://grid.trendmicro.com/services/level-0
23 Methods
http://host:port/ws/level-0/authentication?wsdl com.trendmicro.grid.acl.l0.PublicAuthenticationService
http://grid.trendmicro.com/services/level-0
7 Methods
http://host:port/ws/level-0/categories?wsdl com.trendmicro.grid.acl.l0.PublicCategoryService
http://grid.trendmicro.com/services/level-0
18 Methods
http://host:port/ws/level-0/files?wsdl com.trendmicro.grid.acl.l0.PublicFileService
http://grid.trendmicro.com/services/level-0
17 Methods
http://host:port/ws/level-0/packages?wsdl com.trendmicro.grid.acl.l0.PublicPackageService
http://grid.trendmicro.com/services/level-0
35 Methods
http://host:port/ws/level-0/reporting?wsdl com.trendmicro.grid.acl.l0.PublicReportService
http://grid.trendmicro.com/services/level-0
2 Methods
http://host:port/ws/level-0/internal/server-statistics?wsdl com.trendmicro.grid.acl.l0.ServerStatisticsService
http://grid.trendmicro.com/services/level-0
3 Methods
http://host:port/ws/level-0/internal/sources?wsdl com.trendmicro.grid.acl.l0.SourceService
http://grid.trendmicro.com/services/level-0
19 Methods
http://host:port/ws/discovery?wsdl com.trendmicro.grid.acl.PublicServiceDiscovery
http://grid.trendmicro.com/services
1 Methods

Note: While the interfaces can be used by any valid combination of SOAP client + programming language, there's also a pre-compiled client & examples included inside the module ws-server-client.

Using the pre-compiled client allows to operate directly on the API described inside the ApiDocs. In contrast to this, when client stubs are created from WSDL the effective API may divert slightly from what is described in the docs. This is caused by the fact that WSDL defines an application protocol but no details on the implementation. The layout and design of client stubs depends on the used SOAP framework.