Ajouter une filigrane aux fichiers Excel – Documentation Aspose.Cells Cloud

Cette API REST ajoute une filigrane aux fichiers Excel.

Prérequis : Vous devez obtenir un jeton d’accès JWT valide et vous assurer que le fichier Excel est dans un format pris en charge (par exemple, .xlsx, .xls).
Contexte : Une filigrane est un texte semi-transparent superposé à chaque feuille de calcul afin d’indiquer la propriété ou le caractère confidentiel du document.

API PostWatermark

POST https://api.aspose.cloud/v3.0/cells/watermark

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur jeton JWT.

Paramètres de la requête

Nom du paramètre Type Emplacement Description
file fichier formData (corps multipart) Le fichier Excel auquel la filigrane sera appliquée.
text chaîne query Le texte de la filigrane à afficher.
color chaîne query La couleur de la filigrane au format hexadécimal ARGB (par exemple, 004433ff).

Réponse

La réponse JSON contient un tableau Files (Fichiers). Pour chaque objet fichier :

  • Filename – nom du classeur traité.
  • FileSize – taille du fichier en octets.
  • FileContent – contenu de l’ fichier Excel filigrané encodé en Base64 ; décodez-le pour obtenir le fichier effectif.
{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[nom_fichier1]",
            "Filesize" : [taille_fichier],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[nom_fichier2]",
            "Filesize" : [taille_fichier],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[nom_fichier3]",
            "Filesize" : [taille_fichier],
            "FileContent" : "[Base64String]"
        }
    ]
}

Codes d’état HTTP

Code Signification Description
200 OK Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400 Demande incorrecte Paramètres manquants ou non valides (par exemple, type de fichier non pris en charge).
401 Non autorisé Jeton JWT invalide ou manquant.
413 Charge utile trop grande Le fichier téléchargé dépasse la limite de taille.
500 Erreur interne du serveur Erreur inattendue du serveur.

Comment utiliser l’API PostWatermark à l’aide des SDK

Spécification de l’API PostWatermark

La spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer directement des interactions REST depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler les services web Aspose.Cells. L’exemple ci-dessous montre une requête complète, incluant l’en-tête d’authentification requis. Remplacez <your-jwt-token> par un jeton d’accès JWT valide obtenu à partir du point d’authentification Aspose.

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK est la méthode la plus rapide pour développer. Un SDK masque les détails de bas niveau, vous permettant ainsi de vous concentrer sur votre logique métier. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code ci-dessous montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Ajouter une image d'arrière-plan à un classeur