# Хранилище Файлов

Сервис хранения файлов предназначен для загрузки и хранения файлов на серверах Наложки для последующего использования в Сделках.

Прежде чем прикрепить файл к Сделке, необходимо загрузить его в данный сервис, получить идентификатор файла, и потом уже использовать этот идентификатор в API Безопасных Сделок.

Загрузка файлов может осуществляться как с сервера, так и с компьютера пользователя (из браузера).

Так как сервис требует аутентификации запроса пользователя, загрузка файлов в хранилище из браузера делается следующим образом: сервером через API запрашивается токен временного доступа (см. POST /temporary-access-token), полученный токен добавляется в URL отправки формы как параметр temporary_access_token. В документации API указаны ограничения использования токена временного доступа.

Например, запросим токен временного доступа из консоли:

# Запрос токена временного доступа
curl -sX POST "https://filestorage.api.nalozhka.ru/temporary-access-token" \
     -H "accept: application/json" \
     -H "X-Nalogka-Auth-Token: wGUe0orXdj8yWeBZhWLeHa4jNPbSvVoP" \
     -H "Content-Type: application/json" \
     -d '{"endpoint": "POST /form-upload"}'

И далее используем полученный в предыдущем запросе токен при отрисовке формы:

<form   id="smartForm"
        action="https://filestorage.api.nalozhka.ru/form-upload?temporary_access_token=PJ5CkHcngfVYz0G5AhBtQCtCSJt2hmaIok"
        method="POST"
        enctype="multipart/form-data">
    <div class="form-control">
        <label>Файл:</label>
        <input name="file[0]" type="file"/>
    </div>
    <div class="form-control">
        <label>Описание:</label>
        <input name="description[0]" type="text"/>
    </div>
    <div class="form-footer">
        <input type="submit" value="Загрузить файл" name="submit"/>
    </div>
</form>

Для работы с API Хранилища Файлов используются следующие адреса:

Ниже приведены доступные методы API с подробным пояснением: