The Committee on Earth Observation Satellites (CEOS) Visualization Environment (COVE) application programming interface (API) is a suite of endpoints for executing tasks and retrieving results for a collection of COVE tools.
All tasks created using the COVE API will be available in the COVE UI, and all tasks created in the COVE UI will be available in the COVE API.
A valid COVE username and password are required for all requests. A COVE login may be created in the COVE UI by clicking on the Log In/Register ling in the upper right corner.
COVE tool API sets are throttled to help reduce system overload. Throttle limits are subject to change if the need arises. The throttle limits will be detailed in each tool section below, and will be updated in this document as changes are made.
To submit a request to the service, include the appropriate JSON payload in the body of a POST request for the endpoint. Requests should include the trailing slash in the url. Examples using curl with each type of request are provided in each section below.
All responses will either be a JSON response or a binary file. All failed responses will be in JSON format, and will include a status (standard HTTP status code).
Execution start in all task status responses are in UTC time.
For CSV files, use unicode UTF-8.
Please refer to the COVE UI User's Guide for more information on the usage of each COVE tools.
The following COVE tools are accessible from the COVE API:
Other COVE API endpoints included in this document are: