ForHosting KIT · Documenti e PDF

Impostare i permessi PDF per stampa, copia, modifica e note

Il validatore dei permessi PDF trasforma un elenco di opzioni di accesso in un insieme prevedibile.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.

Indichi un riferimento al PDF e una combinazione qualsiasi di print, copy, edit e annotate. Il risultato usa nomi canonici minuscoli, elimina i duplicati e segue un ordine stabile. Se l’elenco contiene un nome non supportato, la richiesta termina con un errore chiaro invece di inoltrare una regola ambigua alla fase successiva del flusso documentale. In questo modo le configurazioni automatizzate restano coerenti e verificabili.

Definisca la regola prima di modificare il documento

I flussi di sicurezza dei PDF spesso iniziano con un piccolo oggetto di configurazione, molto prima che una libreria di cifratura o un servizio documentale elabori il file. Tale configurazione merita la stessa convalida del documento. Un’opzione scritta male, come “printing”, potrebbe altrimenti essere ignorata, interpretata diversamente da librerie differenti o archiviata come se fosse valida. Questa capacità offre un contratto preciso per quel passaggio. Invii il riferimento al PDF insieme ai nomi dei permessi che intende concedere. Il validatore verifica la presenza del riferimento e controlla che permissions sia un array contenente soltanto print, copy, edit e annotate. Poi restituisce i nomi accettati nell’ordine canonico. Non scarica, esamina, cifra o riscrive il PDF. Separare la convalida rende il risultato un input sicuro per una successiva protezione, un archivio di regole, una schermata di approvazione o un registro di controllo. Consente inoltre di respingere subito una selezione errata prima di avviare un’operazione documentale più lenta o costosa.

Come la normalizzazione crea un risultato stabile

Gli elenchi di permessi provengono spesso da caselle di selezione, argomenti della riga di comando, impostazioni importate o regole combinate. Queste fonti possono generare maiuscole miste, spazi esterni, valori ripetuti e ordinamenti incoerenti. Il normalizzatore rimuove gli spazi da ogni stringa e la converte in minuscolo prima di confrontarla con il vocabolario supportato. I duplicati diventano un’unica voce perché i permessi rappresentano un insieme, non una sequenza di comandi. L’output segue sempre print, copy, edit e annotate, indipendentemente dall’ordine ricevuto. Un array vuoto è valido e rappresenta una regola che non concede nessuno dei quattro permessi. Un valore non testuale o un nome sconosciuto fa fallire l’intera richiesta con un errore di input non valido; lo strumento non elimina mai in silenzio un’opzione non supportata. Questo comportamento unitario è importante per le impostazioni di sicurezza, poiché un’accettazione parziale potrebbe travisare la richiesta. L’output deterministico è anche semplice da confrontare, archiviare, firmare, esaminare e collaudare.

Usi l’insieme normalizzato in un flusso PDF completo

L’array restituito descrive una regola convalidata, non un documento modificato. Lo trasmetta al componente che applica realmente la cifratura o le restrizioni del proprietario e consulti la relativa documentazione per il comportamento preciso di lettori e sistemi operativi. In genere i permessi PDF sono controlli indicativi rispettati dai software compatibili; non sostituiscono il controllo degli accessi, una distribuzione prudente o la cifratura con una password adeguata. Separare convalida e applicazione offre comunque vantaggi pratici. Un modulo web può mostrare un riepilogo chiaro prima dell’invio, un’API può salvare una rappresentazione coerente invece di molti array equivalenti e un processo in serie può fermarsi al primo nome sconosciuto. Poiché questa capacità non usa servizi di rete e non decodifica il PDF fornito, può essere eseguita nel browser con lo stesso risultato deterministico dell’API. L’uso nel browser è gratuito, mentre le richieste API automatizzate applicano il prezzo base pubblicato di $0.002. Il validatore non restituisce né conserva il contenuto del documento.

Convalidare un modulo dei permessi

Normalizzi i valori delle caselle prima di richiedere la protezione del PDF e mostri l’esatta regola accettata.

Uniformare le regole documentali archiviate

Elimini duplicati e differenze di ordine prima di salvare i permessi in una banca dati o in un registro di controllo.

Respingere errori di configurazione rischiosi

Interrompa un processo in serie quando un’integrazione invia un nome sconosciuto, anziché ignorarlo in silenzio.

Questa capacità modifica o cifra il PDF?

No. Convalida il riferimento al PDF e i nomi dei permessi, poi restituisce un insieme normalizzato da applicare con uno strumento distinto.

Quali permessi sono supportati?

I nomi canonici accettati sono print, copy, edit e annotate.

Che cosa accade con un nome sconosciuto?

La richiesta fallisce con un errore di input non valido che identifica il valore sconosciuto ed elenca le opzioni accettate.

Sono accettati duplicati e valori maiuscoli?

Sì. Gli spazi esterni vengono rimossi, i nomi diventano minuscoli e i permessi ripetuti vengono unificati.

Posso fornire un elenco di permessi vuoto?

Sì. Un array vuoto resta tale e indica che non viene concesso nessuno dei quattro permessi supportati.

Quanto costa?

L’esecuzione nel browser su questa pagina è gratuita. L’automazione tramite API costa $0.002 per richiesta.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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"]}'
{
  "pdf": "kit://upl_example_pdf",
  "permissions": [
    "print",
    "copy"
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.permissions_set",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb25
max_pages200
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →