EPISHIP API Job States overview

EPISHIP Job States API icon 32px svg

Overview

Figure 1. EPISHIP API relationship diagram. Asynchronous job execution and status polling flow.

EPISHIP App

EPISHIP’s interface utilizes job states to provide user feedback for tasks that are not instantaneous. This allows users to initiate a heavy operation (like a large report export) and continue working while the system processes the request in the background.

EPISHIP API

The REST API that exposes the status, progress, and metadata of background jobs. It allows client applications to poll for updates and attempt to cancel jobs that are pending or in progress.

Authentication

Secured via Bearer tokens. Access to job states is restricted to the user or company that initiated the job, ensuring that sensitive operational data remains private.

Job Lifecycle

Jobs transition through various states such as `queued`, `processing`, `completed`, or `failed`. The API provides detailed timestamps (`executed_at`, `finished_at`) and progress percentages to accurately reflect the job’s current standing.

What can users do with the EPISHIP Job States API?

Users can use the EPISHIP Job States API to perform common workflows, such as:

Job State properties available to view and filter through the EPISHIP Job States API:

Additional info

Related

Related Categories