Protéger par lots des fichiers Excel

Cette API REST permet la protection par lots des fichiers Excel éligibles.

API REST

POST http://api.aspose.cloud/v3.0/cells/batch/protect

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 la requête

Nom du paramètre	Type	Emplacement	Description
batchProtectRequest	BatchProtectRequest	body	Charge utile JSON spécifiant le dossier source, les conditions de correspondance, le type de protection, le mot de passe et le dossier de sortie.

Propriétés de BatchProtectRequest

Nom	Type	Description	Notes
SourceFolder	string	Dossier contenant les fichiers Excel sources.	facultatif
MatchCondition	MatchConditionRequest	Critères utilisés pour sélectionner les fichiers à protéger.	facultatif
ProtectionType	string	Type de protection à appliquer (par ex. `All`, `ReadOnly`).	facultatif
Password	string	Mot de passe à définir pour les fichiers protégés.	facultatif
OutFolder	string	Dossier de destination pour les fichiers protégés.	facultatif

Propriétés de MatchConditionRequest

Nom	Type	Description	Notes
RegexPattern	string	Expression régulière utilisée pour faire correspondre les noms de fichiers.	facultatif
FullMatchConditions	string[]	Liste des conditions exactes de nom de fichier.	facultatif

Paramètre du corps de la requête

Nom du paramètre	Type	Description
data	file	Contenu binaire du fichier classeur à créer.

Réponse

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

Codes de statut HTTP

Code	Signification	Quand renvoyé
200 OK	Classeur créé avec succès	Fluide normal
201 Created	Classeur créé (réponse alternative)	Lorsque l’API renvoie un statut « créé »
400 Bad Request	Paramètres non valides	Erreur côté client
401 Unauthorized	Jeton manquant ou non valide	Erreur d’authentification
409 Conflict	Fichier existant et `isWriteOver=false`	Conflit avec un fichier existant

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

Spécification de l’API PostProtectConvert

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.

Requête

curl -v "http://api.aspose.cloud/v3.0/cells/batch/protect" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jeton jwt>" \
-D "{\"SourceFolder\":\"CellsTests\",\"OutFolder\":\"Output\",\"MatchCondition\":{\"RegexPattern\":\"(^Book)(.+)(xlsx$)\"},\"Password\":\"123456\",\"ProtectionType\":\"All\"}"

Réponse

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

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK est le moyen le plus efficace d’accélérer le développement. Un SDK gère les détails de bas niveau et 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 montrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :