Удаление подписей из подписанного PDF документа является распространённой задачей, когда требуется чистая копия для дальнейшей обработки или архивирования. GroupDocs.Signature Cloud SDK for Node.js предоставляет надёжную библиотеку, позволяющую программно управлять подписями PDF. В этом руководстве вы узнаете, как удалить все подписи из PDF с помощью Node.js, увидите полный пример кода и изучите эквивалентные команды cURL для REST API.

Удаление подписей из подписанного PDF‑документа в Node.JS за 5 шагов

Следующие шаги показывают, как удалить подписи из подписанного PDF‑документа с использованием GroupDocs.Signature Cloud SDK for Node.js.

  1. Инициализировать конфигурацию с учетными данными: Создайте объект Configuration, который хранит ваш client ID и secret.
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. Создать клиент API и экземпляр Signature API: Используйте конфигурацию для создания ApiClient, а затем SignatureApi.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. Определите информацию о исходном PDF-файле: Установите filePath PDF, который находится в хранилище GroupDocs.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. Подготовьте запрос на удаление с указанием пути вывода: Создайте DeleteSignaturesRequest, назначьте fileInfo и укажите, где следует сохранить результат.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. Выполнить запрос и обработать результат: Вызвать deleteSignatures и обработать ответ.
try {
    const result = await signatureApi.deleteSignatures(deleteRequest);
    console.log("All signatures removed successfully.");
    console.log("Result file stored at:", result.path);
} catch (err) {
    console.error("Failed to remove signatures:", err);
}

Для получения более подробной информации о каждом классе, обратитесь к Справочнику API.

Удалить все подписи из PDF - Полный пример кода

Следующий пример демонстрирует полный процесс удаления подписей из подписанного PDF‑документа.

const { Configuration, ApiClient, SignatureApi, DeleteSignaturesRequest, FileInfo } = require("@groupdocs/signature-cloud");

async function removeSignaturesFromPdf() {
    // Initialize configuration with your GroupDocs credentials
    const config = new Configuration({
        clientId: process.env.GROUPDOCS_CLIENT_ID,
        clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
    });

// Create API client and Signature API instance
    const apiClient = new ApiClient(config);
    const signatureApi = new SignatureApi(apiClient);

// Define source PDF file (must be already uploaded to GroupDocs storage)
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.pdf"; // path in GroupDocs storage

// Prepare request to delete all signatures and store result as a new file
    const deleteRequest = new DeleteSignaturesRequest();
    deleteRequest.fileInfo = fileInfo;
    deleteRequest.outputPath = "output.pdf"; // resulting file path in storage

try {
        const result = await signatureApi.deleteSignatures(deleteRequest);
        console.log("All signatures removed successfully.");
        console.log("Result file stored at:", result.path);
    } catch (err) {
        console.error("Failed to remove signatures:", err);
    }
}

removeSignaturesFromPdf();

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Удаление подписей PDF через REST API с использованием cURL

Ниже приведены команды cURL, которые выполняют ту же операцию через GroupDocs REST API.

  1. Аутентифицируйтесь и получите токен доступа
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Загрузите исходный PDF в хранилище GroupDocs
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @input.pdf
  1. Выполнить операцию удаления подписей
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/delete" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "outputPath": "output.pdf"
         }'
  1. Скачать полученный PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Для полного контракта API см. API Reference.

Подготовка среды

Установите библиотеку через npm и убедитесь, что ваша версия Node.js соответствует минимальным требованиям.

npm install groupdocs-signature-cloud

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

Что делает GroupDocs.Signature Cloud SDK for Node.js идеальным для удаления подписей PDF

  • Удалить все типы подписей - Поддерживает текст, изображение, штрих‑код, QR‑код и цифровые подписи.
  • Интеграция с облачным хранилищем - Работает напрямую с файлами, хранящимися в GroupDocs cloud, устраняя необходимость локального управления файлами.
  • Высокая производительность - Оптимизировано для больших PDF‑документов и пакетной обработки.
  • Полный API - Все REST‑конечные точки отражены в библиотеке Node.js, предоставляя гибкость выбора между кодом и cURL.
  • Безопасная обработка - Все операции выполняются через HTTPS и учитывают разрешения вашей учётной записи.

Для более глубокого понимания обратитесь к официальной документации.

Тонкая настройка параметров удаления подписи

В то время как базовый запрос удаляет все подписи, вы можете настроить параметры, такие как:

  • outputPath - Выберите другую папку или имя файла для неподписанного PDF.
  • fileInfo.password - Если исходный PDF защищён паролем, укажите пароль здесь.

Пример установки пути вывода (уже показан в фрагменте кода выше):

deleteRequest.outputPath = "output.pdf";

Дополнительные параметры перечислены в справочнике API.

Лучшие практики удаления подписей из PDF

  • Проверьте наличие файла перед отправкой запроса, чтобы избежать ненужных вызовов API.
  • Используйте переменные окружения для учетных данных клиента, чтобы они не находились в системе контроля версий.
  • Сохраните неподписанный результат в отдельной папке, чтобы сохранить оригинальный подписанный документ.
  • Обрабатывайте ошибки корректно, перехватывая исключения и записывая детали ошибки в журнал.
  • Тестируйте с различными типами подписей, чтобы убедиться, что операция удаления работает во всех сценариях.

Заключение

Удаление подписей из подписанного PDF‑документа становится простым с помощью GroupDocs.Signature Cloud SDK for Node.js. Библиотека обрабатывает аутентификацию, доступ к хранилищу и операцию удаления всего в нескольких строках кода, а REST API предоставляет ту же возможность через cURL. Не забудьте получить соответствующую лицензию для использования в продакшене; детали ценообразования доступны на странице продукта, а временную лицензию можно получить со страницы временной лицензии. С этими инструментами вы можете автоматизировать удаление подписей из PDF в любом Node.js‑рабочем процессе.

Часто задаваемые вопросы

  • Как работает удаление подписей из подписанного PDF‑документа с помощью GroupDocs.Signature Cloud SDK for Node.js?
    Библиотека аутентифицируется с использованием вашего client ID и secret, затем вызывает endpoint DeleteSignatures, чтобы удалить все подписи из указанного PDF. См. документацию GroupDocs.Signature Cloud SDK for Node.js для получения подробностей.

  • Могу ли я удалить подписи из PDF, хранящегося в облачном хранилище GroupDocs?
    Да. Укажите путь к хранилищу в объекте FileInfo, и SDK получит доступ к файлу напрямую. Обратитесь к официальной документации для работы с хранилищем.

  • Что если мне нужно сохранить копию оригинального подписанного PDF?
    Укажите другой outputPath в DeleteSignaturesRequest, чтобы оригинальный файл остался нетронутым, а новый файл не содержал подписей.

  • Нужна ли специальная лицензия для использования этой функции в продакшене?
    Для использования в продакшене требуется действующая лицензия. Вы можете получить временную лицензию на странице страница временной лицензии.

Читать далее