Protéger des fichiers Excel

Cette API REST permet de protéger des fichiers Excel.

API REST

POST http://api.aspose.cloud/v3.0/cells/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
file	fichier	formData (corps)	Fichier à télécharger
password	chaîne	chaîne de requête (`password`)	Mot de passe utilisé pour protéger le classeur

Réponse

{
  "Status":"OK",
  "Code":200,
  "Files": [
    {
      "Filename": "nom de fichier protégé : sample1.xlsx",
      "FileSize": taille,
      "FileContent": "-----Chaîne Base64 de sample1-----"
    },
    {
      "Filename": "nom de fichier protégé : sample2.xlsx",
      "FileSize": taille,
      "FileContent": "-----Chaîne Base64 de sample2-----"
    }
  ]
}

Codes de statut HTTP

Code	Signification	Description
200	OK	Le filtre a été 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 grande	Le fichier téléchargé dépasse la taille maximale autorisée.
500	Erreur interne du serveur	Erreur inattendue sur le serveur.

Comment utiliser l’API PostProtect avec les SDK

Spécification de l’API PostProtect

La spécification OpenAPI définit une interface de programmation publiquement accessible, vous permettant d’interagir directement avec l’API REST depuis un navigateur web.

Vous pouvez également 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 avec cURL.

Requête

curl -v "http://api.aspose.cloud/v3.0/cells/protect?password=MySecretPwd" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>" \
  -F 'file1=@sample1.xlsx' \
  -F 'file2=@sample2.xlsx'

Réponse

{
  "Files": [
    {
      "Filename": "sample1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Chaîne Base64 de sample1-----"
    },
    {
      "Filename": "sample2.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Chaîne Base64 de sample2-----"
    }
  ]
}

Gestion des erreurs

– L’API peut renvoyer les codes de statut suivants :

Code HTTP	Signification	Exemple de charge utile d’erreur JSON
400	Requête incorrecte (par exemple, fichier manquant)	`{"Code":400,"Message":"Le fichier est obligatoire."}`
401	Non autorisé (jeton invalide ou manquant)	`{"Code":401,"Message":"Jeton d’accès invalide."}`
403	Interdit (permissions insuffisantes)	`{"Code":403,"Message":"Accès refusé."}`
500	Erreur interne du serveur	`{"Code":500,"Message":"Erreur inattendue du serveur."}`

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK constitue la méthode la plus rapide pour développer. Un SDK gère les détails de bas niveau, afin que vous puissiez vous concentrer sur les tâches de votre projet. 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 :

Ajouter une signature numérique à un classeur Excel Décrypter un classeur Excel