Download product file API

This page assumes you know how to authenticate your REST API requests

This section introduces you the API provided by REGARDS to download product files.

• Search products and files gives you the status of the file and where to download it.
• Download file to download

Search products and files

REGARDS offers many ways to search product, you can refer to product search guide.

A nearline product file - standard lucene search engine

{
  "id": "URN:FEATURE:DATA:tenant:50fe35a3-e085-3eb1-bb61-86ab3fdeb7dd:V3",
  "providerId": "DATA-06-20220613-2390",
  "entityType": "DATA",
  ...,
  "files": {
    "RAWDATA": [
      {
        "dataType": "RAWDATA",
        "reference": false,
        "uri": "https://regards.host.com/api/v1/rs-catalog/downloads/URN:FEATURE:DATA:tenant:50fe35a3-e085-3eb1-bb61-86ab3fdeb7dd:V3/files/BF39BC048B52618838529D9D98043190",
        "mimeType": "application/xml",
        "online": false,
        "checksum": "BF39BC048B52618838529D9D98043190",
        "digestAlgorithm": "MD5",
        "filesize": 190,
        "filename": "iso.xml",
        "types": []
      }
    ]
  }
}

On every product files returned by standard lucene search engine, you have an

• online attribute:
  • true means the file is always available, and you can download it without restore it.
  • false means the file is nearline, you need to check and restore product files when required first.
• reference attribute:
  • true means the file is provided by another service, external to REGARDS.
  • false means REGARDS provides an URI to download the product files.

Reference attribute and authentication

Tips : In the response, if reference value is true, authentication token is not needed, because file is not stored by REGARDS.

Differences between search engines

If you don't use the standard lucene search engine (like STAC or OpenSearch), the response does not contain the online and reference attribute.
It means you need to check and restore product files when required before trying to download.

Download file

The download product file endpoint requires the product URN and file checksum.
Download is possible only if:

• the file is available
• user has access right
• license of the dataset has been accepted (needed if license is not public)