Metin Damgası Ekle PDF - Metin Filigranı API
PDF4me Metin Damgası Ekle PDF Bu özellik, özelleştirilebilir metin filigranları eklemenizi sağlar. PDF Yetkilendirme ve korsanlıkla mücadele için belgeler. Bu API hizmet süreçleri PDF Dosyalara metin damgaları ekler ve metin, konum, stil, döndürme ve görünüm üzerinde kontrol sağlar. API alır PDF içerik aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Bu çözüm, belge markalama, telif hakkı koruması, durum göstergeleri ve kurumsal uygulamalar için idealdir. PDF iş akışları.
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
- Esnek KonumlandırmaYatay ve dikey hizalamayı piksel hassasiyetinde kontrol edin.
- Özel StilÇeşitli yazı tipleri, boyutlar, renkler ve metin efektleri (kalın, italik, altı çizili) arasından seçim yapın.
- Gelişmiş BiçimlendirmeŞeffaflık, döndürme, kenar boşlukları ve arka plan seçeneklerini ayarlayın.
- Sayfa HedeflemeBelirli sayfalara veya tüm belgelere damga uygulayın.
- Yazdırma KontrolüDamgaların yalnızca basılı veya ekranda görünmesini yapılandırın.
- Profesyonel SonuçlarBelge güvenliğini ve marka bilinirliğini artıran filigranlar oluşturun.
- Asenkron İşlemeUzun süren işlemler için yoklama yöntemiyle eşzamansız işlemeyi destekleme
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm metin damgası ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POSTALAMAK
- Uç nokta:
/api/v2/Stamp
Desteklenen Metin Damgalama Özellikleri
O API Çeşitli metin damgalama ve filigranlama özelliklerine kapsamlı destek sağlar:
Metin Özelleştirme Seçenekleri
- Yazı Tipi SeçimiArial, Times New Roman, Helvetica veya Courier New arasından seçim yapın.
- Boyut KontrolüYazı tipi boyutu 8 ile 72 arasında ayarlanabilir.
- Renk Seçenekleri: Hex renk kodlarıyla tam renk spektrumu desteği (örneğin, kırmızı için #FF0000)
- Metin EfektleriKalın, italik ve alt çizgi biçimlendirme seçenekleri
- Özel MetinSemboller ve özel karakterler de dahil olmak üzere her türlü metin içeriğine destek.
Konumlandırma ve Yerleşim
- Yatay HizalamaSol, orta ve sağ konumlandırma seçenekleri
- Dikey HizalamaÜst, orta ve alt yerleştirme kontrolü
- Marj KontrolüHem milimetre hem de piksel tabanlı ölçümlerle hassas konumlandırma
- Dönme DesteğiMetin döndürme: 0 (yatay), 45 (diyagonal), 90 (dikey), -45 (ters diyagonal)
- Esnek YerleştirmeSayfa konumlarının her biri için kesin ölçülerle destek.
Gelişmiş Özellikler
- Opaklık KontrolüFiligranların ince veya belirgin olması için ayarlanabilir şeffaflık (0-100).
- Arka Plan ModuMetni içeriğin arkasına veya önüne yerleştirme seçeneği
- Yazdırma KontrolüDamgaların hem görüntülenip hem de yazdırılmasını veya yalnızca yazdırılmasını yapılandırın.
- Sayfa HedeflemeBelirli sayfalara veya tüm belgelere uygulayın.
- Metin UyumuSayfa sınırlarına uyacak şekilde otomatik metin boyutlandırma (isteğe bağlı)
REST API Parametreler
"Metin Damgası Ekle" işlevi için parametrelerin tam listesi. PDF 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 adı* | Sicim | Çıktı PDF .pdf uzantılı dosya adı | output.pdf |
| belge içeriği* | Base64 | PDF dosya içeriği kodlanmış Base64 | JVBERi... |
| sayfalar* | Sicim | Sayfa seçenekleri: "tümü", "1", "1,3,5", "2-5", "1,3,7-10", "2-" | all |
| metin* | Sicim | Filigran olarak eklenecek metin | CONFIDENTIAL - PDF4me Watermark |
| hizalaX* | Sicim | Yatay hizalama: sol, merkez, veya Sağ | center |
| hizalaY* | Sicim | Dikey hizalama: tepe, orta, veya alt | middle |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| marginXInMM | Sicim | Sol kenardan yatay boşluk (milimetre cinsinden) | 50 |
| marginYInMM | Sicim | Üst kenardan dikey boşluk (milimetre cinsinden) | 50 |
| marginXInPx | Sicim | Sol kenardan yatay boşluk (piksel cinsinden) | 150 |
| marginYInPx | Sicim | Üst kenardan dikey boşluk (piksel cinsinden) | 150 |
| opaklık | Sicim | Opaklık (0-100): 0=görünmez, 100=tamamen opak | 30 |
| yazı tipi adı | Sicim | Yazı tipi adı: Arial, Times New Roman, Helvetica, Kurye Yeni | Arial |
| yazı tipi boyutu | Tamsayı | Yazı tipi boyutu (8-72) | 24 |
| yazı rengi | Sicim | Yazı tipi rengi onaltılık formatta (örneğin, kırmızı için #FF0000) | #FF0000 |
| buztopu | Mantıksal | Metni kalın (doğru) veya normal (yanlış) yap | true |
| italik | Mantıksal | Metni italik (doğru) veya normal (yanlış) yap | false |
| altını çiz | Mantıksal | Metnin altını çiz (doğru) veya çizme (yanlış) | false |
| döndür | Tamsayı | Dönme açısı: 0 (yatay), 45 (diyagonal), 90 (dikey), -45 (ters çapraz) | 45 |
| Arka plan | Mantıksal | Pulun arka plana (doğru) veya ön plana (yanlış) yerleştirilmesi | true |
| yalnızcaBaskıda göster | Mantıksal | Damgayı görünür halde göster ve yazdır (yanlış) veya yalnızca yazdır (doğru) | false |
| enine | Mantıksal | Enine konumlandırma (doğru) veya normal (yanlış) | false |
| fitTextOverPage | Mantıksal | Metni tüm sayfaya sığdır (doğru) veya belirtilen boyutu kullan (yanlış) | false |
| asenkron | Mantıksal | Asenkron işlemeyi etkinleştirin. true, o API 202 durum kodu döndürür ve bir yoklama işlemi sağlar. URL içinde Location başlık | true |
Çıktı
O PDF4me Metin Damgası Ekle PDF REST API İşleme moduna bağlı olarak farklı yanıtlar döndürür. API geri döner PDF olarak Base64-kodlanmış dize içinde JSON formatİkili veri olarak değil.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Senkron İşleme (Varsayılan)
Ne zaman async ayarlanmamış veya ayarlanmış false, o API İsteği hemen işleme koyar:
Durum Kodu: 200 OK
Content-Type: application/json
Yanıt Metni:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}
Yanıt Alanları:
- belge adı (dize): Çıktı PDF dosya adı
- belge içeriği (dize): The PDF İçine metin damgası eklenmiş dosya, şu şekilde kodlanmıştır: Base64 sicim
Kullanım Talimatları:
- Çıkarın
docContenttarladan JSON cevap - Şifreyi çöz Base64 ikili veriyi elde etmek için kullanılan dize PDF veri
- Kaydet veya işle PDF Dosyayı gerektiği gibi düzenleyin.
Örnek (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes
Asenkron İşleme
Ne zaman async: true ayarlanmıştır, API İsteği eşzamansız olarak işler:
Durum Kodu: 202 Accepted
Yanıt Başlıkları:
Location: https://api.pdf4me.com/api/v2/Stamp/poll/12345-abcde-67890
Anket Süreci:
- Çıkarın
Location202 yanıtından gelen başlık - Ankete katılın URL kullanarak GET istekler
- Yanıt alana kadar anket yapmaya devam edin. 200 OK durum
- Son yanıt aynı içeriği içermektedir. JSON format ile
docNameVedocContent(Base64)
Anket Örneği:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const data = await pollResponse.json();
// Process data.docContent (Base64 PDF)
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Hata Yanıtları
O API standart iadeler HTTP Hata kodları ve hata detayları:
- Geçersiz istek parametreleri
- Gerekli alanlar eksik (
belge içeriği,belge adı,sayfalar,metin,hizalaX,hizalaY) - Geçersiz Base64 kodlamada
belge içeriği - Geçersiz hizalama değerleri (alignX için "sol", "orta", "sağ"; alignY için "üst", "orta", "alt" olmalıdır)
- Geçersiz yazı tipi boyutu (8-72 arasında olmalıdır)
- Geçersiz saydamlık değeri (0-100 arasında olmalıdır)
- 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ı
- PDF işlem hatası
- Metin damgası 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 değil PDF verileri doğrudan.
Yanıt Yapısı:
{
"docName": "string", // Output PDF filename
"docContent": "string" // Base64-encoded PDF content
}
Content-Type Başlık:
- Başarı:
application/json - O PDF gömülüdür 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 ile PDF:
JavaScript/Node.js:
const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js
Python:
import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
f.write(pdf_bytes)
C#:
byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);
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):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"pages": "all",
"text": "CONFIDENTIAL - PDF4me Watermark",
"alignX": "center",
"alignY": "middle"
}
Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"pages": "all",
"text": "CONFIDENTIAL - PDF4me Watermark",
"alignX": "center",
"alignY": "middle",
"marginXInMM": "50",
"marginYInMM": "50",
"marginXInPx": "150",
"marginYInPx": "150",
"opacity": "30",
"fontName": "Arial",
"fontSize": 24,
"fontColor": "#FF0000",
"isBold": true,
"isItalics": false,
"underline": false,
"rotate": 45,
"isBackground": true,
"showOnlyInPrint": false,
"transverse": false,
"fitTextOverPage": false,
"async": true
}
Kod Örnekleri
O PDF4me Metin Damgası Ekle PDF 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
Google Script Örnek
Google Apps Script uygulama için Google Workspace entegrasyon:
Metin Damgalama Özellikleri
Özelleştirme Seçenekleri
- Yazı Tipi Kontrolü: Boyut ve renk özelleştirmesi yapılabilen birden fazla yazı tipi ailesi
- Metin EfektleriKalın, italik ve alt çizgi biçimlendirme seçenekleri
- Renk Yönetimi: Hex kodlarıyla tam spektrum renk desteği
- Metin İçeriğiSemboller ve özel karakterler de dahil olmak üzere her türlü metni destekler.
- Profesyonel StilistlikYüksek kaliteli ve net görünürlüklü metin oluşturma
Konumlandırma ve Yerleşim
- Hizalama Kontrolü: Hassas yatay ve dikey hizalama seçenekleri
- Kenar Boşluğu AyarlarıHem milimetre hem de piksel tabanlı konumlandırma
- Dönme Desteği: Çapraz veya açılı filigranlar için metin döndürme
- Esnek YerleştirmeSayfanın herhangi bir konumuna ve yönüne destek.
- Sayfa HedeflemeBelirli sayfalara veya tüm belgelere uygulayın.
Gelişmiş Özellikler
- Opaklık Kontrolüİnce veya belirgin filigranlar için ayarlanabilir şeffaflık
- Arka Plan ModuMetni içeriğin arkasına veya önüne yerleştirme seçeneği
- Yazdırma KontrolüDamgaların yalnızca basılı veya ekranda görünmesini yapılandırın.
- Metin UyumuSayfa sınırlarına uyacak şekilde otomatik metin boyutlandırma
- Enine ModSayfanın tamamına pul uygulayın.
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Business & Enterprise
- Finance & Banking
- Government & Compliance
Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri
- Yasal BelgelerHukuki belgelere yasal sorumluluk reddi ve gizlilik bildirimleri ekleyin.
- Sözleşme DamgasıSözleşmelere ve anlaşmalara durum damgası ekleyin.
- Gizlilik BildirimleriHassas hukuki belgelere gizlilik damgası uygulayın.
- Uyumluluk DamgalarıYasal belgelere mevzuata uygunluk bildirimleri ekleyin.
İşletme ve Kurumsal Kullanım Senaryoları
- Belge MarkalamasıPDF belgelerine şirket logoları, filigranlar ve marka öğeleri ekleyin.
- Durum GöstergeleriBelge durumunu belirtmek için "TASLAK", "GİZLİ" veya "ONAYLANDI" damgalarını ekleyin.
- Rapor OluşturmaOluşturulan belgelere zaman damgaları, sayfa numaraları ve rapor tanımlayıcıları ekleyin.
- Kurumsal Markalaşmaİş belgelerinizde tutarlı bir marka kimliği uygulayın.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal RaporlarFinansal raporlara ve beyanlara durum damgası ekleyin.
- Fatura DamgalamaFaturalara ve satın alma siparişlerine onay damgası vurun.
- Uyumluluk BelgeleriFinansal belgelere düzenleyici onay damgaları ekleyin.
- Denetim İzleriFinansal belgelere zaman damgalı denetim kayıtları oluşturun.
Hükümet ve Uyumluluk Kullanım Örnekleri
- Telif Hakkı KorumasıFikri mülkiyeti korumak için telif hakkı bildirimleri ve mülkiyet damgaları uygulayın.
- Mevzuat Uyumluluğu: Yasal gereklilikleri karşılamak için uygunluk damgaları ekleyin.
- Resmi Belgeler: Devlet belgelerine resmi damga vurun
- Kamu KayıtlarıKamu kayıtlarına ve belgelerine sınıflandırma damgaları ekleyin.