Ajouter une signature numérique à un classeur Excel – API Aspose.Cells Cloud

Conditions préalables :
Avant d’appeler cet endpoint, assurez-vous d’avoir :

Un jeton d’accès JWT valide obtenu via l’authentification Aspose Cloud.
Le classeur cible téléchargé dans votre stockage Aspose Cloud.
Un fichier de signature numérique au format .pfx ou .p12 ainsi que son mot de passe.

Cette API REST ajoute une signature numérique à un classeur Excel.

API PostDigitalSignature

POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification par jeton JWT.

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	`<code>path</code>`	Nom du classeur.
digitalsignaturefile	string	`<code>query</code>`	Chemin du fichier de signature numérique (`.pfx` ou `.p12`).
password	string	`<code>query</code>`	Mot de passe du classeur, le cas échéant.
folder	string	`<code>query</code>`	Dossier dans lequel le classeur est stocké.
storageName	string	`<code>query</code>`	Nom du service de stockage à utiliser.

Remarque : Si le nom de fichier contient des caractères spéciaux, effectuez une codage URL avant de l’ajouter à la chaîne de requête.

Gestion des erreurs

Statut HTTP	Signification
200	Signature appliquée avec succès.
400	Requête incorrecte – paramètres manquants ou invalides.
401	Non autorisé – jeton OAuth invalide ou expiré.
403	Accès refusé – permissions insuffisantes ou accès refusé.
500	Erreur interne du serveur – échec inattendu.

Réponses d’erreur selon le statut HTTPS

Statut HTTP	Code	Description
400	BadRequest	Paramètres manquants ou invalides.
401	Unauthorized	Jeton d’accès invalide ou manquant.
404	NotFound	Classeur spécifié introuvable dans le dossier/stockage indiqué.
500	InternalServerError	Erreur serveur inattendue.

Comment utiliser l’API PostDigitalSignature avec les SDK

Spécification de l’API PostDigitalSignature

La spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer des interactions REST directement 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 illustre une requête vers l’API :

Requête

curl -v "https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature?digitalsignaturefile=signature.pfx&password=VotreMotDePasse" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Réponse

{
  "Code": 200,
  "Status": "OK"
}

Schéma de réponse
L’API renvoie un objet JSON contenant les champs suivants :

Champ	Type	Description
`Code`	int	Code de statut similaire à HTTP indiquant le résultat.
`Status`	string	Court texte décrivant le résultat (par ex., `OK`).
`SignatureId`	string	Identifiant de la signature numérique appliquée (facultatif).
`Message`	string	Informations supplémentaires ou détails d’erreur (facultatif).

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK simplifie l’intégration et réduit le code boilerplate. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

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

Protéger un classeur Excel avec l'API Aspose.Cells Cloud Protéger des fichiers Excel