Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Metni Resimle Değiştir - Resim Değiştirme API

PDF4me Metni Resimle Değiştir Bu özellik, gelişmiş sayfa filtreleme ve boyut kontrolü seçenekleriyle Word belgelerinde belirtilen metni resimlerle değiştirmenizi sağlar. API Bu hizmet, Word dosyalarını işler ve metin yer tutucularını, hassas metin eşleştirme, en boy oranını koruyarak özelleştirilebilir boyutlandırma, sayfaya özgü hedefleme ve esnek filtreleme seçeneklerini kullanarak resimlerle değiştirir. API Word belgesi içeriğini ve görüntü verilerini şu yollarla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Çoklu görüntü formatlarını destekleyen ve değiştirme davranışı üzerinde tam kontrol sağlayan bu çözüm, belge otomasyonu, şablon işleme ve dinamik içerik ekleme iş akışları için idealdir.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek​

Erişmek için PDF4me REST APIHer istek, geçerli kimlik doğrulama bilgilerini içermelidir. Kimlik doğrulama, güvenli iletişimi sağlar ve yetkili bir kullanıcı olarak kimliğinizi doğrular. REST API.

Get your api Key

Başlıca Özellikler​

  • Metni Görüntüye DönüştürmeBelgeler genelinde belirli metin dizelerini resimlerle değiştirin.
  • Hassas Metin EşleştirmeBüyük/küçük harf duyarlı metin arama ve değiştirme
  • Görüntü Boyutu KontrolüGörüntü boyutlarını genişlik ve yükseklik parametreleriyle özelleştirin.
  • En Boy Oranının KorunmasıGörüntü boyutlandırma sırasında görüntü oranlarını koruyun.
  • Sayfa Filtreleme: Değiştirilecek belirli sayfaları veya sayfa aralıklarını hedefleyin
  • Gelişmiş Filtreleme: İlk sayfayı atla, tek/çift sayfaları hedefle veya tam sayfa numaralarını belirt.
  • Çoklu Görüntü Formatları: Desteklemek için PNG, JPG, JPEG, BMP, GIF formatlar
  • Esnek KonumlandırmaResimleri, hassas konumlandırma ile Word şekilleri olarak ekleyin.

REST API Uç nokta​

O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm metinden resme dönüştürme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:

  • Yöntem: POST
  • Uç nokta: office/ApiV2Word/ReplaceTextWithImage

REST API Parametreler​

Metni Resimle Değiştir işlevi için tüm parametrelerin tam listesi. REST APIParametreler, daha iyi anlaşılması ve uygulanması için kategoriye göre düzenlenmiştir.

Önemli: Yıldız (*) ile işaretlenmiş parametreler zorunludur. Gelişmiş parametreler, görüntü boyutlandırma ve sayfa filtreleme üzerinde ayrıntılı kontrol sağlar.

Gerekli Parametreler​

ParametreTipTanımÖrnek
belge*ObjectBelge tanımlayıcısı. Şunları içermelidir: İsim (string): Çıktı Word dosya adı .docx uzantısıyla{ "Name": "document.docx" }
belge içeriği*Base64Word belgesinin içeriği kodlanmıştır. Base64Bu belgede metin değiştirme işlemi gerçekleştirilecektir. Geçerli bir Word belgesi olmalıdır (.docx, .doc formatları).base64EncodedDocumentContent
findText*StringBelgede aranacak metin dizesi. Büyük/küçük harf duyarlıdır. Tüm örnekler resimle değiştirilecektir. Boş veya null olamaz. Örnekler: "[LOGO]", "BURAYA İMZA ATIN""text to replace"
resim içeriği*Base64Değiştirilecek görüntü dosyasının içeriği şu şekilde kodlanmıştır: Base64Geçerli bir resim olmalıdır (PNG, JPG, JPEG, BMP, GIF)base64EncodedImageContent

İsteğe bağlı parametreler​

