Version 3.7
Released on 2023-07-06
This product can also be used via a Web API (application programming interface) for programmatically accessing the data by requesting specific URL-encoded parameters. The list of mandatory and optional variables for this specific product are included in tables 1 and 2 below:
Table 1: Mandatory parameters for API access to SPS images
|
Variable |
Values required for this product |
|
pc |
S017 |
|
psc |
a |
|
component |
latest | archive |
Table 2: Optional parameters that can be set to refine the query.
|
Variable |
Values |
|
dts_start |
yyyy-MM-ddTHH:mm:ssZ |
|
dts_end
|
yyyy-MM-ddTHH:mm:ssZ |
|
filetype |
jpg (default) | fits |
To access the latest data, the "component" parameter in the API URL should be set to "latest" (component=latest).
The URL is as follows: https://swesnet.asu.cas.cz/prod/API/index.php?component=latest&pc=S017&psc=a
returns JSON file with the link to the latest displayed jpg file.
To override the default settings, add the "filetype" parameter to obtain the image in a different format. For FITS files use "filetype=fits".
For example, the URL: https://swesnet.asu.cas.cz/prod/API/index.php?component=latest&pc=S017&psc=a&filetype=fits
returns JSON file with the link to the latest white light FITS file.
To access the archived data, the "component" parameter in the API URL should be set to "archive" (component=archive). The URL is as follows:
https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S017&psc=a
returns a JSON file containing a list of white light synoptic images in jpg format.
To override the default settings, the "component" parameter in the API URL should be set to "archive" (component=archive) and file type should be set to FITS (filetype=fits). The URL is as follows:
https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S017&psc=a&filetype=fits
returns a JSON file containing a list of white light synoptic images in FITS format.
In order to select a specific time range, the two parameters "dts_start" and "dts_end" need to be added, using the format yyyy-MM-ddTHH:mm:ssZ. For example, the URL:
https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S017&psc=a&dts_start=2023-01-01T00:00:00Z&dts_end=2023-01-31T23:59:59Z
returns a JSON containing links of all white light synoptic images in jpg format available from January 2023.
And for images in FITS format set "filetype=fits". For example, the URL:
https://swesnet.asu.cas.cz/prod/API/index.php?component=archive&pc=S017&psc=a&dts_start=2023-01-01T00:00:00Z&dts_end=2023-01-31T23:59:59Z&filetype=fits
returns a JSON containing links of all white light synoptic images FITS files available from January 2023.
The returned JSON includes the file URL and date modified.
JSON format for filetype=fits
{
"[file url]":{"time":[datetime]},
REPEAT
}
JSON format for filetype=jpg
{
"[file url]": {"time":[datetime]},
REPEAT
}
The archive is queryable back to 01 January 2022.