Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Signe PDF - Signature numérique API

PDF4me Signe PDF vous permet d'ajouter des images de signature à PDF Des documents dont on peut contrôler la position, la taille et l'apparence. API processus de service PDF fichiers et ajoute des images de signature à l'aide de Base64 Codage pour une transmission sécurisée. API reçoit PDF contenu et données d'image de signature via REST API Cette solution est idéale pour l'authentification de documents, la conformité légale, les flux de travail métier et l'ajout de signatures visuelles aux documents.

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​

  • Prise en charge de la signature d'image: Ajouter des images de signature personnalisées à PDF documents avec un contrôle total sur le positionnement et la taille
  • Positionnement flexibleContrôlez l'alignement horizontal et vertical avec une précision au pixel près.
  • Tailles personnalisées: Ajuster les dimensions de la signature à l'aide de mesures en millimètres et en pixels
  • Mise en forme avancéeDéfinissez l'opacité, les marges et les options d'arrière-plan pour un rendu professionnel.
  • Ciblage de page: Apposer des signatures à des pages spécifiques ou à des documents entiers
  • Contrôle d'impressionConfigurez les signatures pour qu'elles n'apparaissent qu'à l'impression ou à l'écran.
  • Résultats professionnelsCréez des signatures qui renforcent l'authentification et la sécurité des documents.
  • 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 PDF Les opérations de signature sont effectuées via un point de terminaison unique :

  • Méthode: POST
  • Point final : /api/v2/SignPdf

Soutenu PDF Caractéristiques de la signature​

Le API offre un soutien complet pour divers PDF capacités de signature :

Support d'image de signature​

  • Formats courants: Soutien à JPG, PNGet d'autres formats d'image standard
  • Base64 Encodage: Transmission sécurisée de la signature via Base64 encodage
  • Tailles flexibles: Options de dimensionnement basées sur les millimètres (10-200 mm) et les pixels (20-600 px)
  • Préservation de la qualité: Préserve la qualité d'image emblématique dans PDF sortir

Positionnement et mise en page​

  • Alignement horizontalOptions de positionnement à gauche, au centre et à droite
  • Alignement verticalContrôle du positionnement en haut, au milieu et en bas
  • Contrôle des margesPositionnement précis grâce à des mesures basées sur le millimètre (0-100 mm) et le pixel (0-300 px)
  • Placement flexible: Prise en charge de n'importe quelle position de page avec des mesures exactes
  • Ciblage de pageAppliquer à des pages spécifiques ou à des documents entiers (facultatif)

Fonctionnalités avancées​

  • Contrôle de l'opacitéTransparence réglable (0-100) pour des signatures discrètes ou proéminentes
  • Mode arrière-planPossibilité de placer les signatures derrière ou devant le contenu
  • Contrôle d'impressionConfigurez les signatures pour qu'elles apparaissent en affichage et impression ou en impression seule.
  • Apparence professionnelle: Rendu de signature de haute qualité avec une visibilité claire

REST API Paramètres​

Liste complète des paramètres du signe 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ètreTaperDescriptionExemple
Nom du document*StringSortir PDF Nom de fichier avec l'extension .pdfoutput.pdf
docContent*Base64PDF contenu du fichier encodé en Base64JVBERi...
fichier image*Base64Contenu du fichier image de signature encodé en Base64iVBORw0KGgoAAAANSUhEUgAA...
nom_de_l'image*StringNom du fichier image de signature avec son extension (par exemple, .jpg, .png)signature.jpg
alignerX*StringAlignement horizontal : Gauche, Centre, ou DroiteRight
aligner*StringAlignement vertical : Haut, Milieu, ou BasBottom

Paramètres optionnels​

ParamètreTaperDescriptionExemple
pagesStringOptions de page : « 1 », « 1,3,5 », « 2-5 », « 1,3,7-10 », « 2- ». Si non spécifié, s’applique à toutes les pages.1-3
largeur en mmStringLargeur de la signature en millimètres (10-200)50
hauteur en mmStringHauteur de la signature en millimètres (10-200)25
largeur en pixelsStringLargeur de la signature en pixels (20-600)142
hauteur en pixelsStringHauteur de la signature en pixels (20-600)71
margeXInMMStringMarge horizontale en millimètres (0-100)20
margeYInMMStringMarge verticale en millimètres (0-100)20
margeXInPxStringMarge horizontale en pixels (0-300)57
margeYInPxStringMarge verticale en pixels (0-300)57
opacitéStringOpacité (0-100) : 0 = invisible, 100 = totalement opaque100
afficherUniquementImpriméBooleanAfficher la signature en vue et en impression (vrai) ou en impression seulement (faux)true
estBackgroundBooleanPlacer la signature en arrière-plan (vrai) ou au premier plan (faux)false
asynchroneBooleanActiver le traitement asynchrone. Lorsque true, le API renvoie un statut 202 et fournit un système d'interrogation URL dans le Location en-têtetrue

Sortir​

Le PDF4me Signe 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.

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 signature ajoutée, encodé comme Base64 chaîne

Mode d'emploi :

  1. Extraire le docContent champ du JSON réponse
  2. Décodez le Base64 chaîne permettant d'obtenir le binaire PDF données
  3. 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

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==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

Exemple avancé (avec tous les champs facultatifs) :

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Exemples de code​

Le PDF4me Signe 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# Exemple (CSharp)

Complet C# mise en œuvre pour la signature PDF documents :

PDF Caractéristiques de la signature​

Contrôle de l'image de signature​

  • Prise en charge des formats: JPG, PNG, GIF et autres formats d'image standard
  • Préservation de la qualité: Maintient la qualité et la résolution d'image caractéristiques dans PDF sortir
  • Base64 Encodage: Transmission sécurisée de la signature via Base64 encodage
  • Tailles flexibles: Options de dimensionnement en millimètres et en pixels
  • Apparence professionnelle: Rendu de signature de haute qualité avec une visibilité claire

Positionnement et mise en page​

  • Contrôle d'alignementOptions d'alignement horizontal et vertical précises
  • Paramètres de marge: Positionnement au millimètre et au pixel près
  • Placement flexible: Prise en charge de toute position et orientation de page
  • Ciblage de pageAppliquer à des pages spécifiques ou à des documents entiers
  • Contrôle de la tailleDimensions personnalisables pour un placement optimal

Fonctionnalités avancées​

  • Contrôle de l'opacitéTransparence ajustable pour des signatures discrètes ou proéminentes
  • Mode arrière-planPossibilité de placer les signatures derrière ou devant le contenu
  • Contrôle d'impressionConfigurez les signatures pour qu'elles n'apparaissent qu'à l'impression ou à l'écran.
  • Résultats professionnelsCréez des signatures qui renforcent l'authentification et la sécurité des documents.
  • Positionnement flexibleContrôlez l'alignement horizontal et vertical avec une précision au pixel près.

Cas d'utilisation et applications industrielles​

Cas d'utilisation des services juridiques et professionnels

  • Documentation juridiqueApposer les signatures sur les contrats, accords et documents officiels.
  • Signature du contratSignez les contrats et accords numériquement pour leur validité juridique.
  • Documents judiciairesApposer des signatures numériques aux documents judiciaires et juridiques.
  • Exigences de conformitéRespecter les exigences réglementaires en matière de signature et d'authentification des documents

Obtenez de l'aide​

Get Your API KeyAPI SamplesGetting Started