In addition to the X-Road SOAP API for message exchange, X-Road provides several other APIs to both X-Road users and administrators. In the Security Server versions < v6.22.0 the APIs provide access to data processed and produced by the Security Server. In the versions >= v.6.22.0 the APIs will provide access to maintenance and configuration features too.

The APIs represent different API styles: SOAP, REST and JMX. Some information, e.g. environmental and operational monitoring data, is available via multiple APIs representing different API styles. Instead, other information is available via a single API.

Most of the current APIs are based on SOAP, but the aim is to favor REST/JSON in design and implementation of new APIs. For example, REST version of X-Road's message exchange API will be published during spring 2019 (v6.21.0) and a REST API for administration purposes in autumn 2019 (v6.22.0).

Below there's a list of the current Security Server APIs.

Message Exchange

Message exchange via X-Road is done using the Security Server's message exchange interface. X-Road versions <= v6.20.0 support only SOAP, but in versions >= v6.21.0 also REST is supported.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/Protocols/pr-mess_x-road_message_protocol.md

Meta Services

Meta services provide methods that can be used to discover what services are available within an X-Road instance and download the WSDL files describing the services.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/Protocols/pr-meta_x-road_service_metadata_protocol.md

Environmental Monitoring

Environmental monitoring provides technical monitoring information about the Security Server, e.g. details of the security servers such as operating system, memory, disk space, CPU load, running processes and installed packages, etc.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/EnvironmentalMonitoring/Monitoring-messages.md

Operational Monitoring

Operational monitoring provides operational monitoring information and statistics about the Security Server, e.g. which services have been called, how many times, what is the average response time, etc.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/OperationalMonitoring/Protocols/pr-opmon_x-road_operational_monitoring_protocol_Y-1096-2.md
• https://github.com/nordic-institute/X-Road/blob/develop/doc/OperationalMonitoring/Protocols/pr-opmonjmx_x-road_operational_monitoring_jmx_protocol_Y-1096-3.md

Signed Document Download

An API for retrieving signed and time-stamped messages processed by the Security Server.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/Manuals/ug-sigdoc_x-road_signed_document_download_and_verification_manual.md

Healthcheck

The health check API can be used to ping the Security Server using HTTP to see if it is healthy and likely to be able to send and receive messages.

More information:

• https://github.com/nordic-institute/X-Road/blob/develop/doc/Manuals/LoadBalancing/ig-xlb_x-road_external_load_balancer_installation_guide.md#34-health-check-service-configuration

Management API

Management API provides access to all the administrative features of the Security Server - all the features that are available in the Security Server management console are available through the API too. The management API is available starting from version 6.22.0 that is released in autumn 2019.

Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.