Help: COVE API User's Guide: Version Information

In future versions of the COVE API, the default base URL will always point to the most recent version, and older versions may be depreciated. If COVE API endpoints are integrated into custom applications, please use the versioned URL. Users may refer to this document for version information or by sending a request to the request URL below.

COVE API details:
  • Current version: v1_2
  • Supported versions: v1_0, v1_1, v1_2
  • Depricated versions: None
  • Revision history:
    v1_1:
    • Added calculate_solar_angles option to acquisition forecaster task.
    • Added endpoints to create constellations (archived and forecasted).
    • Added options to PNG requests:
      • line_width: in Acquisition Forecaster, Data Browser, and Regions
      • line_color: in Regions
      • transparent: in Acquisition Forecaster, Coverage Analyzer, Coincident Calculator, Revisits Calculator, Data Browser, and Regions
      • transparency: in Coverage Analyzer, Coincident Calculator, Revisits Calculator
      • resolution: in Acquisition Forecaster, Coverage Analyzer, Coincident Calculator, Revisits Calculator, Data Browser, and Regions
      • show_region_outline: in Acquisition Forecaster, Coverage Analyzer, Coincident Calculator, Revisits Calculator, and Data Browser
      • map_coordinates: in Acquisition Forecaster, Coverage Analyzer, Coincident Calculator, Revisits Calculator, Data Browser, and Regions
    • Added extended option to CSV requests in Acquisition Forecaster, Revisits Calculator, and Data Browser.
  • v1_2:
    • Updated utilities to use GET requests instead of POST.
  • Default base url: https://ceos-cove.org/en/api/
  • Versioned base url: https://ceos-cove.org/en/api/v1_2/
 
Revisits Calculator throttle limits:
  • POST: 15 requests per hour
  • GET: 120 requests per hour
 

Retrieve version details

Request Method: GET

Request URL:
https://ceos-cove.org/en/api/

URL Parameters: None

Response Example:
{
"current_version": "<CURRENT VERSION>",
"default_version": "<CURRENT VERSION>",
"supported_versions": [
"<CURRENT VERSION>",
"<OLDER VERSION>"
],
"deprecated_versions": [
{
"<DEPRECATED VERSION>": "<DEPRECATION DATE>"
}
],
"revision_history": {
"<VERSION>": [
<DETAILS STRING>
]
}
}
 

Example API requests using curl

Version information:
curl -H "Accept: application/json; indent=4" -u username:password https://ceos-cove.org/en/api/