JSON API

Job Tracking

4min

Overview

The Indexing Job Tracking API is designed to monitor and manage the progress of jobs related to batch processing. These APIs allow users to track the status of jobs as they move through different stages: DONE, PROCESSING, and INITIALIZING.

Key features of the API include:

  • Job Status
    • Retrieve the current state of the job, helping to understand whether a job is completed (DONE), still in progress (PROCESSING), or just beginning (INITIALIZING).
  • Timestamps
    Access each job's start and end times, providing a timeline for tracking the job's execution duration.
  • Document Management: Manage documents involved in the job, including:
    • Docs in Request
      The documents submitted in the job request.
    • Docs Affected
      Documents that are impacted due to operations like inheritance, category updates.
    • Docs Completed
      Track the document IDs of those that have successfully completed processing.

Schema (Response)

JSON


Understanding the response parameters

apiKey

This is the store's JS API Key. It can be obtained using link

jobId

The unique ID represents an individual job.

docsInRequest

Originally received document id as part of user actions.

docsAffected

All the document id which is going to be affected by user action eg. if we are updating the category name and it will affect 20 documents that is attached to that category, the service will get those 20 document IDs as affected documents.

docsCompleted

All document IDs that are successfully cleared from the processing.

jobType

Indicates the type of job submitted.

status

The status of the job, at the moment, we support three statuses. Here are the details: INITIALIZING - the job was accepted and is queued for processing. PROCESSING - Job is progressing through the system and Search is getting updated. DONE - Job is complete and all affected documents are updated on Search.

startTime

The timestamp when the job was initiated.

endTime

when status is changed to DONE, the system will use the timestamp to set this attribute in schema, it will determine at which time all documents were completed from the job.

API Specifications

Please refer to Job tracking section of Swagger/OpenAPI Specification