Salta al contenuto principale

PDF Tools API

API per unire PDF

Integra unire PDF nel backend, nei batch o nel prodotto senza mantenere un servizio PDF proprietario.

Create API KeyRead full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/pdf-tools/merge-pdf

Use your API Key in the x-api-key header.

Use case

Usalo per contratti, fatture e allegati email o WhatsApp in un unico PDF ordinato. Lo strumento web è per revisione manuale; l’API è per automazioni ripetibili lato server.

cURL example

curl -X POST https://itextmaster.com/api/external/pdf-tools/merge-pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'files=@first.pdf;type=application/pdf' \
  -F 'files=@second.pdf;type=application/pdf' \
  -F 'options={}' \
  --output merged.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/merge-pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'files=@first.pdf;type=application/pdf' \
  -F 'files=@second.pdf;type=application/pdf' \
  -F 'options={}' \
  --output merged.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/merge-pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "files": [
      { "name": "first.pdf", "dataBase64": "JVBERi0xLjcK..." },
      { "name": "second.pdf", "dataBase64": "JVBERi0xLjcK..." }
    ],
    "options": {}
  }' \
  --output merged.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/merge-pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  files: [
    { name: 'first.pdf', dataBase64: 'JVBERi0xLjcK...' },
    { name: 'second.pdf', dataBase64: 'JVBERi0xLjcK...' }
  ],
  options: {}
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('merged.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/merge-pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'files': [
            {'name': 'first.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
            {'name': 'second.pdf', 'dataBase64': 'JVBERi0xLjcK...'}
        ],
        'options': {}
    },
)
response.raise_for_status()

with open('merged.pdf', 'wb') as f:
    f.write(response.content)

Error codes

401invalid_api_key

L’header x-api-key manca, non è valido o è stato ruotato.

402insufficient_credits

L’account non ha API Credits sufficienti.

422pdf_tool_processing_failed

File, opzioni o struttura PDF non sono stati elaborati. I Credits vengono restituiti automaticamente in caso di errore.

Limits

  • Serve un PDF valido o dati di input corretti.
  • Chiama l’API dal server per non esporre la API Key nel browser.
  • Prova file rappresentativi prima di elaborare grandi lotti.

Response headers

merged.pdf con header che indicano Credits usati e saldo rimanente.

Content-Type
Tipo MIME del file generato, di solito application/pdf o application/zip.
Content-Disposition
Nome di download del file generato.
X-Credits-Charged
Credits addebitati per la richiesta riuscita.
X-Credit-Balance
Saldo API Credits dopo la richiesta.

FAQ

Quanto costa API per unire PDF?

Le richieste riuscite usano API Credits; gli errori di elaborazione vengono rimborsati automaticamente. Ogni utente con accesso riceve 100 free API Credits al mese, e 1,000 Credits = $1.

Gli strumenti web usano API Credits?

No. Gli strumenti che lavorano nel browser non consumano API Credits. Contano solo le chiamate con API Key.

Posso chiamare l’API dal browser?

Non è consigliato. Tieni la API Key nel backend, in una coda o in un job lato server.

Start with 100 free API Credits

Create an API Key, test API per unire PDF, and buy more Credits only when automation volume grows.

Get API KeyView full API docs