Ajouter une marge à PDF - Formateur de mise en page API

PDF4me Ajouter une marge à PDF vous permet d'ajouter des marges personnalisées à n'importe quel côté d'un PDF document. Ce API processus de service PDF Il crée des fichiers et ajoute des marges en millimètres, en ajustant la taille de la page en conséquence pour les intégrer. API reçoit PDF contenu via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Cette solution est idéale pour la mise en forme de documents, la préparation à l'impression et la garantie d'une mise en page homogène pour les documents professionnels.

Articles de blog connexes

Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.

En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.

Consultez le blog →

Authentification de votre API Demande

Pour accéder au PDF4me REST APIChaque requête doit inclure des informations d'authentification valides. L'authentification garantit la sécurité des communications et confirme votre identité en tant qu'utilisateur autorisé. REST API.

Get your api Key

Caractéristiques principales

Contrôle individuel des margesDéfinissez des marges différentes pour le haut, le bas, la gauche et la droite indépendamment.
Précision millimétriqueToutes les marges sont spécifiées en millimètres (plage de 0 à 100).
Ajustement de la taille de la pageLa taille de la page est automatiquement ajustée pour tenir compte des marges ajoutées.
Préservation des documentsConserve le contenu original tout en adaptant la mise en page
Traitement asynchrone: Prise en charge du traitement asynchrone avec interrogation pour les opérations de longue durée

REST API Point de terminaison

Le PDF4me REST API utilise la norme HTTP méthodes d'interaction avec les ressources. Toutes les opérations d'ajout de marge sont effectuées via un point de terminaison unique :

Méthode: POST
Point final : /api/v2/AddMargin

REST API Paramètres

Liste complète des paramètres pour l'ajout de marge à PDF REST APILes paramètres sont organisés par catégorie pour une meilleure compréhension et une mise en œuvre plus aisée.

Important: Les paramètres marqués d'un astérisque (*) sont obligatoires et doivent être fournis pour le API pour fonctionner correctement.

Paramètres requis

Paramètre	Taper	Description	Exemple
Nom du document*	String	Sortir PDF Nom de fichier avec l'extension .pdf	`output.pdf`
docContent*	Base64	PDF contenu du fichier encodé en Base64	`JVBERi...`

Paramètres optionnels

Paramètre	Taper	Description	Exemple
marge gauche	Integer	Marge gauche en millimètres (0-100). Si aucune marge n'est spécifiée, aucune marge gauche n'est ajoutée.	`20`
marge droite	Integer	Marge droite en millimètres (0-100). Si aucune marge n'est spécifiée, aucune marge droite n'est ajoutée.	`20`
marge supérieure	Integer	Marge supérieure en millimètres (0-100). Si aucune marge n'est spécifiée, aucune marge supérieure n'est ajoutée.	`25`
marge inférieure	Integer	Marge inférieure en millimètres (0-100). Si aucune marge n'est spécifiée, aucune marge inférieure n'est ajoutée.	`25`
asynchrone	Boolean	Activer le traitement asynchrone. Lorsque `true`, le API renvoie un statut 202 et fournit un système d'interrogation URL dans le Location en-tête	`true`

Sortir

Le PDF4me Ajouter une marge à PDF REST API renvoie des réponses différentes selon le mode de traitement. API renvoie le PDF comme un Base64chaîne encodée dans JSON format, et non sous forme de données binaires.

Success Response
Asynchronous Processing
Error Responses
Response Format Details

Traitement synchrone (par défaut)

Quand async n'est pas défini ou est défini sur false, le API traite la demande immédiatement :

Code d'état : 200 OK

Content-Type: application/json

Corps de la réponse :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Champs de réponse :

Nom du document (chaîne de caractères) : La sortie PDF nom de fichier
docContent (chaîne de caractères) : Le PDF fichier avec marges ajoutées, encodé comme Base64 chaîne

Mode d'emploi :

Extraire le docContent champ du JSON réponse
Décodez le Base64 chaîne permettant d'obtenir le binaire PDF données
Enregistrer ou traiter le PDF classer selon les besoins

