Déverrouiller Excel
PDF4me Déverrouiller Excel est un REST point de terminaison qui supprime la protection par mot de passe d'un Excel classeur lorsque vous fournissez le mot de passe correct. POST le fichier protégé comme Base64 à office/ApiV2Excel/ExcelUnlock, insérez le mot de passe à l'intérieur unlockExcelActionet sauvegardez la copie décodée non protégée à partir de JSON Réponse. Elle supprime la protection ; elle ne la fissure jamais.
Prend un classeur protégé et son mot de passe et renvoie une copie non protégée. Le chiffrement des fichiers, la protection de la structure du classeur et le verrouillage des feuilles de calcul sont supprimés en une seule opération, ce qui est indispensable aux pipelines automatisés pour lire les cellules, ajouter des lignes ou fusionner des fichiers : toutes les deux opérations. Excel L'action attend un classeur non protégé. La réponse est : JSON avec pour résultat Base64 contenu.
Authentification de votre API Demande
Chaque PDF4me REST L'appel doit inclure votre API clé dans le Authorization En-tête : Authentification de base. Récupérez ou renouvelez votre clé depuis le tableau de bord développeur.
Point de terminaison
office/ApiV2Excel/ExcelUnlockInformations importantes à ne pas manquer
success: FAUX.déverrouillerExcelAction.mot de passe qu'il s'agisse d'une variable d'environnement ou d'un gestionnaire de secrets, la règle est la même que pour toute autre information d'identification.HTTP installation
Méthode: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock
Type de contenu : application/json
Authorization: Basique <votre PDF4me API clé>
La réponse est : JSON: vérifiez le success drapeau, puis Base64-décoder le contenu du classeur renvoyé et l'enregistrer avec un .xlsx extension.
Quelles protections le déverrouillage supprime-t-il ?
Excel La protection est multicouche, et chaque couche fonctionne différemment. Le déverrouillage avec le mot de passe correct supprime toutes les couches en une seule opération.
| Protection vs comportement | Ce qu'il bloque | Supprimé par ceci API |
|---|---|---|
| Chiffrement de fichiers | Ouvrir le fichier sans le mot de passe | Oui, avec le bon mot de passe |
| protection de la structure du classeur | Ajouter, supprimer ou réorganiser des feuilles | Oui |
| Protection des feuilles de travail | Modification de cellules sur une feuille verrouillée | Oui |
| Un mot de passe inconnu et perdu | Tout ce qui précède | Non. Le mot de passe correct est requis. |
API champs corporels
| Paramètre | Requis | Taper | Ce que cela fait | Exemple |
|---|---|---|---|---|
document | Required | object | Document reference carrying Name, the protected Excel filename with its extension. | { "Name": "data.xlsx" } |
docContent | Required | string | Base64-encoded bytes of the password-protected workbook. | UEsDBBQABgAIAAAA... |
unlockExcelAction | Required | object | Action configuration object holding the password and optional culture settings. | { "password": "..." } |
password | Required | string | Inside the action object. The password that was used to protect the file. Inject from a secret store; never hardcode. | {{EXCEL_PASSWORD}} |
cultureName | Optional | string | Inside the action object. Culture code applied during processing. | en-US |
Exemples de charges utiles
Déverrouiller avec un mot de passe secret injecté
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}"
}
}
Déverrouillez avec une culture explicite
{
"document": { "Name": "quarterly-report.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}",
"cultureName": "en-US"
}
}
Conseils pour la collecte par le facteur
Exemple curl
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"unlockExcelAction": {
"password": "'"$EXCEL_PASSWORD"'"
}
}' \
--output response.json
Que signifie le API retour?
UN JSON résultat contenant le classeur non protégé Base64.
| Champ | Taper | Ce qu'il contient |
|---|---|---|
document | String (Base64) | The unprotected workbook content. Decode to bytes and save with an .xlsx extension. |
fileName | String | Output filename for the unlocked workbook. |
success | Boolean | true when unlocking succeeded. Check this before decoding content. |
errorMessage | String | Populated when success is false, including the wrong-password case. |
Exemples de code
Excel Les terminaux de bureau ne sont pas encore couverts par per-language dossiers d'exemples ; le dépôt d'exemples contient le modèle de requête utilisé par chaque PDF4me famille de points de terminaison :
FAQ
Pourquoi déverrouiller via API au lieu de manuellement ?
La voie manuelle pour un verrou au niveau de la tôle est déprotéger la feuille dans ExcelOuvrir le fichier, saisir le mot de passe, onglet Révision, Déprotéger la feuille, enregistrer, répéter l'opération pour chaque fichier. Cette méthode n'est pas adaptée à un dossier de rapports protégés traité quotidiennement. API effectue la même suppression vérifiée par mot de passe qu'une requête déterministe par fichier, et le résultat reste standard. Office Open XML Le classeur est prêt pour le reste du processus.