Call an HTTP Service (APIs, Rest)

HTTP task allows you to make calls to remote services exposed over HTTP/HTTPS.

Definitions

   {
       "name": "http_task",
       "taskReferenceName": "http_task_ref",
       "type" : "HTTP",
       "inputParameters": {
           "uri": "https://catfact.ninja/fact",
           "method": "GET",
           "connectionTimeOut": 3000,
           "readTimeOut": 3000
       }
   }

Input Parameters

Attribute	Description
uri	Provide the URI for the service. It can be a partial value when using vipAddress or it can be the server address.
method	Choose the HTTP method. Conductor supports the methods: GET, HEAD, POST, PUT, PATCH, DELETE, and OPTIONS
accept	Provide the accept header as required by the server. By default, it is set to application/json.
contentType	Provide the content type for the server. The supported types are text/plain, text/html, and application/json. By default, it is set to application/json.
headers	A map of additional http headers to be sent along with the request.
body	Request body when using POST or PUT.
asyncComplete	If set, the task remains in the IN_PROGRESS state even after the execution. An external event (Task Update API or Event handler) is expected to mark the task as completed.
connectionTimeOut	Set the connection timeout in milliseconds. If set to 0, it is equivalent to infinity. By default, the value is set to 100.
readTimeOut	Set the read timeout in milliseconds. If set to 0, it is equivalent to infinity. By default, the value is set to 150.

Output Parameters

Attribute	Description
response	JSON body containing the response if present.
headers	Response Headers.
statusCode	HTTP Status Code.
reasonPhrase	HTTP Status Code's reason phrase.

Examples

UI

1. Add task type HTTP.
2. Configure the API by choosing method, endpoint, headers etc.

JSON Example

    {
      "name": "http_task",
      "taskReferenceName": "http_task_ref",
      "type": "HTTP",
      "inputParameters": {
        "http_request": {
          "uri": "https://orkes-api-tester.orkesconductor.com/api",
          "method": "POST",
          "connectionTimeOut": 3000,
          "readTimeOut": "3000",
          "accept": "application/json",
          "contentType": "application/json",
          "body": "${workflow.input.httpPayload}"
        }
      }
    }

Send a POST Request

    {
      "name": "http_post_example",
      "taskReferenceName": "post_example",
      "inputParameters": {
        "http_request": {
          "uri": "https://jsonplaceholder.typicode.com/posts/",
          "method": "POST",
          "body": {
            "title": "${get_example.output.response.body.title}",
            "userId": "${get_example.output.response.body.userId}",
            "action": "doSomething"
          }
        }
      },
      "type": "HTTP"
    }

Set Read and Connect Timeouts for HTTP requests

    {
      "name": "http_post_example",
      "taskReferenceName": "post_example",
      "inputParameters": {
        "http_request": {
          "uri": "https://jsonplaceholder.typicode.com/posts/",
          "method": "POST",
          "readTimeout": 60000,
          "connectionTimeout": 60000,
          "body": {
            "title": "${get_example.output.response.body.title}",
            "userId": "${get_example.output.response.body.userId}",
            "action": "doSomething"
          }
        }
      },
      "type": "HTTP"
    }