PDF Blocks
TarifsSupport
Commencer gratuitement
Ouvrir la page

Démarrage rapide

Une première requête authentifiée de bout en bout : obtenez une clé, envoyez un PDF, enregistrez le document qui revient.

Le chemin le plus rapide de zéro à un PDF traité : obtenez une clé, faites un appel, enregistrez le résultat. Aucun SDK, aucune installation au-delà d’une clé d’API et d’un PDF sur le disque.

Obtenez une clé d’API

Connectez-vous au dashboard et créez une clé d’API. Copiez-la en lieu sûr, car vous l’envoyez à chaque requête. Voir Authentification pour comprendre le fonctionnement des clés et savoir comment les garder sécurisées.

Faites un appel

Placez un PDF nommé input.pdf dans votre répertoire de travail, remplacez your_api_key par votre clé et lancez l’un de ces exemples. Chacun appose un filigrane sur le document et écrit le résultat dans watermarked.pdf.

cURLbash
curl https://api.pdfblocks.com/v1/add_text_watermark \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F line_1='CONFIDENTIAL' \
  -o watermarked.pdf
Pythonpython
# pip install requests
import requests

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

response.raise_for_status()
with open('watermarked.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('line_1', 'CONFIDENTIAL');

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

if (!response.ok) throw new Error(`Request failed: ${response.status}`);
await writeFile('watermarked.pdf', Buffer.from(await response.arrayBuffer()));
PHPphp
<?php
$ch = curl_init('https://api.pdfblocks.com/v1/add_text_watermark');
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'),
        'line_1' => 'CONFIDENTIAL',
    ],
]);

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

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

File.write('watermarked.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("line_1", "CONFIDENTIAL")
	form.Close()

	req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/add_text_watermark", &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("watermarked.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("CONFIDENTIAL"), "line_1" },
};

var response = await client.PostAsync(
    "https://api.pdfblocks.com/v1/add_text_watermark", form);
response.EnsureSuccessStatusCode();
await File.WriteAllBytesAsync(
    "watermarked.pdf", await response.Content.ReadAsByteArrayAsync());
Ouvrez votre PDF

En cas de succès, l’API répond 200 OK avec le document filigrané comme corps :

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

Ouvrez watermarked.pdf : c’est votre entrée avec CONFIDENTIAL apposé sur chaque page. C’est tout le contrat : un PDF est entré, un PDF est sorti, et rien n’a été stocké de notre côté.

Pas de 200 ? Une clé absente ou erronée renvoie 401, et un file illisible renvoie 400, tous deux en application/problem+json. Voir Erreurs pour le catalogue complet des statuts.

Étapes suivantes

Authentification

Gérez vos clés, faites-les tourner et gardez-les hors du contrôle de version.

Vue d’ensemble des actions

Parcourez les 17 actions et voyez comment elles se composent.

Requêtes et réponses

La forme uniforme de requête et de réponse que partage chaque action.