Ana içeriğe geç

Word'e Metin Filigranı Ekle - Metin Filigranı API

PDF4me Word'e Metin Filigranı Ekle Bu özellik, kapsamlı stil ve konumlandırma kontrolüyle Word belgelerine özelleştirilebilir metin filigranları eklemenizi sağlar. API Bu hizmet, Word dosyalarını işler ve metin içeriği, yazı tipi ailesi, yazı tipi boyutu, renkler, döndürme açıları, yönlendirme ön ayarları ve şeffaflık seviyeleri üzerinde tam kontrol sağlayarak metin filigranları ekler. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Güvenlik etiketleri, marka öğeleri, gizlilik bildirimleri ve durum işaretleyicileri desteğiyle bu çözüm, belge güvenliği, marka koruması ve durum göstergesi 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.

Başlıca Özellikler

  • Metin Filigran DesteğiÖzel metin içeriğine sahip profesyonel metin filigranları.
  • Yazı Tipi ÖzelleştirmeYazı tipi ailesi, yazı tipi adı ve yazı tipi boyutu üzerinde tam kontrol.
  • Renk Seçenekleri: Adlandırılmış renkler, onaltılık kodlar, RGB değerleri ve 3 haneli onaltılık sayı desteği
  • Dönme KontrolüÖzel döndürme açıları (0-360°) veya önceden tanımlanmış yönlendirme ayarları
  • Şeffaflık SeçenekleriYarı saydam veya tamamen opak filigran efektleri
  • Otomatik BoyutlandırmaMetin uzunluğuna ve yazı tipi boyutuna göre akıllı boyutlandırma
  • Belge genelinde uygulamaFiligranlar tüm bölümlere ve başlıklara uygulanmıştır.
  • Metin Yerleşiminin ArkasındakiFiligranlar belge içeriğinin arkasına yerleştirilmiştir.

REST API Uç nokta

O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm metin filigran ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:

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

REST API Parametreler

Word'e Metin Filigranı Ekleme işlevinin parametrelerinin 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 ve mutlaka sağlanmalıdır. API doğru şekilde çalışması için.

Gerekli Parametreler

ParametreTipTanımÖrnek
belge*ObjectBelge tanımlayıcısı. Mutlaka içermelidir. İsim (dize): .docx uzantılı Word dosyasının çıktı adı{ "Name": "document.docx" }
belge içeriği*Base64Word belgesinin içeriği kodlanmıştır. Base64UEsDBBQABgAIAAAA...
filigranMetni*StringFiligran olarak görüntülenecek metin. Zorunlu - boş, geçersiz veya yalnızca boşluktan oluşamaz. Örnekler: "GİZLİ", "TASLAK", "ONAYLANDI"CONFIDENTIAL

İsteğe bağlı parametreler

ParametreTipTanımÖrnek
yazı tipi ailesiStringFiligran metni için yazı tipi ailesi. Yaygın: "Arial", "Calibri", "Times New Roman", "Helvetica". Varsayılan: "Arial"Arial
yazı tipi boyutuNumber (çift)Yazı tipi boyutu, punto cinsinden (1 ila 1000). Varsayılan: 7272
yazı rengiStringMetin rengi. Adlandırılmış: "Kırmızı", "Mavi", "Gri". Hex: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Varsayılan: "#808080"#FF0000
yarı saydamBooleanŞeffaflık. true = opaklık %50, false = %100 (varsayılan)true
rotasyonNumber (çift)Özel döndürme açısı (0-360°). Varsayılan: 045
yazı tipi adıStringFiligran metni için yazı tipi adıArial
oryantasyonStringÖnceden tanımlanmış yönlendirme: Yatay (0°), Dikey (90°), Diyagonal (45°), Tersine (180°). Sağlanmışsa döndürme işlemini geçersiz kılar.Diagonal
kültürAdıStringKültür kodu (ör. "en-US", "de-DE", "fr-FR"). Varsayılan: boşen-US

Metin Yönlendirme Seçenekleri

Filigran metninin yönü şu parametre önceliğine göre belirlenir:

  1. oryantasyon - Eğer belirtilmişse, önceden tanımlanmış yönlendirme açısını kullanır.
  2. rotasyon - Yön belirtilmezse, özel döndürme açısı kullanılır.
  3. Varsayılan - İkisi de belirtilmemişse, 0° (yatay) kullanılır.

Önceden Tanımlanmış Yönlendirmeler:

  • Yatay: 0° (varsayılan)
  • Dikey: 90°
  • Diyagonal: 45°
  • Tersine: 180°

Çıktı

O PDF4me Word'e Metin Filigranı Ekle REST API bir döndürür JSON yanıt (ApiV2WordApiCallRes). Başarılı olursa 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 Tamam

İçerik Türü: application/json

Yanıt Metni:

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

Yanıt Alanları:

  • belge (dize): Üzerine metin filigranı uygulanmış Word belgesi, şu şekilde kodlanmıştır: Base64
  • dosya adı (dize): Çıktı Word dosyasının adı
  • başarı (mantıksal): İşlemin başarılı olup olmadığı
  • hataMesajı (dize): 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, çıkarın document tarladan JSON cevap
  2. Şifreyi çöz Base64 Word belgesinin ikili verilerini elde etmek 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": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"watermarkText": "CONFIDENTIAL"
}

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

{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"watermarkText": "CONFIDENTIAL",
"orientation": "Diagonal",
"fontFamily": "Arial",
"fontSize": 72,
"fontColor": "#FF0000",
"semiTransparent": true,
"cultureName": "en-US"
}

Özel Döndürme Örneği:

{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"watermarkText": "DRAFT",
"fontFamily": "Times New Roman",
"fontSize": 48,
"fontColor": "Gray",
"rotation": 45,
"semiTransparent": true
}

Kod Örnekleri

O PDF4me Word'e Metin Filigranı Ekle 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 belgelerine metin filigranı eklemek için uygulama:

Sektör Kullanım Örnekleri ve Uygulamaları

Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri

  • Gizli BelgelerHukuki belgelere "GİZLİ" ibaresi içeren filigran ekleyin.
  • Sözleşme TaslaklarıTaslak sözleşmeleri "TASLAK - İNCELEME AŞAMASINDA" durumuyla işaretleyin.
  • Ayrıcalık Etiketleri"AVUKAT-MÜVEKKİL GİZLİLİĞİ" metin filigranlarını uygulayın.
  • Durum İşaretleyicileri"ONAYLANDI" veya "İNCELEME BEKLİYOR" durumunu belirtin.

Yardım Alın