ForHosting KIT · PDF e documentos

Definir permissões de PDF: imprimir, copiar, editar e anotar

O validador de permissões de PDF transforma uma lista de opções de acesso em um conjunto previsível.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe uma referência ao PDF e qualquer combinação de print, copy, edit e annotate. O resultado usa nomes canônicos em minúsculas, remove duplicatas e segue uma ordem estável. Se houver um nome incompatível, a solicitação falha com uma mensagem clara, sem encaminhar uma política ambígua à próxima etapa do fluxo de documentos. Assim, configurações automatizadas permanecem consistentes e fáceis de revisar.

Defina a política antes de alterar o documento

Fluxos de segurança de PDF costumam começar com um pequeno objeto de configuração, bem antes de uma biblioteca de criptografia ou um serviço de documentos processar o arquivo. Essa configuração merece a mesma validação aplicada ao documento. Uma opção digitada incorretamente, como “printing”, pode ser ignorada, interpretada de maneiras diferentes por bibliotecas distintas ou armazenada como se fosse válida. Esta capacidade oferece um contrato objetivo para esse limite. Envie a referência ao PDF e os nomes das permissões que você pretende conceder. O validador confirma que a referência está presente e que permissions é um array composto apenas por print, copy, edit e annotate. Em seguida, devolve os nomes aceitos na ordem canônica. Ele não baixa, inspeciona, criptografa nem regrava o PDF. Manter a validação separada torna o resultado adequado para uma etapa posterior de proteção, um banco de políticas, uma tela de aprovação ou um registro de auditoria. Também permite rejeitar uma seleção incorreta antes de iniciar uma operação documental mais lenta ou cara.

Como a normalização gera um resultado estável

Listas de permissões frequentemente vêm de caixas de seleção, argumentos de linha de comando, configurações importadas ou regras combinadas. Essas fontes podem produzir letras maiúsculas e minúsculas misturadas, espaços externos, valores repetidos e ordens inconsistentes. O normalizador remove os espaços de cada texto e converte o nome para minúsculas antes de compará-lo ao vocabulário aceito. As duplicatas viram uma única entrada, pois permissões representam um conjunto, não uma sequência de comandos. A saída sempre segue print, copy, edit e annotate, qualquer que seja a ordem recebida. Um array vazio é válido e representa uma política que não concede nenhuma das quatro permissões. Um valor que não seja texto ou um nome desconhecido faz a solicitação inteira falhar com erro de entrada inválida; a ferramenta jamais descarta silenciosamente uma opção incompatível. Esse comportamento integral é importante em configurações de segurança, porque uma política aceita parcialmente pode deturpar o pedido. A saída determinística também é simples de comparar, armazenar, assinar, revisar e testar.

Use o conjunto normalizado em um fluxo de PDF completo

O array devolvido é uma descrição validada da política, e não um documento modificado. Encaminhe-o ao componente que realmente aplica criptografia ou restrições de proprietário e consulte a documentação desse componente para saber como leitores e sistemas operacionais se comportam. Em geral, permissões de PDF são controles orientativos respeitados por softwares compatíveis; elas não substituem controle de acesso, distribuição cuidadosa nem criptografia com uma senha apropriada. Separar validação e aplicação ainda oferece vantagens práticas. Um formulário pode exibir um resumo claro antes do envio, uma API pode armazenar uma representação consistente em vez de várias listas equivalentes e um lote pode parar no primeiro nome desconhecido. Como esta capacidade não usa serviço de rede e não decodifica o PDF informado, ela pode ser executada no navegador com o mesmo resultado determinístico da API. O uso no navegador é gratuito, enquanto solicitações automatizadas pela API usam o preço-base publicado de US$ 0,002. Nenhum conteúdo do documento é devolvido ou mantido pelo validador.

Casos de uso

Validar um formulário de permissões

Normalize os valores das caixas antes de solicitar a proteção do PDF e mostre à pessoa o conteúdo exato da política aceita.

Padronizar políticas de documentos armazenadas

Remova duplicatas e diferenças de ordem antes de salvar permissões em um banco de dados ou registro de auditoria.

Recusar erros de configuração inseguros

Interrompa um fluxo em lote quando uma integração enviar um nome desconhecido, em vez de ignorá-lo silenciosamente.

Perguntas frequentes

Esta capacidade modifica ou criptografa o PDF?

Não. Ela valida a referência ao PDF e os nomes das permissões, depois devolve um conjunto normalizado. Aplique-o com outra ferramenta de proteção de PDF.

Quais permissões são compatíveis?

Os nomes canônicos aceitos são print, copy, edit e annotate.

O que acontece quando um nome é desconhecido?

A solicitação falha com um erro de entrada inválida que identifica o valor desconhecido e relaciona as opções aceitas.

Valores duplicados e em maiúsculas são aceitos?

Sim. Os espaços externos são removidos, os nomes são convertidos para minúsculas e as permissões repetidas são unificadas.

Posso fornecer uma lista de permissões vazia?

Sim. Um array vazio continua vazio e representa que nenhuma das quatro permissões compatíveis será concedida.

Quanto custa?

A execução no navegador desta página é gratuita. A automação pela API custa US$ 0,002 por solicitação.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/pdf/permissions-set

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/pdf/permissions-set \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/permissions-set", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "kit://upl_example_pdf",
    "permissions": [
      "print",
      "copy"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/permissions-set",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "kit://upl_example_pdf",
    "permissions": [
        "print",
        "copy"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/permissions-set", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/permissions-set", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "pdf": "kit://upl_example_pdf",
  "permissions": [
    "print",
    "copy"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.permissions_set",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	25
`max_pages`	200

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →