Articles in this section

See more

Datastreams: Triggering a Fetch

Avatar
Adverity Pre-Sales
  • Updated
Follow

As in the UI, Fetches for a Datastream can be triggered through the API. There are 2 options:

  1. Trigger a single fetch job.
  2. Prompt multiple fetch jobs according to configured time range
The following parameters are required:
  • START: The start timestamp of the time window to fetch, in UTC.
  • END: The end timestamp for the time window, in UTC.
The following parameters are optional:
  • FORCE: Pass true if existing extracts should be re-fetched.
  • CALLBACK: You can pass a URL that will be called once the fetch has been completed (with a GET {callback}).

 

Trigger One Fetch Within a Specified Time Range

(Equivalent to "Run a single fetch" in the UI)

Use api/datastreams/DATASTREAM_ID/fetch_fixed/ .

curl -X POST \
 https://YOUR_STACK.datatap.adverity.com/api/datastreams/DATASTREAM_ID/fetch_fixed/ \
 -H 'Authorization: Token TOKEN_VALUE' \
 -H 'Content-Type: application/json' \
 -d '{"start":"YYYY-MM-DDTHH:MM:SSZ","end":"YYYY-MM-DDTHH:MM:SSZ"}'

Result

{
 "status": "ok",
 "start": "YYYY-MM-DDTHH:MM:SSZ",
 "message": "Fetch scheduled.",
 "end": "YYYY-MM-DDTHH:MM:SSZ"
}

 

Prompt Multiple Fetch Jobs According to Configured Time Range

(Equivalent to "Reschedule fetches" in the UI)

Use api/datastreams/DATASTREAM_ID/fetch/.
curl -X POST \
 https://YOUR_STACK.datatap.adverity.com/api/datastreams/DATASTREAM_ID/fetch/ \ 
 -H 'Authorization: Token TOKEN_VALUE' \
 -H 'Content-Type: application/json' \
 -d '{"start":"YYYY-MM-DDTHH:MM:SSZ","end":"YYYY-MM-DDTHH:MM:SSZ", "force":"false", "callback":"https://CALLBACK_URL"}'
Note: When including the CALLBACK parameter, it must be a valid callback URL, otherwise an error will be returned. The callback contains several parameters providing information like the extract state, file name and file size.

Related articles

Comments

0 comments

Article is closed for comments.