Diffusion REST Adapter User Guide

Version: 2.0.0

Gateway Framework version: 2.1.0

Publish date: 10-06-2024

Logo Diffusion transparent
Prerequisite: See Gateway Application for a generic overview of a Gateway application and how to configure it.

About the REST adapter

The REST adapter is a Gateway Application that enables polling external REST API(s) and publishing the resulting JSON response data into Diffusion.

The adapter uses the Diffusion Gateway Framework, hence supports all features supported by the framework. See Gateway Application section in the Framework’s user guide to understand the concepts of the framework and to understand how to configure a Gateway application.

The adapter can be viewed and managed from the Diffusion management console of the connected server or on any other server in the same cluster. Once started, the adapter is visible on the Diffusion console, in the 'Network' section, as type 'RestAdapter' with the id specified in the configuration.

rest adapter drawing
Figure 1. Rest adapter

In order to use the REST adapter, some basic configuration is required for it to connect to a Diffusion server. The connection configuration can be expressed in a number of different ways, such as: configuration files, environment variables, or system properties.

Notable features

  • Support for HTTP headers

  • GET with query parameters

  • POST - static string content can be posted to an API

About this document

This document should be used in conjunction with the Gateway Framework user guide. Together, these resources provide comprehensive instructions on how to set up and utilise the REST Adapter with Diffusion.

If you are accessing this document bundled together with the adapter artifacts, please refer to the online version of the same document for its latest version.
Build: 42842.090a5615