ForHosting KIT · Documenti e PDF

Impostare i metadati PDF

Un titolo scritto con spazi di troppo torna come Quarterly Report, e le parole chiave Finance e finance diventano una sola, con la prima grafia. Sistemi le proprietà di un PDF prima di archiviarlo o pubblicarlo; il file non viene modificato. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Imposti metadati PDF affidabili prima che un documento entri in un archivio, in un sistema editoriale o in un flusso di consegna. Questa capacità verifica che l’input PDF utilizzi una rappresentazione supportata, richiede un titolo significativo e non vuoto e normalizza autore, oggetto e parole chiave in un oggetto coerente. Rimuove gli spazi accidentali, riduce gli spazi ripetuti, elimina le parole chiave vuote e deduplica le varianti conservando la prima grafia utile. Il risultato è deterministico e pronto per un successivo writer PDF, senza accesso alla rete né modifiche dipendenti dallo stato di esecuzione.

Prepari un PDF valido e un oggetto di metadati

La capacità convalida la rappresentazione, ma non scarica un URL remoto e non riscrive i byte del documento. Inserisca le proprietà proposte nell’oggetto dei metadati. Il titolo è obbligatorio perché un titolo vuoto impedisce di identificare il file nei risultati di ricerca, negli archivi, nelle schede del browser e nei sistemi di gestione documentale.

Autore, oggetto e parole chiave sono facoltativi. Ogni proprietà scalare deve essere una stringa; le parole chiave possono essere un array di stringhe oppure una stringa separata da virgole o punti e virgola. Una struttura così esplicita semplifica la diagnosi degli errori prima che i valori raggiungano la fase di scrittura del PDF.

Inoltre separa il trasporto dell’input dai dati descrittivi, così gli stessi metadati normalizzati possono essere registrati, verificati, confrontati o passati a un’altra capacità senza estrarli nuovamente dal documento.

Comprenda con precisione il funzionamento della normalizzazione

La normalizzazione del testo è volutamente prudente. Gli spazi iniziali e finali vengono rimossi e ogni sequenza interna di spazi, tabulazioni o interruzioni di riga diventa un singolo spazio normale. Maiuscole e minuscole, punteggiatura, accenti e formulazioni significative restano invariati.

Se un autore o un oggetto facoltativo diventa vuoto dopo il ritaglio, viene omesso dall’output anziché essere restituito come null o segnaposto vuoto. Le parole chiave ricevono lo stesso trattamento. Le voci vuote vengono scartate e i duplicati confrontati senza distinguere le maiuscole, quindi “Rapporto Annuale” e “rapporto annuale” producono una sola parola chiave e mantengono la grafia della prima occorrenza.

Anche l’ordine segue la prima occorrenza utile, rendendo i risultati prevedibili per test e cache successive. Il titolo segue le stesse regole, ma non può scomparire: un valore mancante, non testuale o composto solo da spazi restituisce un errore di input non valido.

Usi il risultato normalizzato in un flusso documentale sicuro

La risposta restituisce la rappresentazione PDF convalidata insieme a un oggetto di metadati contenente il titolo normalizzato obbligatorio e soltanto i campi facoltativi con contenuti utili. Si tratta di una fase di preparazione e convalida, non di un editor PDF binario. Un writer successivo può acquisire la risposta, impostare i corrispondenti campi informativi PDF o XMP e applicare le proprie regole per firme, crittografia, conservazione e serializzazione dei byte.

Questa separazione è utile quando i metadati provengono da moduli, fogli di calcolo, sistemi di contenuti o esportazioni automatiche: respinga subito i record malformati, verifichi separatamente i valori puliti e avvii l’elaborazione documentale costosa solo per i record approvati. È utile anche nelle migrazioni massive, dove spazi incoerenti e parole chiave ripetute generano filtri di ricerca poco chiari in migliaia di documenti. Poiché questa capacità non effettua richieste di rete e non memorizza stato, può operare in modo uniforme nel browser e sul server producendo lo stesso contratto normalizzato.

Casi d'uso

Convalidare i moduli editoriali

