Desbloquear Excel
PDF4me Desbloquear Excel es un REST punto final que elimina la protección por contraseña de un Excel El libro de trabajo se abrirá cuando introduzca la contraseña correcta. POST el archivo protegido como Base64 a office/ApiV2Excel/ExcelUnlock, introduce la contraseña dentro unlockExcelActiony guarda la copia desprotegida decodificada del JSON respuesta. Elimina la protección; nunca la rompe.
Toma un libro de trabajo protegido más su contraseña y devuelve una copia desprotegida. El cifrado de archivos, la protección de la estructura del libro de trabajo y los bloqueos de hojas de cálculo se eliminan en una sola pasada, que es lo que necesitan las canalizaciones automatizadas antes de poder leer celdas, agregar filas o combinar archivos: cada dos Excel La acción espera un libro de trabajo no protegido. La respuesta es JSON con el resultado como Base64 contenido.
Autenticando su API Pedido
Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.
Punto final
Office/ApiV2Excel/ExcelUnlockDatos importantes que no debes perderte
success: FALSO.desbloquearExcelAction.password Desde una variable de entorno o un gestor de secretos, se aplica la misma regla que a cualquier credencial.HTTP configuración
Método: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>
La respuesta es JSON: comprobar el success bandera, entonces Base64-decodificar el contenido del libro de trabajo devuelto y guardarlo con un .xlsx extensión.
¿Qué protecciones elimina el desbloqueo?
Excel La protección es por capas, y cada capa se comporta de manera diferente. Desbloquear con la contraseña correcta elimina todas las capas de una sola vez.
| Protección frente a comportamiento | Lo que bloquea | Eliminado por este API |
|---|---|---|
| Cifrado de archivos | Abrir el archivo sin contraseña | Sí, con la contraseña correcta. |
| Protección de la estructura del libro de trabajo | Agregar, eliminar o reordenar hojas | Sí |
| Protección de hojas de cálculo | Edición de celdas en una hoja bloqueada | Sí |
| Una contraseña desconocida y perdida | Todo lo anterior | No. Se requiere la contraseña correcta. |
API campos corporales
| Parámetro | Requerido | Tipo | Lo que hace | Ejemplo |
|---|---|---|---|---|
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 |
Cargas útiles de ejemplo
Desbloquear con una contraseña secreta
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}"
}
}
Desbloquear con una cultura explícita
{
"document": { "Name": "quarterly-report.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}",
"cultureName": "en-US"
}
}
Consejos para el cobro de carteros
Ejemplo de 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
¿Qué significa el API ¿devolver?
A JSON resultado que contiene el libro de trabajo no protegido como Base64.
| Campo | Tipo | Lo que contiene |
|---|---|---|
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. |
Ejemplos de código
Excel Los puntos finales de la oficina aún no están cubiertos por per-language carpetas de muestra; el repositorio de muestras contiene el patrón de solicitud utilizado por cada PDF4me familia de puntos finales:
Preguntas frecuentes
¿Por qué desbloquear mediante? API ¿En lugar de hacerlo manualmente?
La ruta manual para un bloqueo a nivel de hoja es desprotegiendo la hoja en Excel: abrir el archivo, introducir la contraseña, pestaña Revisar, Desproteger hoja, guardar, repetir por cada archivo. Eso no se adapta a una carpeta diaria de informes protegidos. El API Realiza la misma eliminación verificada por contraseña que una solicitud determinista por archivo, y la salida sigue siendo estándar. Oficina abierta XML El libro de trabajo está listo para el resto del proceso.