Release history

The current section provides an overview of changes in each release of the GITB test service APIs.

Release numbers follow global numbering covering all Test Bed components, meaning that certain releases may have not actually introduced changes to the GITB service APIs. The current page lists only the releases that introduced changes, whereas those not included are global maintenance releases that made no changes to the APIs.

The latest release of the GITB test service APIs is 1.30.1.

Release 1.30.0 - 21/09/2026

The documentation for release 1.30.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Test services can now be integrated over REST as an alternative to SOAP, with REST recommended for new services.

REST and SOAP integration

New gitb-types-model library providing plain Java types, service interfaces and fluent builders for REST-based services.

Using the gitb-types libraries

OpenAPI definitions for the service and call-back APIs added to gitb-types-specs.

Specification links

Test session metadata and the call-back address are provided as HTTP headers for REST services.

Retrieving test session metadata

Test Bed call-backs can now be secured with API keys, and the REST and SOAP call-back APIs can be enabled or disabled independently.

Securing Test Bed call-backs

New handlerApiType test step attribute to select the REST or SOAP API style used to call a test service (defaults to SOAP).

REST and SOAP integration

The service template can now generate either a REST or a SOAP project.

Service template

Release 1.25.0 - 31/01/2025

The documentation for release 1.25.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Detailed validation reports from external messaging and processing handlers are displayed even when counters not defined.

Constructing a validation report (TAR)

Release 1.23.0 - 20/06/2024

The documentation for release 1.23.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

New template-test-service template, replacing the separate ones per service, and allowing configurable creation of multiple endpoints and sample code addition.

Service template

Release 1.19.0 - 17/03/2023

The documentation for release 1.19.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

The gitb-types library is now available in three variants (XSDs and WSDLs only, javax APIs and Jakarta API).

Using the gitb-types libraries

Release 1.18.0 - 17/10/2022

The documentation for release 1.18.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Test services can now access test session metadata as SOAP header elements (test session ID, test case ID, test step ID, engine version).

Retrieving test session metadata

Release 1.16.0 - 18/03/2022

The documentation for release 1.16.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Test services can now contribute log entries to the test session’s log.

Contributing to test session logs

Release 1.15.0 - 29/11/2021

The documentation for release 1.15.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Support for the forDisplay and forContext flags on service outputs to define their purpose.

Defining the purpose of outputs

Returning a session identifier in the initiate operation of messaging services is now optional.

initiate

Release 1.14.0 - 17/08/2021

The documentation for release 1.14.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Services can now set a mime type on return values to facilitate their post-processing and display.

Returning outputs

Release 1.13.0 - 01/07/2021

The documentation for release 1.13.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Processing services can now return data to be displayed to users when used in GITB test cases.

Returning context information for visible process steps

Release 1.12.0 - 03/03/2021

The documentation for release 1.12.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

The session identifier is no longer a mandatory input for validation and processing services, facilitating their standalone use.

Validation services, Processing services,

Release 1.11.0 - 13/11/2020

The documentation for release 1.11.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Validation services called from test cases can now have their output data used in subsequent test steps (not only used for display).

Using validator output in test cases

Release 1.10.0 - 07/09/2020

The documentation for release 1.10.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

Defining inputs and output in the getModuleDefinition operation is now optional.

getModuleDefinition (messaging), getModuleDefinition (processing), getModuleDefinition (validation)

Release 1.8.0 - 20/01/2020

The documentation for release 1.8.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

TAR validation reports can now be set with an overall result of TestResultType.WARNING.

Constructing a validation report (TAR)

Release 1.6.0 - 29/05/2019

The documentation for release 1.6.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

All template services are now adapted to use Java 11, with Docker images based on the openjdk:11-jre base image.

Service template

Release 1.5.0 - 06/11/2018

The documentation for release 1.5.0 of the GITB test service APIs is available here.

Description of changes

Relevant sections

The messaging services’ callbacks are now implemented using the more flexible Apache CXF

Messaging services, Service template

The template messaging service now also includes configurable proxy settings for test bed call-backs

Messaging services, Service template

Release 1.4.0 - 03/07/2018

Initial release of the documentation for the GITB test service APIs (release 1.4.0), available here.