Retrieve the product task status (synchronous API)

Get the latest information for a product task

get

Get the latest product information for an asynchronous task. You can find the taskId in the response when you send a request to create or update product.

Authorizations
Path parameters
taskIdstringRequired

The task identifier received in the response when you create or update a product (synchronous API).

Responses
200
Successful response.
application/json
get
GET /v1/products/tasks/{taskId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*
{
  "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
  "receivedTime": "2022-05-01T23:00:21.123Z",
  "finishedTime": "2022-05-01T23:05:21.123Z",
  "taskStatus": "PUBLISHED",
  "requestType": "CREATE_PRODUCT",
  "products": [
    {
      "productId": "text",
      "externalReferenceId": "text",
      "productType": "text"
    }
  ],
  "errors": [
    {
      "errorCode": "text",
      "description": "text"
    }
  ],
  "deploymentErrors": [
    {
      "errorCode": "text",
      "description": "text"
    }
  ],
  "deploymentWarnings": [
    {
      "errorCode": "text",
      "description": "text"
    }
  ]
}

Retrieve the tasks for Product Admin API requests

get

Retrieve the tasks for Product Admin API requests. Specify the conditions using the query parameters to filter your query.

Authorizations
Query parameters
productIdstringOptional

The product identifier or external reference identifier associated with the related tasks.

Default: null
taskStatusstringOptional

comma separated status

Default: PUBLISHED,PROCESSING,COMPLETED,FAILEDExample: PUBLISHED
beginReceivedTimestringOptional

The date and time when the the task received time began.

Default: The current system date time minus 30 days.Example: 2022-05-01T23:00:21.123Z
endReceivedTimestringOptional

The date and time when the task ended.

Default: The current system date time.Example: 2022-05-30T23:00:21.123Z
limitinteger · min: 1 · max: 50Optional

The maximum number of tasks returned with this request.

Default: 50Example: 50
startingAfterstringOptional

When you specify a task identifier, the system will fetch the tasks that started later than the current task. Use either startingAfter or endingBefore. Do not use them togehter.

Default: null
endingBeforestringOptional

When you specify a task identifier, system will fetch the tasks that started earlier than current the task. Use either startingAfter or endingBefore. Do not use them togehter.

Default: null
Responses
200
Successful response.
application/json
get
GET /v1/products/tasks/ HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
Accept: */*
{
  "tasks": [
    {
      "taskId": "d8a81162-aaaa-bbbb-cccc-ea513d1afa82",
      "receivedTime": "2022-05-01T23:00:21.123Z",
      "finishedTime": "2022-05-01T23:05:21.123Z",
      "taskStatus": "PUBLISHED",
      "requestType": "CREATE_PRODUCT",
      "products": [
        {
          "productId": "text",
          "externalReferenceId": "text",
          "productType": "text"
        }
      ],
      "uri": "https://api.digitalriver.com/v1/products/tasks/d8a81162-aaaa-bbbb-cccc-ea513d1afa82"
    }
  ],
  "totalSize": 1,
  "previousPage": {
    "endingBefore": "zzzzzzzz-aaaa-bbbb-cccc-ea513d1afa82"
  },
  "nextPage": {
    "startingAfter": "aaaaaaaa-aaaa-bbbb-cccc-ea513d1afa82"
  },
  "searchCriteria": {
    "beginReceivedTime": "2022-05-01T23:00:21.123Z",
    "endReceivedTime": "2022-05-31T23:00:21.123Z",
    "taskStatus": [
      "PUBLISHED"
    ],
    "productId": "1234567800"
  },
  "pagination": {
    "limit": 50,
    "startingAfter": "aaaaaaaa-aaaa-bbbb-cccc-ea513d1afa82",
    "endingBefore": "zzzzzzzz-aaaa-bbbb-cccc-ea513d1afa82"
  }
}

Last updated