Follow

HTTP Endpoint Configuration

Article published on the 4th of February, 2022.

1. Introduction

In this article, we will cover how to configure HTTP endpoints to be used in processes using the Process Management Framework.

HTTP endpoints allow you to integrate various web applications into your processes. An endpoint provides a simple way to define the base URL and authentication credentials to use when making HTTP requests for information from the endpoint/application.

An example of use for HTTP endpoints could be integrating a web app which provides address information into your WorkPoint process. In Denmark, "Dataforsyningen" provides such a service. Their API is located at https://api.dataforsyningen.dk/adresser and can provide address information when provided with a set of search queries. Required and/or optional search queries which can be passed to the endpoint can typically be found in the API documentation of the endpoint you are trying to access.

2. Requirements

License requirement information is coming soon.

3. Configuration

Note that configuration of HTTP endpoints require that you have access to an API from which you can retrieve information.

   3.1. Accessing the Http Endpoint Library

HTTP Endpoints are configured in the WorkPoint 365 Administration:

WorkPoint365 Administration - Google Chrome
  1. In the left side panel of the WorkPoint 365 Administration, click "Http Endpoint Library".

This opens the Http Endpoint Library page:

Http Endpoint Library - Google Chrome

   3.2. Adding a new Http Endpoint

In the following steps, we will configure a new Http Endpoint to be used in our WorkPoint Processes.

Http Endpoint Library - Google Chrome
  1. To add a new Http endpoint, click the "Add" button.
  1. A title for the Http endpoint is required.
  2. For "Parameters" you can add parameters which can be passed to the endpoint API. Based on the parameters, the API will return output data. Note that some APIs require specific paramters be
  3. Check or uncheck the "Active" checkbox to enable or disable the Http endpoint. Only enabled Http endpoints can be used in processes.
  4. In the "URL" field, paste the URL to the Http endpoint you want to retrieve information from.
  5. In the Http(s) endpoint action field, you can select which type of Http action you wish to perform. Available options are:
    • Delete: Used to delete an item in database
    • Get: Used to retrieve an item from a database
    • Post: Used to create a new item in a database
    • Put: Used to edit an item in a database
  6. HTTP headers let the client and the server pass additional information with an HTTP request or response. Headers consist of Key and Value pairs. White space before the Value is ignored. Visit this article for more information about HTTP headers.
  7. In the "Query" section, you can add queries to be passed through the Http request to the API. Note that APIs may require specific queries be passed when calling them. Check your API's documentation for any required queries.
  8. In the "Body" field, you can type in a request for the API you are calling. This option is only available if you have selected either "Post" or "Put" as your Http(s) endpoint action.
  9. In the "Media type" field, you can select which type of data you are expecting to get back from the API. Examples could be "application.json" for json data or "text/xml" for xml data.
  10. If the API you are calling requires authentication before it can be used, you can select your configured credentials in the "Credentials" field. Authorizations/credentials are configured in the Http Endpoint Library.
  11. In the "Test" field you can test your query against the API using the parameters you have provided in step 2. If your configuration is valid, you should see a response from the API giving you some data, which is then displayed in the window above the test button.
  12. In the "Schema" field you can input the organization or structure for the database you access with the API. The schema defines the structure of data in the database, and  can be generated automatically from a test result, if you have previously run a test which resulted in a successful response from the API. Note that you should always run another test after automatically generating the schema to ensure that it was generated correctly.
  13. To save the Http endpoint configuration and add it to your Http Endpoint Library, click the "Add" button.

   3.3. Example configuration

Visit this article for an example configuration of a Http endpoint in WorkPoint.

   3.4. Using Http endpoint in a WorkPoint process

Visit this article for a guide on how to implement Http endpoints in WorkPoint processes.

   3.5. Using WorkPoint processes with Http endpoints

Visit this article for a guide on how to use WorkPoint processes which uses Http endpoints.

Have more questions? Submit a request