D
D
Documentation
Search
K

Send Request To Endpoint

An application comprises of multiple endpoints. Each endpoint has a name which is used in the URL. Which endpoint is requested is specified when the user calls the application.
Endpoint URL
https://{base-url}/{application}/{endpoint}

Send Request to Endpoint

OpenEndpoints knows 2 types of data sources that can serve as input for the content transformation:
  • data that is transferred with the request, and
  • data that is loaded from other sources when the endpoint is executed in the background.
The following methods are available to transfer data with the request:
  • GET Request with parameters URL-encoded
  • POST Request containing parameters. This is the default when an HTML <form> is used. The default content type is application/x-www-form-urlencoded. Use multipart/form-data to add any number of file uploads.
  • POST Request with application type application/xml: In this case arbitrary XML is supplied (in the request body), which is passed to the parameter-transformation-input structure, inside the <input-from-request> element instead of the normal <parameter> elements.
  • POST Request with application type application/json: In this case arbitrary JSON is supplied (in the request body), which is converted to XML and passed to the parameter-transformation-input structure, inside the <input-from-request> element instead of the normal <parameter> elements. Any characters which would be illegal in XML (for example element name starting with a digit) replaced by _xxxx_ containing their hex unicode character code.

Special Parameters

There are the following special request parameters:
Parameters
Text
Possible Values
hash
mandatory
calculated sha-256 hash - see Authentication
environment
optional
preview or live (default) - see Environments
debug
optional
true or false (default) - see Debug Mode
How to supply special parameters
Special parameters are supplied along with the normal parameters, apart from in the case of a POST request application/xml or application/json in which case these special parameters are passed as GET parameters