Skip to main content

REST output

Configure the REST output connector that returns converted files to a URL, which you can configure with the connection ID.

REST Output​

The REST Output connector posts files as a multipart/form-data request to a configurable output URL. The URL may contain placeholder variables coming from the input connector.

For example:

  • http://example.com/path/on/server/?id=[input:id]
  • [input:url]
  • http://example.com/[input:serverpath]

The following additional configuration options are available:

  • The connector can either post the unchanged input files or the converted result files.
  • The form-data field name of the files.
  • Additional form fields can be configured where the values may contain placeholder values coming from the input connector.
  • The value of the HTTP Accept header can be configured freely.

Authentication​

The connector supports username/password based authentication schemes such as Basic, Digest, NTLM, and Kerberos.

The server must challenge unauthenticated requests properly with a 401 response. The connector preauthenticates subsequent requests to the same URL, i.e. send the necessary HTTP header without waiting to be challenged by the server.