Verrouiller des fichiers Excel – Documentation de l’API Aspose.Cells Cloud

Version de l’API : v3.0 (version actuelle)

Cette API REST verrouille les classeurs Excel.

API PostLock

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

Prérequis – La requête doit être envoyée via HTTPS et inclure un jeton Bearer OAuth 2.0 valide dans l’en-tête Authorization.

Les paramètres de la requête sont les suivants :

Nom du paramètre	Type	Emplacement	Description
file	fichier	données de formulaire (corps multipart)	Le classeur Excel à télécharger et verrouiller.
password	chaîne	chaîne de requête	Mot de passe pour le classeur (facultatif).

La Spécification OpenAPI définit une interface de programmation accessible publiquement 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 appeler l’API Cloud à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

Réponse

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Vous pouvez télécharger un classeur d’exemple — Sample.xlsx — afin de tester la requête.

Remarque : L’API prend en charge des fichiers dont la taille maximale est de 100 Mo ; des charges utiles plus importantes peuvent entraîner une réponse HTTP 413 (Payload Too Large).

Détails de la réponse

Champ	Type	Description
Filename	chaîne	Nom du classeur verrouillé renvoyé par le service.
FileSize	entier	Taille du fichier verrouillé, en octets.
FileContent	chaîne (Base64)	Le classeur verrouillé encodé en chaîne Base64.

Pour récupérer le classeur verrouillé, décodez la valeur FileContent depuis Base64 et enregistrez-le en utilisant le Filename fourni dans la réponse.

Gestion des erreurs

– L’API renvoie des codes d’état HTTP standard (par ex. 400 Bad Request, 401 Unauthorized, 500 Internal Server Error) accompagnés d’un objet erreur JSON contenant les champs Code et Message.

Famille de SDK Cloud

L’utilisation d’un SDK constitue la meilleure façon d’accélérer le développement. Un SDK abstractise les détails de bas niveau, vous permettant 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 Cloud Aspose.Cells.

Les exemples de code suivants illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Déproteger un classeur Excel – API Aspose.Cells Cloud Modifier la protection par mot de passe d’un classeur Excel