API загрузки данных

Все действия с файлами требуют токена API, который подтвержденные пользователи могут сгенерировать и отозвать в личном кабинете.

Для скачивания необходимо знать один из двух уникальных идентификаторов: полный путь к файлу на сервере или id файла в базе данных.

Первый шаг - получение временной ссылки на файл по идентификатору; для этого нужно выполнить POST-запрос, например, с помощью curl.

Запрос с указанием id

curl 'https://climdat.inm.ras.ru/api/v0/create_link' \
  -X POST \
  -H 'Content-Type: application/json' \
  --data-raw '{"file_id":15765,"token":"INSERT TOKEN HERE"}'

Запрос с указанием пути файла

curl 'https://climdat.inm.ras.ru/api/v0/create_link' \
  -X POST \
  -H 'Content-Type: application/json' \
  --data-raw '{"file":"/home/climate-data/21K/so_lgm_INMCM48.ctl","token":"..."}'

Ответ сервера

Если валидация токена прошла успешно, сервер возвращает временную ссылку на файл:

{"address":"https://climdat.inm.ras.ru/api/download/0000001716298675rf....",
 "filename":"21K_so_lgm_INMCM48.ctl",
 "status":"ok"}

Если же токен истек или не существует, сервер возвращает ошибку:

{"message":"Bad status code",
 "status":"error"}