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

Remplacer du texte par une image - Remplacement d'image API

PDF4me Remplacer le texte par une image permet de remplacer du texte par des images dans des documents Word grâce à des options avancées de filtrage de page et de contrôle de la taille. API Ce service traite les fichiers Word et remplace les espaces réservés au texte par des images grâce à une correspondance de texte précise, un dimensionnement personnalisable avec préservation des proportions, un ciblage spécifique à la page et des options de filtrage flexibles. API reçoit le contenu des documents Word et les données d'image via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Grâce à la prise en charge de nombreux formats d'image et à un contrôle total du comportement de remplacement, cette solution est idéale pour l'automatisation des documents, le traitement des modèles et les flux de travail d'insertion dynamique de contenu.

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​

  • Remplacement de texte en image: Remplacer des chaînes de caractères spécifiques par des images dans l'ensemble des documents
  • Correspondance précise de texte: Recherche et remplacement de texte sensibles à la casse
  • Contrôle de la taille de l'imagePersonnalisez les dimensions de l'image avec les paramètres de largeur et de hauteur.
  • Préservation du rapport d'aspectConserver les proportions de l'image lors du redimensionnement
  • Filtrage des pages: Cibler des pages ou des plages de pages spécifiques à remplacer
  • Filtrage avancé: Ignorer la première page, cibler les pages paires/impaires ou spécifier les numéros de page exacts
  • Formats d'image multiples: Soutien à PNG, JPG, JPEG, BMP, GIF formats
  • Positionnement flexible: Insérez des images sous forme de formes Word avec un positionnement précis

REST API Point de terminaison​

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

  • Méthode: POST
  • Point final : office/ApiV2Word/ReplaceTextWithImage

REST API Paramètres​

Liste complète des paramètres pour le remplacement de texte par une image 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. Les paramètres avancés permettent un contrôle précis du dimensionnement des images et du filtrage des pages.

Paramètres requis​

ParamètreTaperDescriptionExemple
document*ObjectDescription du document. Doit inclure Nom (string): Nom du fichier Word de sortie avec l'extension .docx{ "Name": "document.docx" }
docContent*Base64Contenu du document Word encodé en Base64Un remplacement de texte est effectué sur ce document. Doit être un document Word valide (formats .docx ou .doc).base64EncodedDocumentContent
trouverTexte*StringChaîne de texte à rechercher dans le document. Sensible à la casse. Toutes les occurrences seront remplacées par l'image. Ne peut être nulle ni vide. Exemples : « [LOGO] », « SIGN_HERE »."text to replace"
contenu de l'image*Base64Contenu du fichier image de remplacement encodé en Base64. Doit être une image valide (PNG, JPG, JPEG, BMP, GIF)base64EncodedImageContent

Paramètres optionnels​

ParamètreTaperDescriptionExemple
largeurNombre (double)Largeur de l'image200
hauteurNombre (double)Hauteur de l'image100
maintenirAspectRatioBooleanConserver les proportions de l'image lors du redimensionnement. Valeur par défaut : vraitrue
skipFirstPageBooleanIgnorer le remplacement sur la première page. true = passer la première page, false = inclure (par défaut). Utile pour les pages de couverture/titrefalse
postulerStringLunette de visée de remplacement-
Numéros de pageStringNuméros de page ou plages de pages spécifiques (par exemple, « 1,2,3 » ou « 1,3,5-7 »). Vide = toutes les pages"1,2,3"
ignorer les numéros de pageStringNuméros de page à exclure du remplacement-
nom de la cultureStringCode culturel (par exemple, « en-US », « fr-FR », « de-DE »). Par défaut : nulen-US

Filtrage des pages​

Le API prend en charge le filtrage des pages via les paramètres suivants :

  • skipFirstPage: Permet de contrôler si la première page doit être ignorée
  • Numéros de page: Spécifie les pages à traiter (chaîne vide = toutes les pages)
  • ignorer les numéros de pageNuméros de page à exclure

Formats d'image pris en charge​

Remplacer le texte par une image API prend en charge différents formats d'image pour une compatibilité maximale :

FormatExtensionDescription
PNG.pngPortable Network Graphics (PNG) – idéal pour les logos et les graphiques avec transparence.
JPEG.jpg, .jpegGroupe d'experts photographiques conjoint - idéal pour les photographies et les images complexes
BMP.bmpBitmap - format non compressé, fichiers plus volumineux
GIF.gifFormat d'échange graphique (GIF) - prend en charge l'animation et la transparence

Sortir​

Le PDF4me Remplacer le texte par une image REST API renvoie un JSON réponse (ApiV2WordApiCallRes). En cas de succès, API renvoie le document Word sous forme de Base64chaîne encodée dans le document champ, et non sous forme de données binaires.

Réponse réussie

Code d'état : 200 OK

Type de contenu : application/json

Corps de la réponse :

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}

Champs de réponse :

  • document (string): Le document Word dont le texte a été remplacé par des images, encodé comme Base64
  • nom de fichier (string): Le nom du fichier Word de sortie
  • succès (boolean): Si l'opération a réussi
  • message d'erreur (string): Message d'erreur en cas d'échec ; sinon, valeur nulle

Mode d'emploi :

  1. Vérifier success; si vrai, extraire le document champ du JSON réponse
  2. Décodez le Base64 chaîne permettant d'obtenir les données binaires d'un document Word
  3. Enregistrez ou traitez le fichier Word en utilisant fileName

Exemple (JavaScript) :

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// Save or process wordBytes

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) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "cultureName": "en-US"
}

Exemple avancé (avec champs facultatifs) :

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "width": 200,
 "height": 100,
 "maintainAspectRatio": true,
 "skipFirstPage": true,
 "pageNumbers": "1,2,3",
 "ignorePageNumbers": null,
 "cultureName": "en-US"
}

Exemples de code​

Le PDF4me Remplacer le texte par une image 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# Mise en œuvre d'une méthode de remplacement du texte par des images dans les documents Word :

Cas d'utilisation et applications industrielles​

Cas d'utilisation des services juridiques et professionnels

  • Traitement des contrats: Remplacer les espaces réservés aux signatures par des signatures autorisées
  • Automatisation des documents juridiquesInsérer les logos et filigranes de l'entreprise dans les documents juridiques
  • Personnalisation des documents clients: Ajouter des images spécifiques au client aux documents juridiques
  • Documentation de conformitéApposer les cachets et sceaux de conformité sur les documents

Obtenez de l'aide​

Get Your API KeyAPI SamplesGetting Started