Download the voting report 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. Get authorization data from the BX24 library
            const auth = BX24.getAuth();
            if (!auth)
            {
                return;
            }
        
            // 2. Form the URL for the direct request to the 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(`Download request: ${restUrl}`);
        
            // 3. Execute the request and process the response as a binary file (blob)
            fetch(restUrl)
                .then(response => {
                    if (!response.ok)
                    {
                        // If the request failed, try to process the standard JSON error from Bitrix24
                        return response.json().catch(() => {
                            // If the response body is not JSON, throw a general network error
                            throw new Error(`Network error: ${response.status} ${response.statusText}`);
                        }).then(errorData => {
                            // If able to parse the JSON error
                            throw new Error(`API error: ${errorData.error_description || 'Unknown error'}`);
                        });
                    }
                    // On success, get the data as a binary object
                    return response.blob();
                })
                .then(blob => {
                    // 4. Create an "invisible" link and initiate the download in the browser
                    const url = window.URL.createObjectURL(blob);
                    const a = document.createElement('a');
                    a.style.display = 'none';
                    a.href = url;
                    
                    // Set the file name that the user will see
                    a.download = `vote_report_${attachId}.${fileType}`;
                    
                    document.body.appendChild(a);
                    a.click();
                    
                    // Clean up temporary data
                    window.URL.revokeObjectURL(url);
                    document.body.removeChild(a);
                })
                .catch(error => {
                    console.error('Error downloading the report:', error);
                    alert(`Failed to download the report: ${error.message}`);
                });
        }
        

<?php
        // This file usually contains constants for connection or autoloader settings
        require_once('src/crest.php');
        
        /**
        * Function to download the report using a direct HTTP request,
        * since the method vote.AttachedVote.download returns not JSON, but the content of the file.
        *
        * @param array $params - Parameters for the REST method (e.g., ['attachId' => 1])
        */
        function downloadVoteReport(array $params, string $saveToFile): bool
        {
            // 1. Get authorization settings. 
            // CRest::getAppSettings() will return either data for OAuth or for webhook.
            // In crest.php, change the access modifier to public for this method
            $authData = CRest::getAppSettings();
        
            if (empty($authData)) {
                echo "Error: failed to get authorization settings. Check crest.php/settings.php.\n";
                return false;
            }
        
            // 2. Define the URL for the request
            if (!empty($authData['is_web_hook']) && $authData['is_web_hook'] === 'Y') {
                // Case with webhook
                $url = $authData['client_endpoint'] . 'vote.AttachedVote.download';
                $queryParams = $params;
            } else {
                // Case with OAuth application
                $url = $authData['client_endpoint'] . 'vote.AttachedVote.download';
                $params['auth'] = $authData['access_token'];
                $queryParams = $params;
            }
        
            $url .= '?' . http_build_query($queryParams);
            echo "Request URL: " . $url . "\n";
        
            // 3. Execute the request using cURL
            $curl = curl_init();
            curl_setopt_array($curl, [
                CURLOPT_URL => $url,
                CURLOPT_HEADER => false,        // Do not include headers in the response
                CURLOPT_RETURNTRANSFER => true, // Return the response as a string, not output to the browser
                CURLOPT_USERAGENT => 'CRest based downloader',
                CURLOPT_FOLLOWLOCATION => true, // Follow redirects
            ]);
        
            $response = curl_exec($curl);
            $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
            $error = curl_error($curl);
            curl_close($curl);
        
            // 4. Check the result and save the file
            if ($error) {
                echo "cURL error: " . $error . "\n";
                return false;
            }
        
            if ($httpCode >= 400) {
                echo "Server returned HTTP error " . $httpCode . ".\n";
                // Attempt to decode the error if it's in JSON format
                $errorData = json_decode($response, true);
                if ($errorData && isset($errorData['error_description'])) {
                    echo "Error description: " . $errorData['error_description'] . "\n";
                } else {
                    echo "Response body: " . $response . "\n";
                }
                return false;
            }
            
            // If all is well, save the response to a file
            if (file_put_contents($saveToFile, $response)) {
                echo "File successfully saved to: " . $saveToFile . "\n";
                return true;
            } else {
                echo "Failed to save file to: " . $saveToFile . "\n";
                return false;
            }
        }
        
        
        // --- Example usage ---
        
        $attachId = 1;
        $fileType = 'xls';
        $fileName = "vote_report_{$attachId}.{$fileType}";
        
        $result = downloadVoteReport(
            [
                'attachId' => $attachId,
            ],
            $fileName
        );
        
        if ($result) {
            echo "Task completed.\n";
        } else {
            echo "Errors occurred during execution.\n";
        }