Get a task - Extole Documentation

Get a task

curl --request GET \
  --url https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "component_ids": [
    "<string>"
  ],
  "component_references": [
    {
      "component_id": "<string>",
      "socket_names": [
        "<string>"
      ]
    }
  ],
  "id": "<string>",
  "order": 123,
  "parent_job_id": "<string>",
  "task_type": "FILE_HEADER_VALIDATOR",
  "expected_headers": [
    "<string>"
  ],
  "match_mode": "EXACT_SET",
  "on_mismatch": "FAIL"
}

GET

/

v6

/

jobs

/

{jobId}

/

tasks

/

{taskId}

Get a task

curl --request GET \
  --url https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId} \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.extole.io/v6/jobs/{jobId}/tasks/{taskId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "component_ids": [
    "<string>"
  ],
  "component_references": [
    {
      "component_id": "<string>",
      "socket_names": [
        "<string>"
      ]
    }
  ],
  "id": "<string>",
  "order": 123,
  "parent_job_id": "<string>",
  "task_type": "FILE_HEADER_VALIDATOR",
  "expected_headers": [
    "<string>"
  ],
  "match_mode": "EXACT_SET",
  "on_mismatch": "FAIL"
}

Authorizations

Authorization

string

header

required

Path Parameters

jobId

string

required

The unique identifier of the job that owns the task. Use the reserved value unattached to address tasks that are not attached to any job, which happens when a component defines a task whose parent_job_id expression evaluates to nothing.

taskId

string

required

Response

Successful response

Option 1
Option 2
Option 3

Stored task definition. Field order is unevaluated and appears in buildtime-evaluatable form.

component_ids

string[]

required

component_references

object[]

required

Show child attributes

id

string

required

read-only

Unique id of the task.

order

required

Position of this task in the job, as the buildtime expression or literal that was saved. Re-evaluated on campaign publish to determine the task's resolved execution order. Buildtime expressions use JobBuildtimeContext.

parent_job_id

required

Id of the job this task belongs to, as the buildtime expression or literal that was saved. Buildtime expressions use JobBuildtimeContext.

task_type

enum<string>

required

Available options:

FILE_HEADER_VALIDATOR

expected_headers

required

Headers the validated file is expected to contain. A literal value or a buildtime expression resolved from component references when the task is saved. Buildtime expressions use JobBuildtimeContext.

Headers the validated file is expected to contain. A literal value or a buildtime expression resolved from component references when the task is saved.

match_mode

enum<string>

required

Available options:

EXACT_SET,

ORDERED,

SUBSET

on_mismatch

required

Action taken when the headers do not match. A literal value or a buildtime expression resolved from component references when the task is saved. Buildtime expressions use JobBuildtimeContext.

Available options:

FAIL,

WARN

⌘I