PDF Blocks
PrezziSupporto
Iniziare gratis
Aprire la pagina

Rimuovere la password da un PDF

Decrittografare un PDF protetto da password in modo che non richieda più una password per l’apertura.

Rimuovere la password da un PDF crittografato. Fornendo la password che apre attualmente il file si ottiene un documento che si apre senza password. L’API è stateless: il documento viene elaborato nella regione e non viene mai memorizzato.

Endpoint

POST
/v1/remove_password

Disponibile in tutte le regioni. Vedere Regioni e residenza dei dati per il routing e la residenza dei dati.

Regione URL
Globale https://api.pdfblocks.com/v1/remove_password
Stati Uniti https://us.api.pdfblocks.com/v1/remove_password
HIPAA Stati Uniti https://hipaa.api.pdfblocks.com/v1/remove_password
Unione europea https://eu.api.pdfblocks.com/v1/remove_password
Regno Unito https://uk.api.pdfblocks.com/v1/remove_password
Canada https://ca.api.pdfblocks.com/v1/remove_password
Australia https://au.api.pdfblocks.com/v1/remove_password
Giappone https://jp.api.pdfblocks.com/v1/remove_password
India https://in.api.pdfblocks.com/v1/remove_password
Brasile https://br.api.pdfblocks.com/v1/remove_password

Autenticazione

Autenticare ogni richiesta con la chiave API segreta nell’intestazione X-API-Key, su HTTPS. Le chiavi si creano e si gestiscono dalla dashboard. Vedere Autenticazione per i dettagli.

Richiesta

L’endpoint accetta un corpo della richiesta multipart/form-data.

filefilerequired

Il documento PDF crittografato di input.

passwordstringrequired

La password che apre attualmente il file. Massimo 256 caratteri.

Per rimuovere la password occorre conoscerla: fornire la password che apre attualmente il documento. Non esiste alcuna via di recupero né di forza bruta.

Esempi

Rimuovere la password da un PDF crittografato:

cURLbash
curl https://api.pdfblocks.com/v1/remove_password \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F password='0pen-Sesame' \
  -o unlocked.pdf
Pythonpython
# pip install requests
import requests

with open('input.pdf', 'rb') as file:
    response = requests.post(
        'https://api.pdfblocks.com/v1/remove_password',
        headers={'X-API-Key': 'your_api_key'},
        files={'file': file},
        data={'password': '0pen-Sesame'},
    )

response.raise_for_status()
with open('unlocked.pdf', 'wb') as output:
    output.write(response.content)
Node.jsjavascript
// Node.js 18+
import { readFile, writeFile } from 'node:fs/promises';

const body = new FormData();
body.set('file', new Blob([await readFile('input.pdf')]), 'input.pdf');
body.set('password', '0pen-Sesame');

const response = await fetch('https://api.pdfblocks.com/v1/remove_password', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' },
  body,
});

if (!response.ok) throw new Error(`Request failed: ${response.status}`);
await writeFile('unlocked.pdf', Buffer.from(await response.arrayBuffer()));
PHPphp
<?php
$ch = curl_init('https://api.pdfblocks.com/v1/remove_password');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: your_api_key'],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('input.pdf', 'application/pdf'),
        'password' => '0pen-Sesame',
    ],
]);

$pdf = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) {
    file_put_contents('unlocked.pdf', $pdf);
}
Rubyruby
# gem install http
require 'http'

response = HTTP
  .headers('X-API-Key' => 'your_api_key')
  .post('https://api.pdfblocks.com/v1/remove_password', form: {
    file: HTTP::FormData::File.new('input.pdf'),
    password: '0pen-Sesame',
  })

File.write('unlocked.pdf', response.body) if response.status.success?
Gogo
package main

import (
	"bytes"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func main() {
	var buf bytes.Buffer
	form := multipart.NewWriter(&buf)

	file, _ := os.Open("input.pdf")
	defer file.Close()
	part, _ := form.CreateFormFile("file", "input.pdf")
	io.Copy(part, file)

	form.WriteField("password", "0pen-Sesame")
	form.Close()

	req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/remove_password", &buf)
	req.Header.Set("Content-Type", form.FormDataContentType())
	req.Header.Set("X-API-Key", "your_api_key")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := os.Create("unlocked.pdf")
	defer out.Close()
	io.Copy(out, res.Body)
}
C#csharp
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key");

using var form = new MultipartFormDataContent
{
    { new ByteArrayContent(File.ReadAllBytes("input.pdf")), "file", "input.pdf" },
    { new StringContent("0pen-Sesame"), "password" },
};

var response = await client.PostAsync(
    "https://api.pdfblocks.com/v1/remove_password", form);
response.EnsureSuccessStatusCode();
await File.WriteAllBytesAsync(
    "unlocked.pdf", await response.Content.ReadAsByteArrayAsync());

Risposta

In caso di successo, la risposta è 200 OK e il corpo contiene il PDF decrittografato:

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Length: 48213

Il documento di output non richiede più una password per l’apertura: le pagine e il contenuto sono invariati. Scrivere il corpo della risposta direttamente su un file, come fanno gli esempi qui sopra: non viene memorizzato nulla dalla nostra parte.

Errori

Le richieste non riuscite restituiscono un corpo application/problem+json. Il più comune per questo endpoint è un 400, restituito quando la password fornita non apre il file. L’oggetto errors nomina ogni campo:

{
  "type": "https://www.pdfblocks.com/docs/api/v1/error/400",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "password": ["The password is incorrect."]
  }
}

Una X-API-Key mancante o non valida restituisce un 401. Vedere Errori per tutti i codici di stato e la forma completa della risposta.

Azioni correlate