Documento seguro - Excel API
PDF4me Excel seguro permite que você aplique proteção por senha a Excel documentos em vários níveis. Isto API O serviço oferece suporte à criptografia de arquivos (senha para abrir), proteção da estrutura da pasta de trabalho (impedindo modificações nas planilhas) e proteção do conteúdo da planilha (impedindo edições nas células), com hierarquia de senhas flexível e tipos de proteção (Conteúdo, Objetos, Cenários, Tudo). API recebe Excel conteúdo do documento através REST API chamadas, utilizando Base64 Codificação para transmissão segura. Essa solução é ideal para proteção de dados confidenciais, segurança de modelos e fluxos de trabalho com acesso controlado.
Autenticando seu API Solicitar
Inclua o seu API digite a chave na solicitação para autenticar com o PDF4me REST API.
Principais características
- Três níveis de proteçãoCriptografia de arquivos, estrutura da planilha, conteúdo da folha de exercícios
- Senhas independentesUse senhas diferentes para cada nível de proteção.
- Senha alternativaUsar a senha principal como alternativa quando a senha específica do nível não for fornecida.
- Seleção flexível de planilhasProteger planilhas específicas ou todas as planilhas
- Opções de tipo de proteçãoConteúdo, objetos, cenários ou tudo (abrangente)
- Indexação baseada em 0Os índices das planilhas utilizam numeração baseada em 0 (0 = primeira planilha)
REST API Ponto final
- Método: POST
- Ponto final:
office/ApiV2Excel/ExcelSecure
REST API Parâmetros
Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios. Todas as solicitações usam documento, conteúdo do documento, e ação segura do ExcelOs parâmetros específicos da operação (senha, protegerPastaDeTrabalho, etc.) são propriedades do objeto de ação.
Parâmetros obrigatórios (nível raiz)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| documento* | Object | Referência do documento com Nome (Excel nome do arquivo) | { "Name": "data.xlsx" } |
| conteúdo do documento* | String (Base64) | Excel conteúdo do documento codificado em Base64 | UEsDBBQABgAIAAAA... |
| ação segura do Excel* | Object | Configuração de ações (senha, níveis de proteção, seleção de planilha) | Veja o exemplo de carga útil abaixo. |
Parâmetros opcionais (dentro de secureExcelAction)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| senha | String | Senha de criptografia de arquivos (Nível 1). Também usada como medida de segurança para proteção de planilhas/pasta de trabalho caso suas senhas estejam vazias. | MyPassword123 |
| protegerLivro de Trabalho | Boolean | Ativar proteção da estrutura da pasta de trabalho (Nível 2). Padrão: falso | true |
| protegerSenhaDoPastaDeTrabalho | String | Senha de proteção da planilha. Alternativa: senha se estiver vazia. | StructurePass |
| protegerPlanilhas | Boolean | Ativar a proteção de conteúdo da planilha (Nível 3). Padrão: desativada. | true |
| planilhaProteçãoTipo | String | Conteúdo, Objetos, Cenários, ou TodosPadrão: Todos | All |
| Senha de proteção da planilha | String | Senha de proteção da planilha. Alternativa: senha caso esteja vazia. | EditPass |
| Nomes das planilhas | String | Nomes de planilhas separados por vírgulas para proteger; vazio = tudo | Sheet1,Summary |
| Índices da planilha | String | Índices de planilha separados por vírgula (base 0); vazio = todos | 0,2 |
| nome_da_cultura | String | Código cultural para processamento | en-US |
Saída
O API retorna o protegido por senha Excel documento como um Base64string codificada em JSON formato (documento, nomeDoArquivo, sucesso, mensagemDeErro).
Exemplo de solicitação
Cabeçalho
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
}
}