vote.AttachedVote.download

curl -X POST \
-L \
-o **put_file_name**.xls \
-H "Content-Type: application/json" \
-d '{"attachId":**put_attach_id**, "auth": "**put_access_token_here**"}' \
"https://**put_your_bitrix24_address**/rest/vote.AttachedVote.download"

function downloadVoteReportById(attachId)
{
    // 1. Получаем данные для авторизации из библиотеки BX24
    const auth = BX24.getAuth();
    if (!auth)
    {
        return;
    }

    // 2. Формируем URL для прямого запроса к REST API
    const restUrl = new URL(`https://${auth.domain}/rest/vote.AttachedVote.download`);
    restUrl.searchParams.append('auth', auth.access_token);
    restUrl.searchParams.append('attachId', attachId);

    console.log(`Запрос на скачивание: ${restUrl}`);

    // 3. Выполняем запрос и обрабатываем ответ как бинарный файл (blob)
    fetch(restUrl)
        .then(response => {
            if (!response.ok)
            {
                // Если запрос не прошел, пытаемся обработать стандартную JSON-ошибку Bitrix24
                return response.json().catch(() => {
                    // Если тело ответа - не JSON, выбрасываем общую сетевую ошибку
                    throw new Error(`Сетевая ошибка: ${response.status} ${response.statusText}`);
                }).then(errorData => {
                    // Если удалось распарсить JSON-ошибку
                    throw new Error(`Ошибка API: ${errorData.error_description || 'Неизвестная ошибка'}`);
                });
            }
            // В случае успеха получаем данные как бинарный объект
            return response.blob();
        })
        .then(blob => {
            // 4. Создаем "невидимую" ссылку и инициируем скачивание в браузере
            const url = window.URL.createObjectURL(blob);
            const a = document.createElement('a');
            a.style.display = 'none';
            a.href = url;
            
            // Задаем имя файла, которое увидит пользователь
            a.download = `vote_report_${attachId}.${fileType}`;
            
            document.body.appendChild(a);
            a.click();
            
            // Очищаем временные данные
            window.URL.revokeObjectURL(url);
            document.body.removeChild(a);
        })
        .catch(error => {
            console.error('Ошибка при скачивании отчета:', error);
            alert(`Не удалось скачать отчет: ${error.message}`);
        });
}

<?php
// Этот файл обычно содержит константы для подключения или настройки автозагрузчика
require_once('src/crest.php');

/**
* Функция для скачивания отчета с помощью прямого HTTP-запроса,
* так как метод vote.AttachedVote.download возвращает не JSON, а содержимое файла.
*
* @param array $params - Параметры REST-метода (например, ['attachId' => 1])
*/
function downloadVoteReport(array $params, string $saveToFile): bool
{
    // 1. Получаем настройки авторизации. 
    // CRest::getAppSettings() вернет либо данные для OAuth, либо для вебхука.
    // В самом crest.php меняем модификатор доступа на public для этого метода
    $authData = CRest::getAppSettings();

    if (empty($authData)) {
        echo "Ошибка: не удалось получить настройки авторизации. Проверьте crest.php/settings.php.\n";
        return false;
    }

    // 2. Определяем URL для запроса
    if (!empty($authData['is_web_hook']) && $authData['is_web_hook'] === 'Y') {
        // Случай с вебхуком
        $url = $authData['client_endpoint'] . 'vote.AttachedVote.download';
        $queryParams = $params;
    } else {
        // Случай с OAuth-приложением
        $url = $authData['client_endpoint'] . 'vote.AttachedVote.download';
        $params['auth'] = $authData['access_token'];
        $queryParams = $params;
    }

    $url .= '?' . http_build_query($queryParams);
    echo "URL запроса: " . $url . "\n";

    // 3. Выполняем запрос с помощью cURL
    $curl = curl_init();
    curl_setopt_array($curl, [
        CURLOPT_URL => $url,
        CURLOPT_HEADER => false,        // Не включать заголовки в ответ
        CURLOPT_RETURNTRANSFER => true, // Вернуть ответ в виде строки, а не выводить в браузер
        CURLOPT_USERAGENT => 'CRest based downloader',
        CURLOPT_FOLLOWLOCATION => true, // Следовать за редиректами
    ]);

    $response = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    $error = curl_error($curl);
    curl_close($curl);

    // 4. Проверяем результат и сохраняем файл
    if ($error) {
        echo "Ошибка cURL: " . $error . "\n";
        return false;
    }

    if ($httpCode >= 400) {
        echo "Сервер вернул ошибку HTTP " . $httpCode . ".\n";
        // Попытка декодировать ошибку, если она в формате JSON
        $errorData = json_decode($response, true);
        if ($errorData && isset($errorData['error_description'])) {
            echo "Описание ошибки: " . $errorData['error_description'] . "\n";
        } else {
            echo "Тело ответа: " . $response . "\n";
        }
        return false;
    }
    
    // Если все хорошо, сохраняем ответ в файл
    if (file_put_contents($saveToFile, $response)) {
        echo "Файл успешно сохранен в: " . $saveToFile . "\n";
        return true;
    } else {
        echo "Не удалось сохранить файл в: " . $saveToFile . "\n";
        return false;
    }
}

// --- Пример использования ---

$attachId = 1;
$fileType = 'xls';
$fileName = "vote_report_{$attachId}.{$fileType}";

$result = downloadVoteReport(
    [
        'attachId' => $attachId,
    ],
    $fileName
);

if ($result) {
    echo "Задание выполнено.\n";
} else {
    echo "Во время выполнения произошли ошибки.\n";
}