Home > Pipeline Modules > Transmitters
REST Transmitter
A simple yet powerful option to send messages to other systems is to use the REST Transmitter, this will take Outgoing Message Definition as procesed by the Output Translator and send them to a REST endpoint.
As part of your Outgoing Message Definition you have the option to provide a REST Method, if you do not provide one, the transmitter will
assume it’s a GET
method.
Required Fields
In addition to the standard fields that are required for any transmitter, the following fields are required:
Transmitter Type (required)
REST
Host Name (required)
Provide the protocol and domain name of that server that you wish to send the message to.
Although you can enter a path, that path should come from the Outgoing Message Definition. An exception to this is a partial path that will be used to send all the messages to on the server.
The REST Transmittter supports sending HTTP and HTTPS messages as specified in the Host Name.Examples:
https://myserver.com http://myserver.com http://myserver.com:9353
If you wish to add a parital path your Host Name mgith look as follows
https://myserver.com/api
Your host name should not end in a forward slash
/
, if it is, the transmitter may strip that out if your path from the message starts with a/
Anonymous Connection
Select this option if your REST server does not require authentication (not recommended).User Name/Password
The user name and password are optional, but if provided will be used to send an authorization header as a Basic Access authentication. We understand this may not meet your needs so please contacts us to discuss your specific needs. You have access to add your own custom headers and you may be able to add a custom authentication header that will be sent along with the requestHeaders
In addition to the headers that will come from the message you can add additional headers that will be sent along with the request.