Protéger un classeur Excel à l’aide de l’API Aspose.Cells Cloud
Cette API REST protège un classeur Excel, vous permettant de le sécuriser efficacement à l’aide d’un mot de passe et d’options de protection via Aspose.Cells Cloud.
API PostProtectDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
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 | Description |
|---|---|---|
| folder | string | Dossier contenant le classeur source. (facultatif) |
| storageName | string | Nom de l’emplacement de stockage. (facultatif ; valeur par défaut = “Default”) |
Paramètres du corps de la requête
| Nom du paramètre | Type | Description |
|---|---|---|
| protection | WorkbookProtectionRequest | Objet définissant les paramètres de protection du classeur. |
WorkbookProtectionRequest
| Nom du paramètre | Type | Description |
|---|---|---|
| ProtectionType | string | Type de protection à appliquer. Valeurs autorisées (insensibles à la casse) : ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS. |
| Password | string | Mot de passe facultatif à définir pour la protection. |
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 | Mauvaise requête | 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 serveur inattendue. |
Comment utiliser l’API PostProtectDocument avec les SDK
Conditions préalables
Avant d’appeler l’API, assurez-vous d’avoir effectué les étapes suivantes :
- Obtenir un jeton d’accès JWT conformément au processus d’authentification décrit dans la section Sécurité et authentification.
- Télécharger le classeur dans votre stockage Aspose Cloud ou vérifier qu’il existe déjà dans le dossier cible.
- Connaître le nom du stockage (valeur par défaut :
"Default"si non spécifié) et le nom exact du fichier à protéger.
Spécification de l’API PostProtectDocument
La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer directement des interactions REST depuis un navigateur web.
Exemple : protéger un classeur à l’aide de cURL
-
Obtenir un jeton d’accès comme décrit dans Conditions préalables / Authentification.
-
Exécuter la requête :
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'La réponse contiendra un objet d’état confirmant que la protection a réussi.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK constitue la méthode la plus rapide pour développer avec Aspose.Cells Cloud. Un SDK abstrait les détails de bas niveau, vous permettant de vous concentrer sur votre logique métier. Consultez 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 :
Réponse complète d’exemple
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}