Retrieving Jobs
less than a minute
When building a provider connector, there are two options for retrieving new jobs for processing:
- Polling
- Listeners - aka webhooks.
Polling is suitable for use cases where the number of providers is low, as it requires polling each provider individually.
Using listeners allows the connector to respond to job and asset task events for one or more providers, but requires a publicly accessible endpoint.
Polling
Method: GET /providers/{providerId}/jobs/findByStatus?status=SENDING_READY_FOR_RETRIEVE
The process begins by polling for new jobs that are ready to be translated, by using the method with the status set to SENDING_READY_FOR_RETRIEVE. For each jobId returned, process the job.
Listeners (Preview)
For more on getting new jobs using listeners, see New job submission section under Events