Document sécurisé - Excel API
PDF4me Excel sécurisé vous permet d'appliquer une protection par mot de passe à Excel Des documents à plusieurs niveaux. API Ce service prend en charge le chiffrement des fichiers (mot de passe pour ouvrir), la protection de la structure du classeur (empêchant les modifications des feuilles) et la protection du contenu des feuilles de calcul (empêchant les modifications des cellules), avec une hiérarchie de mots de passe flexible et des types de protection (Contenu, Objets, Scénarios, Tout). API reçoit Excel contenu du document via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Cette solution est idéale pour la protection des données confidentielles, la sécurité des modèles et les flux de travail à accès contrôlé.
Authentification de votre API Demande
Incluez votre API clé dans la requête pour s'authentifier auprès du PDF4me REST API.
Caractéristiques principales
- Trois niveaux de protectionChiffrement des fichiers, structure du classeur, contenu des feuilles de calcul
- Mots de passe indépendantsUtilisez des mots de passe différents pour chaque niveau de protection.
- Mot de passe de secoursUtiliser le mot de passe principal comme solution de repli si le mot de passe spécifique au niveau n'est pas fourni.
- Sélection flexible de feuilles de travailProtéger des feuilles de calcul spécifiques ou toutes les feuilles de calcul
- Options de type de protection: Contenu, objets, scénarios ou l'ensemble (complet)
- Indexation à partir de 0: Les index des feuilles de calcul utilisent une numérotation à partir de 0 (0 = première feuille de calcul)
REST API Point de terminaison
- Méthode: POST
- Point final :
office/ApiV2Excel/ExcelSecure
REST API Paramètres
Important: Les paramètres marqués d'un astérisque (*) sont obligatoires. Toutes les requêtes utilisent document, docContent, et SecureExcelActionLes paramètres spécifiques à l'opération (mot de passe, protectWorkbook, etc.) sont des propriétés de l'objet action.
Paramètres requis (niveau racine)
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| document* | Object | Référence du document avec Nom (Excel nom de fichier) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel contenu du document encodé en Base64 | UEsDBBQABgAIAAAA... |
| SecureExcelAction* | Object | Configuration des actions (mot de passe, niveaux de protection, sélection de la feuille de calcul) | Voir l'exemple de charge utile ci-dessous |
Paramètres optionnels (dans secureExcelAction)
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| mot de passe | String | Mot de passe de chiffrement du fichier (niveau 1). Sert également de solution de repli pour la protection des classeurs/feuilles de calcul si leurs mots de passe sont vides. | MyPassword123 |
| protéger le classeur | Boolean | Activer la protection de la structure du classeur (niveau 2). Valeur par défaut : désactivée. | true |
| protéger le mot de passe du classeur | String | Mot de passe de protection du classeur. Par défaut : mot de passe si vide. | StructurePass |
| protéger les feuilles de travail | Boolean | Activer la protection du contenu de la feuille de calcul (niveau 3). Par défaut : désactivée. | true |
| feuille de calculProtectionType | String | Contenu, Objets, Scénarios, ou TousPar défaut : Tout | All |
| feuille de travailProtectionMot de passe | String | Mot de passe de protection de la feuille de calcul. Par défaut : mot de passe si la feuille est vide. | EditPass |
| Noms des feuilles de travail | String | Noms des feuilles de calcul à protéger, séparés par des virgules ; vide = tout | Sheet1,Summary |
| Index des feuilles de calcul | String | Index des feuilles de calcul séparés par des virgules (à partir de 0) ; vide = tout | 0,2 |
| nom de la culture | String | Code de culture pour le traitement | en-US |
Sortir
Le API renvoie le protégé par mot de passe Excel document en tant que Base64chaîne encodée dans JSON format (document, nom_de_fichier, succès, message_d_erreur).
Exemple de requête
En-tête
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Charge utile (basique)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}