Exemple (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Traitement asynchrone

Quand async: true est réglé, le API traite la requête de manière asynchrone :

Code d'état : 202 Accepted

En-têtes de réponse :

Location: https://api.pdf4me.com/api/v2/AddMargin/poll/12345-abcde-67890

Processus de sondage :

Extraire le Location En-tête de la réponse 202
Sondage URL en utilisant GET demandes
Continuez à sonder jusqu'à ce que vous receviez un 200 OK statut
La réponse finale contient la même chose JSON format avec docName et docContent (Base64)

Exemple de sondage :

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Réponses d'erreur

Le API retours standard HTTP codes d'erreur avec détails de l'erreur :

400 Bad Request

Paramètres de requête invalides
Champs obligatoires manquants (docContent, Nom du document)
Invalide Base64 encodage dans docContent
Valeurs de marge invalides (doivent être des entiers compris entre 0 et 100)

401 Unauthorized

Invalide ou manquant API clé
API clé non correctement Base64 encodé dans Authorization en-tête
Manquant Autorisation : de base en-tête

500 Internal Server Error

Erreur de traitement côté serveur
PDF échec du traitement
Échec de l'addition de marge

Format de réponse en cas d'erreur :

{
  "error": "Error message describing what went wrong"
}

Détails du format de réponse

Important: Le API toujours retourne JSON, jamais binaire PDF données directement.

Structure de la réponse :

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type En-tête :

Succès: application/json
Le PDF est intégré en tant que Base64 chaîne à l'intérieur de la JSON réponse

Pourquoi Base64?

JSON-codage sûr pour les données binaires
Facile à transmettre sur HTTP
Compatible avec tous les langages de programmation
Peut être directement intégré dans JSON sans échapper aux problèmes

Décodage Base64 à PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);

Exemple de requête

En-tête

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Note:

Obtenez votre API clé de la PDF4me Tableau de bord

Le API La clé doit être Base64 encodé et préfixé par « Basic » dans le Authorization en-tête

Exemple : Si votre API La clé est abc123, encodez-le en Base64 et utiliser Authorization: Basic YWJjMTIz

Charge utile

Exemple simple (champs obligatoires uniquement) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Exemple avancé (avec tous les champs facultatifs) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "marginLeft": 20,
  "marginRight": 20,
  "marginTop": 25,
  "marginBottom": 25,
  "async": true
}

Exemples de code

Le PDF4me Ajouter une marge à PDF REST API propose des exemples de code dans plusieurs langages de programmation. Choisissez le langage qui convient le mieux à votre environnement de développement :

C# (CSharp) Échantillon

Complet C# implémentation pour ajouter des marges à PDF:

View C# Sample

PDF Fonctionnalités de marge

Contrôle des marges

Contrôle individuel: Définissez des marges différentes pour chaque côté du document (haut, bas, gauche, droite)
Précision millimétriqueToutes les marges sont spécifiées en millimètres, avec une plage de 0 à 100.
Ajustement de la taille de la pageLa taille de la page est automatiquement ajustée pour tenir compte des marges ajoutées.
Préservation de l'agencement: Conserver la structure du document tout en ajustant les marges

Amélioration des documents

Optimisation d'impressionAssurez-vous que les documents s'impriment correctement sur différents formats de papier.
Mise en forme professionnelle: Créer des mises en page de documents cohérentes pour toutes les équipes
Préservation du contenu: Original PDF Le contenu est conservé pendant l'ajout des marges.

Cas d'utilisation et applications industrielles

Legal & Professional Services
Education & Research
Business & Enterprise
Publishing & Printing

Cas d'utilisation des services juridiques et professionnels

Documents juridiques: Veiller au respect des normes de formatage des documents juridiques
Mise en forme des contrats: Mettre en forme les contrats et les accords avec des marges appropriées
Documents judiciairesPréparer les documents judiciaires en respectant les marges standard.
Documentation de conformité: Mettre en forme les documents de conformité pour répondre aux normes réglementaires

Obtenez de l'aide

Get Your API Key API Samples Getting Started

Authentification de votre API Demande​

Caractéristiques principales​

REST API Point de terminaison​

REST API Paramètres​

Paramètres requis​

Paramètres optionnels​

Sortir​

Exemple de requête​

En-tête​

Charge utile​

Exemples de code​

PDF Fonctionnalités de marge​

Contrôle des marges​

Amélioration des documents​

Cas d'utilisation et applications industrielles​

Obtenez de l'aide​