ParametreTipTanımÖrnek
GenişlikSayı (çift)Görüntü genişliği200
yükseklikSayı (çift)Görüntü yüksekliği100
En boy oranını koruBooleanYeniden boyutlandırma sırasında görüntü oranlarını koruyun. Varsayılan: truetrue
İlk sayfayı atlaBooleanİlk sayfadaki değiştirme işlemini atla. true = ilk sayfayı atla, false = dahil et (varsayılan). Kapak/başlık sayfaları için kullanışlıdır.false
uygulaStringDeğiştirme için hedef kapsam-
sayfa numaralarıStringBelirli sayfa numaraları veya aralıkları (örneğin, "1,2,3" veya "1,3,5-7"). Boş = tüm sayfalar"1,2,3"
Sayfa numaralarını yok sayStringDeğiştirme işleminden hariç tutulacak sayfa numaraları-
kültürAdıStringKültür kodu (ör. "en-US", "fr-FR", "de-DE"). Varsayılan: boşen-US

Sayfa Filtreleme​

O API Aşağıdaki parametreler aracılığıyla sayfa filtrelemeyi destekler:

  • İlk sayfayı atlaİlk sayfayı atlayıp atlamama kontrolünü sağlar.
  • sayfa numaralarıİşlenecek sayfaları belirtir (boş dize = tüm sayfalar)
  • Sayfa numaralarını yok sayHariç tutulacak sayfa numaraları

Desteklenen Görüntü Formatları​

Metni Resimle Değiştir API Maksimum uyumluluk için çeşitli görüntü formatlarını destekler:

BiçimEklentiTanım
PNG.pngTaşınabilir Ağ Grafikleri (PNG) - logolar ve şeffaflık içeren grafikler için en iyisi.
JPEG.jpg, .jpegOrtak Fotoğraf Uzmanları Grubu - fotoğraflar ve karmaşık görüntüler için en iyisi
BMP.bmpBitmap - sıkıştırılmamış format, daha büyük dosya boyutları
GIF.gifGrafik Değişim Formatı - animasyon ve şeffaflığı destekler

Çıktı​

O PDF4me Metni Resimle Değiştir REST API bir döndürür JSON cevap (ApiV2WordApiCallResBaşarı durumunda API Word belgesini şu şekilde döndürür: Base64-kodlanmış dize içinde document ikili veri olarak değil, alan olarak.

Başarılı Yanıt

Durum Kodu: 200 OK

İçerik Türü: application/json

Yanıt Metni:

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

Yanıt Alanları:

  • belge (string): Metnin resimlerle değiştirildiği Word belgesi, şu şekilde kodlanmıştır: Base64
  • dosya adı (string): Çıktı Word dosyasının adı
  • başarı (booleanOperasyonun başarılı olup olmadığı
  • hataMesajı (string): Başarı başarısız olursa hata mesajı; aksi halde boş değer.

Kullanım Talimatları:

  1. Kontrol etmek success; eğer doğruysa, şunu çıkarın document tarladan JSON cevap
  2. Şifreyi çöz Base64 Word belgesinin ikili verilerini almak için kullanılan dize
  3. Word dosyasını şu şekilde kaydedin veya işleyin: fileName

Örnek (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

Talep Örneği​

Başlık​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Not:

  • Alın API anahtardan PDF4me Kontrol Paneli
  • O API anahtar olmalı Base64 "Basic" önekiyle kodlanmış ve ön eklenmiş Authorization başlık
  • Örnek: Eğer sizin API anahtar şudur abc123onu kodla Base64 ve kullanın Authorization: Basic YWJjMTIz

Yük​

Temel Örnek (Sadece Gerekli Alanlar):

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

Gelişmiş Örnek (İsteğe Bağlı Alanlarla):

{
 "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"
}

Kod Örnekleri​

O PDF4me Metni Resimle Değiştir REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:

C# (CSharp) Örnek

Tamamlamak C# Word belgelerindeki metni resimlerle değiştirme uygulaması:

Sektör Kullanım Örnekleri ve Uygulamaları​

Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri

  • Sözleşme İşlemeİmza yer tutucularını yetkili imzalarla değiştirin.
  • Hukuk Belgelerinin OtomasyonuHukuki belgelere şirket logoları ve filigranları ekleyin.
  • Müşteri Belgesi Kişiselleştirme: Hukuki belgelere müşteriye özel görseller ekleyin
  • Uyumluluk BelgeleriBelgelere uygunluk damgaları ve mühürleri ekleyin.

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started