Make Download URL

Generate a presigned URL to download data associated with a channel later or independently of the SIE Batch webserver. Generated URLs are shareable and do not reveal credentials. The seconds portion of start/end times are ignored.

The requested start_time/end_time must fall within the channel's data retention window. Use chdetails to check the earliest and latest timestamps before generating a URL. The makeurl call itself succeeds even if the requested range extends beyond available data — the error occurs when downloading from the returned URL:

  • 404 (NoSuchKey): The requested data range is outside the channel's retention window.
  • 403 (Unable to authenticate): The generated URL has expired. Generate a new URL with makeurl.
post/siebatchd/v1/siebatch/makeurl

Request

Request body

apikeystring password required

Your Farsight SIE Batch API Key (UUID format)

channelinteger required

Channel number (1-255)

start_timestring required

Start date in "YYYY-MM-DD HH:MM:SS" format (UTC)

end_timestring required

End date in "YYYY-MM-DD HH:MM:SS" format (UTC)

Example request

{
  "apikey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "channel": 213,
  "start_time": "2020-01-28 12:00:00",
  "end_time": "2020-01-28 12:01:00"
}

Response

Presigned download URL generated successfully.

_status'OK'
_messagestring
urlstring uri

Presigned shareable URL to the specified SIE data

Changes

No recorded changes to this operation across all 1 revision of this API.