Documento seguro - Excel API
PDF4me Excel seguro te permite aplicar protección por contraseña a Excel documentos en múltiples niveles. Esto API El servicio admite el cifrado de archivos (contraseña para abrir), la protección de la estructura del libro de trabajo (impide la modificación de las hojas) y la protección del contenido de la hoja de cálculo (impide la edición de celdas), con una jerarquía de contraseñas flexible y tipos de protección (Contenido, Objetos, Escenarios, Todos). API recibe Excel contenido del documento a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Esta solución es ideal para la protección de datos confidenciales, la seguridad de plantillas y los flujos de trabajo de acceso controlado.
Autenticando su API Pedido
Incluye tu API clave en la solicitud para autenticarse con el PDF4me REST API.
Características principales
- Tres niveles de protección: Cifrado de archivos, estructura del libro de trabajo, contenido de la hoja de cálculo
- Contraseñas independientesUtilice contraseñas diferentes para cada nivel de protección.
- Contraseña alternativa: Utilice la contraseña principal como alternativa cuando no se proporcione una contraseña específica para el nivel.
- Selección flexible de hojas de cálculoProteger hojas de cálculo específicas o todas las hojas de cálculo.
- Opciones de tipo de protección: Contenidos, objetos, escenarios o todo (exhaustivo)
- Indexación basada en 0Los índices de las hojas de cálculo utilizan una numeración basada en 0 (0 = primera hoja de cálculo).
REST API Punto final
- Método: POST
- Punto final:
office/ApiV2Excel/ExcelSecure
REST API Parámetros
Importante: Los parámetros marcados con un asterisco (*) son obligatorios. Todas las solicitudes utilizan documento, docContent, y acción segura de ExcelLos parámetros específicos de la operación (contraseña, proteger libro de trabajo, etc.) son propiedades del objeto de acción.
Parámetros requeridos (nivel raíz)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| documento* | Object | Referencia del documento con Nombre (Excel Nombre del archivo) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel contenido del documento codificado en Base64 | UEsDBBQABgAIAAAA... |
| acción segura de Excel* | Object | Configuración de acciones (contraseña, niveles de protección, selección de hoja de cálculo) | Consulte el ejemplo de carga útil a continuación. |
Parámetros opcionales (dentro de secureExcelAction)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| contraseña | String | Contraseña de cifrado de archivos (Nivel 1). También se utiliza como alternativa para la protección de libros/hojas de cálculo si sus contraseñas están vacías. | MyPassword123 |
| proteger el libro de trabajo | Boolean | Habilitar la protección de la estructura del libro de trabajo (Nivel 2). Valor predeterminado: falso | true |
| protegerContraseñaLibroDeObra | String | Contraseña de protección del libro de trabajo. Alternativa: contraseña si está vacío. | StructurePass |
| proteger las hojas de cálculo | Boolean | Habilitar la protección del contenido de la hoja de cálculo (Nivel 3). Valor predeterminado: falso | true |
| tipo de protección de la hoja de cálculo | String | Contenido, objetos, Escenarios, o TodoPredeterminado: Todos | All |
| Contraseña de protección de hoja de cálculo | String | Contraseña de protección de la hoja de cálculo. Alternativa: contraseña si está vacía. | EditPass |
| nombres de las hojas de cálculo | String | Nombres de hojas de cálculo separados por comas para proteger; vacío = todos | Sheet1,Summary |
| Índices de la hoja de trabajo | String | Índices de hojas de cálculo separados por comas (basados en 0); vacío = todos | 0,2 |
| Nombre de la cultura | String | Código cultural para el procesamiento | en-US |
Producción
El API devuelve el protegido por contraseña Excel documento como un Base64cadena codificada en JSON formato (documento, nombrearchivo, éxito, mensaje de error).
Ejemplo de solicitud
Encabezamiento
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carga útil (básica)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}