Controlli i titoli forniti dai redattori e normalizzi i campi descrittivi facoltativi prima della scrittura del PDF finale.

Ripulire le migrazioni di archivi

Rimuova spazi incoerenti e parole chiave duplicate durante la preparazione dei record storici per un nuovo archivio.

Proteggere la generazione automatica dei PDF

Blocchi i report senza titolo prima che inizi una costosa fase di rendering o scrittura dei metadati PDF.

Domande frequenti

Questa capacità modifica i byte del PDF?

No. Convalida la rappresentazione PDF e restituisce metadati normalizzati a un writer PDF successivo.

Quali campi di metadati sono supportati?

Titolo, autore, oggetto e parole chiave. Il titolo è obbligatorio; gli altri campi sono facoltativi.

Le parole chiave possono essere fornite come una sola stringa?

Sì. La stringa viene divisa in corrispondenza di virgole o punti e virgola. Lei può anche fornire un array di stringhe.

Come vengono gestite le parole chiave duplicate?

I duplicati vengono rimossi senza distinguere le maiuscole dopo la normalizzazione degli spazi, conservando la prima grafia e l’ordine.

Che cosa succede se il titolo è vuoto?

Il record viene rifiutato. Il titolo è obbligatorio perché uno vuoto non serve a identificare il file nelle ricerche, negli archivi o nelle schede del browser, e un titolo fatto solo di spazi conta come vuoto.

Strumenti correlati

Per sviluppatori — accesso via API

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.

Endpoint

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

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

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/pdf/set-metadata \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}'

const res = await fetch("https://api.kit.forhosting.com/pdf/set-metadata", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "metadata": {
      "title": "Quarterly Report",
      "author": "Ada Lovelace",
      "subject": "Operations",
      "keywords": [
        "finance",
        "quarterly report"
      ]
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/set-metadata",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "metadata": {
        "title": "Quarterly Report",
        "author": "Ada Lovelace",
        "subject": "Operations",
        "keywords": [
            "finance",
            "quarterly report"
        ]
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/set-metadata", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/set-metadata", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "pdf": "https://ejemplo.com/documento.pdf",
  "metadata": {
    "title": "Quarterly Report",
    "author": "Ada Lovelace",
    "subject": "Operations",
    "keywords": [
      "finance",
      "quarterly report"
    ]
  }
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.set_metadata",
  "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.

Prezzi

per richiesta$0.002

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

Limiti

`max_mb`	25
`max_pages`	200

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Note tecniche

Prepari un PDF valido e un oggetto di metadati

Invii il PDF in una delle forme supportate: un URI dati PDF in base64, una stringa grezza che inizi con la firma PDF, un URL HTTPS il cui percorso identifichi un PDF oppure un riferimento di caricamento del kit.

Comprenda con precisione il funzionamento della normalizzazione

Nessun orologio, valore casuale, servizio esterno o stato specifico dell’ambiente influenza queste decisioni, pertanto lo stesso input JSON produce sempre lo stesso output.

Usi il risultato normalizzato in un flusso documentale sicuro

Ogni chiamata costa $0.002 per elemento, quindi il costo cresce in modo prevedibile con il numero di record convalidati.

Domande tecniche

Che cosa accade se il titolo contiene solo spazi?

La richiesta non riesce e restituisce un errore invalid_input, perché la normalizzazione lascerebbe il titolo vuoto.

Quanto costa una richiesta?

Ogni elemento convalidato costa $0.002, senza supplementi per rete o modello.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Prepari un PDF valido e un oggetto di metadati

Comprenda con precisione il funzionamento della normalizzazione

Usi il risultato normalizzato in un flusso documentale sicuro

Casi d'uso

Convalidare i moduli editoriali

Ripulire le migrazioni di archivi

Proteggere la generazione automatica dei PDF

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Limiti

Errori

Note tecniche

Prepari un PDF valido e un oggetto di metadati

Comprenda con precisione il funzionamento della normalizzazione

Usi il risultato normalizzato in un flusso documentale sicuro

Domande tecniche

grazie