Chiffrer un classeur Excel avec l’API Aspose.Cells Cloud – Exemples cURL et SDK
Cette API REST chiffre un classeur Excel.
Prérequis : Vous devez disposer d’un jeton JWT valide et avoir chargé le classeur dans un emplacement de stockage avant d’appeler ce point de terminaison.
API PostEncryptDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/encryption
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.
Paramètres de requête
| Nom du paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| folder | string | ✗ | Chemin du dossier contenant le classeur original. |
| storageName | string | ✗ | Nom du stockage à utiliser. |
Paramètre du corps de la requête
| Nom du paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| encryption | WorkbookEncryptionRequest | ✓ | Paramètres de chiffrement pour le classeur. |
WorkbookEncryptionRequest
| Nom du paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| EncryptionType | string | ✓ | Algorithme de chiffrement. Voir le tableau ci-dessous pour les valeurs prises en charge et leur signification. |
| KeyLength | integer | ✗ | Longueur de la clé de chiffrement en bits (ignorée pour XOR et Compatible). |
| Password | string | ✓ | Mot de passe utilisé pour le chiffrement. |
Valeurs possibles pour EncryptionType
| Valeur | Description |
|---|---|
XOR |
Algorithme XOR simple (obsolète, sécurité faible). |
Compatible |
Chiffrement compatible Excel 97‑2003 (40 bits). |
EnhancedCryptographicProviderV1 |
AES‑128 avec hachage SHA‑1. |
StrongCryptographicProvider |
AES‑256 avec hachage SHA‑512 (le plus sécurisé). |
Réponse
{
"Status":"OK",
"Code":200
}
Codes de statut HTTP
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Filtre appliqué avec succès ; la réponse contient les détails de l’opération. |
| 400 | Requête 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 volumineuse | Le fichier chargé dépasse la taille maximale autorisée. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Comment utiliser l’API PostEncryptDocument avec les SDK
Spécification de l’API PostEncryptDocument
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 accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment effectuer un appel à l’API Cloud avec cURL.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK constitue la méthode optimale pour accélérer le développement. Un SDK gère les détails de bas niveau, ce qui vous permet de vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :