Files

📥 Download file / preview

Скачивание файла или превью. Сессия - с доказательством владения ею, один ID сессии доступа не даёт: подпись (sid + rts + sig), sid + fileToken или кука fsid. sid без доказательства принимается, только если совпадает с кукой. Нет доказательства или неверный ключ - 401, неверная подпись - 403.

Location config: api.commonLocations.baseFilesAccess = file.

Ответ: binary stream / redirect на signed URL (S3).

get/file

Request

  • Base URL: http://localhost
  • URL: http://localhost/file
  • Auth: one of:
    • API key in header sid and API key in header rts and API key in header sig
    • API key in header sid and API key in query parameter fileToken
    • API key in cookie fsid

Query parameters

sidstring uuid

ID сессии - вместе с доказательством: подписью (rts, sig) или fileToken. Без sid сессия берётся из куки fsid

fileTokenstring

Ключ отдачи файлов сессии (см. схему FileToken) - клиентам вне сайта API, куда кука fsid не доходит

fidstring uuid required

File ID

mode'icon' | 'preview' | 'data'

icon | preview | data (default: original)

Headers

devIDstring uuid required

UUID устройства клиента

tzstring required
Example:Europe/Moscow

Таймзона клиента (IANA или offset)

appstring required
Example:kosmodrom-web

Имя клиентского приложения

appVerstring required
Example:1.0.0

Версия клиента

Response

File bytes

Changes

No recorded changes to this operation across all 1 revision of this API.