Resim damgası ekle PDF - Filigran API
PDF4me Resim damgası ekle PDF Bu özellik, özelleştirilebilir resim damgaları ve filigranlar eklemenizi sağlar. PDF Belgeler. Bu API hizmet süreçleri PDF Dosyalara hassas konumlandırma, özel boyutlandırma ve biçimlendirme seçenekleriyle resim filigranları ekler; bu sayede belge markalaması ve güvenliği sağlanır. API alır PDF içerik ve görüntü verileri aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Esnek konumlandırma, özel boyutlandırma, sayfa hedefleme ve yazdırma kontrolü desteğiyle bu çözüm, belge markalama, telif hakkı koruması 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
- Görsel Filigran DesteğiÖzel görselleri filigran ve damga olarak ekleyin. PDF belgeler
- Esnek KonumlandırmaYatay ve dikey hizalamayı piksel hassasiyetinde kontrol edin.
- Özel BoyutlandırmaGörüntü boyutlarını hem milimetre hem de piksel ölçülerini kullanarak ayarlayın.
- Gelişmiş BiçimlendirmeProfesyonel bir görünüm için saydamlık, 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 görsel filigranlar oluşturun.
- Sorunsuz API Entegrasyon: REST API otomatikleştirme için tasarlanmıştır PDF düzenleme iş akışları ve kurumsal sistem entegrasyonu
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm resim damgası ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
/api/v2/ImageStamp
Görüntü Damgalama Özellikleri
Görüntü Formatı Desteği
- Yaygın Biçimler: Desteklemek için JPG, PNGGIF ve diğer standart resim formatları
- Base64 Kodlama: Güvenli görüntü iletimi yoluyla Base64 kodlama
- Boyut KontrolüHem milimetre (10-200 mm) hem de piksel tabanlı (20-600 piksel) boyutlandırma seçenekleri mevcuttur.
Konumlandırma ve Yerleşim
- Yatay HizalamaSol, Orta veya Sağ konumlandırma seçenekleri
- Dikey HizalamaÜst, Orta veya Alt yerleştirme kontrolü
- Marj KontrolüHem milimetre (0-100 mm) hem de piksel tabanlı (0-300 piksel) ölçümlerle hassas konumlandırma.
- Sayfa Hedefleme: Sayfa seçeneklerini kullanarak belirli sayfalara uygulayın (tüm sayfalar için boş dize, "1", "1,3,5", "2-5", "1,3,7-10", "2-")
Gelişmiş Özellikler
- Opaklık KontrolüŞeffaflık ayarı (0-100): 0=görünmez, 100=tamamen opak
- Arka Plan Modu: Görselleri arkaya yerleştirme seçeneği (
isBackground: true) veya önünde (isBackground: falseiçerik - Yazdırma Kontrolü: Pulların yalnızca basılı olarak görünmesini yapılandırın (
showOnlyInPrint: true) veya görüntüleme ve yazdırma modunda (showOnlyInPrint: false) - Asenkron İşlemeUzun süren işlemler için yoklama yöntemiyle eşzamansız işlemeyi destekleme
REST API Parametreler
"Görüntü 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ı* | String | Çıktı PDF .pdf uzantılı dosya adı | output.pdf |
| belge içeriği* | Base64 | Girişin içeriği PDF dosya şu şekilde kodlanmıştır: Base64 | JVBERi... |
| resim adı* | String | Uzantısıyla birlikte resim dosyasının adı (örneğin, .png, .jpg) | stamp.png |
| resim dosyası* | Base64 | Görüntü dosyasının içeriği şu şekilde kodlanmıştır: Base64 format | iVBORw0KGgoAAAANS... |
| hizalaX* | String | Yatay hizalama: Sol, Merkez, veya Sağ | Center |
| hizalaY* | String | Dikey hizalama: Tepe, Orta, veya Alt | Middle |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| sayfalar | String | Sayfa seçenekleri: tüm sayfalar için boş metin, "1" 1. sayfa için, "1,3,5" belirli sayfalar için, "2-5" sayfa aralığı için, "1,3,7-10" karışık için, "2-" 2. sayfadan son sayfaya kadar | "" veya "1-3" |
| yükseklik (mm) | String | Görüntü yüksekliği milimetre cinsinden (10-200) | 30 |
| genişlik (mm) | String | Görüntü genişliği milimetre cinsinden (10-200) | 30 |
| yükseklikInPx | String | Görüntü yüksekliği piksel cinsinden (20-600) | 85 |
| genişlikInPx | String | Görüntü genişliği piksel cinsinden (20-600) | 85 |
| marginXInMM | String | Yatay kenar boşluğu milimetre cinsinden (0-100) | 10 |
| marginYInMM | String | Dikey kenar boşluğu milimetre cinsinden (0-100) | 10 |
| marginXInPx | String | Yatay kenar boşluğu piksel cinsinden (0-300) | 28 |
| marginYInPx | String | Dikey kenar boşluğu piksel cinsinden (0-300) | 28 |
| opaklık | Integer | Şeffaflık seviyesi (0-100): 0=görünmez, 100=tamamen opak | 50 |
| Arka plan | Boolean | Pulun arka plana (doğru) veya ön plana (yanlış) yerleştirilmesi | true |
| yalnızcaBaskıda göster | Boolean | Yalnızca yazdırmada göster (doğru) veya görüntüleme ve yazdırmada göster (yanlış) | false |
| asenkron | Boolean | 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 Resim 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 Üzerine resim damgası uygulanmış 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/ImageStamp/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 adı,belge içeriği,resim adı,resim dosyası,hizalaX,hizalaY) - Geçersiz Base64 kodlamada
belge içeriğiveyaresim dosyası - Geçersiz hizalama değerleri (alignX için Sol/Orta/Sağ, alignY için Üst/Orta/Alt olmalıdır)
- Geçersiz boyut veya kenar boşluğu değerleri (izin verilen aralıkların dışında)
- 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ı
- Görüntü damgası uygulama 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==",
"imageName": "stamp.png",
"imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"alignX": "Center",
"alignY": "Middle"
}
Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"imageName": "stamp.png",
"imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
"alignX": "Center",
"alignY": "Middle",
"pages": "",
"heightInMM": "30",
"widthInMM": "30",
"heightInPx": "85",
"widthInPx": "85",
"marginXInMM": "10",
"marginYInMM": "10",
"marginXInPx": "28",
"marginYInPx": "28",
"opacity": 50,
"isBackground": true,
"showOnlyInPrint": false,
"async": true
}
Kod Örnekleri
O PDF4me Resim 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:
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 resimli damga ekleyin.
- Gizlilik BildirimleriHassas hukuki belgelere gizlilik damgası uygulayın.
- Uyumluluk DamgalarıYasal belgelere mevzuata uyumlulukla ilgili görsel uyarılar 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" görsel 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 kurumsal kimlik uygulayın.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal RaporlarFinansal raporlara ve beyanlara resimli damgalar ekleyin.
- Fatura DamgalamaFaturalara ve satın alma siparişlerine onay görsel damgası uygulayın.
- Uyumluluk BelgeleriFinansal belgelere düzenleyici görsel damgaları ekleyin.
- Denetim İzleriFinansal belgelerde görüntü zaman damgası içeren denetim izleri oluşturun.
Hükümet ve Uyumluluk Kullanım Örnekleri
- Telif Hakkı KorumasıFikri mülkiyeti korumak için telif hakkı bildirimleri ve sahiplik görsel damgaları uygulayın.
- Mevzuat Uyumluluğu: Yasal gereklilikleri karşılamak için uyumluluk görsel damgaları ekleyin.
- Resmi BelgelerResmi belgelere resmi damga vurun.
- Kamu KayıtlarıKamu kayıtlarına ve belgelerine sınıflandırma görsel damgaları ekleyin.