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.
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
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| belge* | Object | Belge 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* | Base64 | Word belgesinin içeriği kodlanmıştır. Base64 | UEsDBBQABgAIAAAA... |
| filigranMetni* | String | Filigran 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
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| yazı tipi ailesi | String | Filigran metni için yazı tipi ailesi. Yaygın: "Arial", "Calibri", "Times New Roman", "Helvetica". Varsayılan: "Arial" | Arial |
| yazı tipi boyutu | Number (çift) | Yazı tipi boyutu, punto cinsinden (1 ila 1000). Varsayılan: 72 | 72 |
| yazı rengi | String | Metin rengi. Adlandırılmış: "Kırmızı", "Mavi", "Gri". Hex: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Varsayılan: "#808080" | #FF0000 |
| yarı saydam | Boolean | Şeffaflık. true = opaklık %50, false = %100 (varsayılan) | true |
| rotasyon | Number (çift) | Özel döndürme açısı (0-360°). Varsayılan: 0 | 45 |
| yazı tipi adı | String | Filigran metni için yazı tipi adı | Arial |
| oryantasyon | String | Ö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ı | String | Kü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:
- oryantasyon - Eğer belirtilmişse, önceden tanımlanmış yönlendirme açısını kullanır.
- rotasyon - Yön belirtilmezse, özel döndürme açısı kullanılır.
- 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.
- Success Response
- Error Responses
- Response Format Details
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ı:
- Kontrol etmek
success; eğer doğruysa, çıkarındocumenttarladan JSON cevap - Şifreyi çöz Base64 Word belgesinin ikili verilerini elde etmek için kullanılan dize
- 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
Hata Yanıtları
O API standart iadeler HTTP Hata kodları ve hata detayları:
- Geçersiz istek parametreleri
- Gerekli alanlar eksik (
belge,belge içeriği,filigranMetni) filigranMetniBoş, null veya yalnızca boşluk içeremez.- Geçersiz Base64 kodlamada
belge içeriği - Geçersiz veya bozuk Word belgesi
- Geçersiz yazı tipi boyutu (1 ile 1000 arasında olmalıdır)
- Geçersiz dönüş açısı
- Geçersiz veya eksik API anahtar
- API anahtar düzgün değil Base64 kodlanmış Authorization başlık
- Eksik
Yetkilendirme: Temelbaşlık
- Sunucu tarafı işlem hatası
- Word belgesi işleme hatası
- Metin filigranı ekleme hatası
Hata Yanıtı Biçimi:
{
"error": "Error message describing what went wrong"
}
Yanıt Biçimi Ayrıntıları
Önemli: O API her zaman geri döner JSONAsla ikili Word verilerini doğrudan kullanmayın.
Yanıt Yapısı (ApiV2WordApiCallRes):
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": null
}
İçerik Türü Başlığı:
- Başarı:
application/json - Word belgesi şu şekilde yerleştirilmiştir: Base64 dize içinde JSON cevap
Neden Base64?
- JSON-ikili veriler için güvenli kodlama
- İletilmesi kolay HTTP
- Tüm programlama dilleriyle uyumludur.
- Doğrudan içine yerleştirilebilir JSON sorunlardan kaçmadan
Kod çözme Base64 Word Belgesine:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes(response.fileName, 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ınAuthorization: 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Örnek
Tamamlamak C# Word belgelerine metin filigranı eklemek için uygulama:
Google Script Örnek
Google Apps Script uygulama için Google Workspace entegrasyon:
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
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.
İşletme ve Kurumsal Kullanım Senaryoları
- Fiyat ListeleriFiyat listelerine "GİZLİ FİYATLANDIRMA" metin filigranı ekleyin.
- TekliflerMüşteri tekliflerine "© 2024 [Şirket]" ibaresiyle filigran ekleyin.
- İç RaporlarDahili analizleri "SADECE DAHİLİ KULLANIM İÇİN" olarak işaretleyin.
- Taslak Malzemeler"TASLAK - DAĞITILMAYACAKTIR" durumunu belirtin.
Eğitim ve Araştırma Kullanım Örnekleri
- Hasta VerileriHasta kayıtlarına "HIPAA KORUMALI" metin filigranı ekleyin.
- Tıbbi RaporlarLaboratuvar sonuçlarını "GİZLİ TIBBİ" ibaresiyle filigranlayın.
- Araştırma Verileri"ARAŞTIRMA VERİLERİ - GİZLİ" metin filigranlarını uygulayın.
- Sigorta TalepleriSigorta belgelerine "GİZLİLİK KORUMALI" etiketini ekleyin.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal Tablo GüvenliğiFinansal raporlara "GİZLİ" metin filigranı ekleyin.
- Taslak BütçelerTaslak bütçe belgelerine "TASLAK" ibaresi içeren bir filigran ekleyin.
- Denetim BelgeleriDenetim çıktılarına "DENETİM KOPYASI" metin filigranı uygulayın.
- Müşteri RaporlarıMüşteriye yönelik raporlara "© 2024 [Şirket]" metin filigranı ekleyin.