Supprimer les signatures d’un document PDF signé est une exigence courante lorsque vous avez besoin d’une copie propre pour un traitement ultérieur ou l’archivage. GroupDocs.Signature Cloud SDK for Node.js fournit une bibliothèque robuste qui vous permet de manipuler les signatures PDF de manière programmatique. Dans ce tutoriel, vous apprendrez comment supprimer toutes les signatures d’un PDF en utilisant Node.js, voir un exemple de code complet et explorer les commandes cURL équivalentes pour l’API REST.

Supprimer les signatures d’un document PDF signé dans Node.JS en 5 étapes

Les étapes suivantes montrent comment supprimer les signatures d’un document PDF signé en utilisant le GroupDocs.Signature Cloud SDK for Node.js.

  1. Initialiser la configuration avec les informations d’identification : Créez un objet Configuration qui contient votre ID client et votre secret.
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. Créer le client API et l’instance Signature API : Utilisez la configuration pour créer un ApiClient puis un SignatureApi.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. Définir les informations du fichier PDF source : définissez le filePath du PDF qui se trouve dans le stockage GroupDocs.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. Préparer la requête de suppression avec le chemin de sortie : Créez un DeleteSignaturesRequest, assignez le fileInfo et spécifiez où le résultat doit être enregistré.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. Exécuter la requête et gérer le résultat : Appelez deleteSignatures et traitez la réponse.
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);
}

Pour plus de détails sur chaque classe, consultez la Référence de l’API.

Supprimer toutes les signatures du PDF - Exemple de code complet

L’exemple suivant montre le flux de travail complet pour supprimer les signatures d’un document PDF signé.

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();

Remarque : Cet exemple de code montre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Supprimer les signatures PDF via l’API REST en utilisant cURL

Voici les commandes cURL qui effectuent la même opération via l’API REST de GroupDocs.

  1. Authentifiez‑vous et obtenez un jeton d’accès
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. Téléchargez le PDF source vers le stockage 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. Exécuter l’opération de suppression des signatures
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. Télécharger le PDF résultant
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Pour le contrat complet de l’API, consultez la Référence de l’API.

Préparer l’environnement

Installez la bibliothèque via npm et assurez‑vous que votre version de Node.js répond aux exigences minimales.

npm install groupdocs-signature-cloud

Vous pouvez également télécharger le dernier package depuis la page de téléchargement. Assurez-vous de disposer d’un compte GroupDocs valide et d’avoir généré les identifiants client.

Ce qui rend le GroupDocs.Signature Cloud SDK for Node.js idéal pour la suppression de signatures PDF

  • Supprimer tous les types de signature - Prend en charge le texte, l’image, le code-barres, le code QR et les signatures numériques.
  • Intégration du stockage cloud - Fonctionne directement avec les fichiers stockés dans le cloud GroupDocs, éliminant ainsi le besoin de gérer les fichiers localement.
  • Haute performance - Optimisé pour les gros documents PDF et le traitement par lots.
  • API complète - Tous les points de terminaison REST sont reproduits dans la bibliothèque Node.js, vous offrant la flexibilité de choisir le code ou cURL.
  • Traitement sécurisé - Toutes les opérations se déroulent via HTTPS et respectent les autorisations de votre compte.

Pour plus d’informations, consultez la documentation officielle.

Options de suppression de signature fine

Bien que la requête de base supprime chaque signature, vous pouvez ajuster les options telles que :

  • outputPath - Choisissez un autre dossier ou un autre nom de fichier pour le PDF non signé.
  • fileInfo.password - Si le PDF source est protégé par un mot de passe, définissez le mot de passe ici.

Exemple de définition du chemin de sortie (déjà affiché dans l’extrait de code ci‑dessus) :

deleteRequest.outputPath = "output.pdf";

Des paramètres supplémentaires sont répertoriés dans la référence de l’API.

Meilleures pratiques pour supprimer les signatures des PDF

  • Valider l’existence du fichier avant d’envoyer la requête afin d’éviter des appels API inutiles.
  • Utiliser des variables d’environnement pour les informations d’identification du client afin de les garder hors du contrôle de version.
  • Stocker le résultat non signé dans un dossier séparé pour préserver le document signé original.
  • Gérer les erreurs de manière élégante en capturant les exceptions et en consignant les détails de l’erreur.
  • Tester avec différents types de signature pour s’assurer que l’opération de suppression fonctionne dans tous les scénarios.

Conclusion

Supprimer les signatures d’un document PDF signé devient simple avec le GroupDocs.Signature Cloud SDK for Node.js. La bibliothèque gère l’authentification, l’accès au stockage et l’opération de suppression en quelques lignes de code, tandis que l’API REST offre la même fonctionnalité via cURL. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails de tarification sont disponibles sur la page du produit et vous pouvez obtenir une licence temporaire depuis la page de licence temporaire. Avec ces outils, vous pouvez automatiser la suppression de signatures PDF dans n’importe quel flux de travail Node.js.

FAQs

  • Comment fonctionne la suppression des signatures d’un document PDF signé avec GroupDocs.Signature Cloud SDK for Node.js ?
    La bibliothèque s’authentifie à l’aide de votre ID client et de votre secret, puis appelle le point de terminaison DeleteSignatures pour retirer toutes les signatures du PDF spécifié. Consultez la documentation du GroupDocs.Signature Cloud SDK for Node.js pour plus de détails.

  • Puis-je supprimer des signatures d’un PDF stocké dans le stockage cloud de GroupDocs ?
    Oui. Fournissez le chemin de stockage dans l’objet FileInfo et le SDK accédera directement au fichier. Consultez la documentation officielle pour la gestion du stockage.

  • Que faire si je dois conserver une copie du PDF signé original ?
    Spécifiez un outputPath différent dans DeleteSignaturesRequest afin que le fichier original reste intact tandis que le nouveau fichier ne contienne aucune signature.

  • Ai-je besoin d’une licence spéciale pour utiliser cette fonctionnalité en production ?
    Une licence valide est requise pour une utilisation en production. Vous pouvez obtenir une licence temporaire depuis la page de licence temporaire.

Read More