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

İmza PDF - Dijital İmza API

PDF4me İmza PDF İmza görselleri eklemenizi sağlar PDF Konum, boyut ve görünüm üzerinde kontrol sağlayan belgeler. API hizmet süreçleri PDF Dosyaları oluşturur ve imza görsellerini ekler. Base64 Güvenli iletim için kodlama. API alır PDF içerik ve imza görsel verileri aracılığıyla REST API Bu çözüm, belge doğrulama, yasal uyumluluk, iş akışları ve belgelere görsel imza ekleme 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​

  • Görüntü İmza DesteğiÖzel imza görselleri ekleyin PDF Konumlandırma ve boyutlandırma üzerinde tam kontrol sağlayan belgeler
  • Esnek KonumlandırmaYatay ve dikey hizalamayı piksel hassasiyetinde kontrol edin.
  • Özel Boyutlandırmaİmza 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 Hedeflemeİmzaları belirli sayfalara veya belgelerin tamamına uygulayın.
  • Yazdırma Kontrolüİmzaların yalnızca basılı veya ekranda görünmesini yapılandırın.
  • Profesyonel SonuçlarBelgelerin doğrulanmasını ve güvenliğini artıran imzalar 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 kurmanın tüm yöntemleri. PDF İmzalama işlemleri tek bir uç nokta üzerinden gerçekleştirilir:

  • Yöntem: POST
  • Uç nokta: /api/v2/SignPdf

Desteklendi PDF İmzalama Özellikleri​

O API çeşitli konularda kapsamlı destek sağlar. PDF imzalama yetenekleri:

İmza Görsel Desteği​

  • Yaygın Biçimler: Desteklemek için JPG, PNGve diğer standart görüntü formatları
  • Base64 Kodlama: Güvenli imza iletimi yoluyla Base64 kodlama
  • Esnek BoyutlandırmaHem milimetre (10-200 mm) hem de piksel (20-600 piksel) tabanlı boyutlandırma seçenekleri mevcuttur.
  • Kalite Koruma: İmza niteliğindeki görüntü kalitesini korur PDF çıktı

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 (0-100 mm) hem de piksel (0-300 piksel) tabanlı ölçümlerle hassas konumlandırma.
  • Esnek YerleştirmeSayfa konumlarının her biri için kesin ölçülerle destek.
  • Sayfa Hedefleme: Belirli sayfalara veya tüm belgelere uygulayın (isteğe bağlı)

Gelişmiş Özellikler​

  • Opaklık Kontrolüİnce veya belirgin imzalar için ayarlanabilir şeffaflık (0-100).
  • Arka Plan Moduİmza ekleme seçeneği: İmzaları içeriğin arkasına veya önüne yerleştirme seçeneği.
  • Yazdırma Kontrolüİmza seçeneklerinin hem görüntülenmesini hem de yazdırılmasını veya yalnızca yazdırılmasını yapılandırın.
  • Profesyonel GörünümYüksek kaliteli, net görünürlüklü imza tasarımı

REST API Parametreler​

İşaret 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​

ParametreTipTanımÖrnek
belge adı*StringÇıktı PDF .pdf uzantılı dosya adıoutput.pdf
belge içeriği*Base64PDF dosya içeriği kodlanmış Base64JVBERi...
resim dosyası*Base64İmza görsel dosyasının içeriği kodlanmıştır. Base64iVBORw0KGgoAAAANSUhEUgAA...
resim adı*Stringİmza görselinin dosya adı ve uzantısı (örneğin, .jpg, .png)signature.jpg
hizalaX*StringYatay hizalama: Sol, Merkez, veya SağRight
hizalaY*StringDikey hizalama: Tepe, Orta, veya AltBottom

İsteğe bağlı parametreler​

ParametreTipTanımÖrnek
sayfalarStringSayfa seçenekleri: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Belirtilmediği takdirde tüm sayfalara uygulanır.1-3
genişlik (mm)Stringİmza genişliği milimetre cinsinden (10-200)50
yükseklik (mm)Stringİmza yüksekliği milimetre cinsinden (10-200)25
genişlikInPxStringİmza genişliği piksel cinsinden (20-600)142
yükseklikInPxStringİmza yüksekliği piksel cinsinden (20-600)71
marginXInMMStringYatay kenar boşluğu milimetre cinsinden (0-100)20
marginYInMMStringDikey kenar boşluğu milimetre cinsinden (0-100)20
marginXInPxStringYatay kenar boşluğu piksel cinsinden (0-300)57
marginYInPxStringPiksel cinsinden dikey kenar boşluğu (0-300)57
opaklıkStringOpaklık (0-100): 0=görünmez, 100=tamamen opak100
yalnızcaBaskıda gösterBooleanİmzayı görünür şekilde göster ve yazdır (doğru) veya yalnızca yazdır (yanlış)true
Arka planBooleanİmzayı arka plana (doğru) veya ön plana (yanlış) yerleştirin.false
asenkronBooleanAsenkron 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ıktrue

Çıktı​

O PDF4me İmza 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.

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 İmza eklenmiş dosya, şu şekilde kodlanmıştır: Base64 sicim

Kullanım Talimatları:

  1. Çıkarın docContent tarladan JSON cevap
  2. Şifreyi çöz Base64 ikili veriyi elde etmek için kullanılan dize PDF veri
  3. 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

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):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Kod Örnekleri​

O PDF4me İmza PDF REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:

C# (CSharp) Örnek

Tamamlamak C# imzalama için uygulama PDF Belgeler:

PDF İmzalama Özellikleri​

İmza Görüntü Kontrolü​

  • Biçim Desteği: JPG, PNGGIF ve diğer standart resim formatları
  • Kalite KorumaGörüntü kalitesini ve çözünürlüğünü korur. PDF çıktı
  • Base64 Kodlama: Güvenli imza iletimi yoluyla Base64 kodlama
  • Esnek BoyutlandırmaHem milimetre hem de piksel tabanlı boyutlandırma seçenekleri mevcuttur.
  • Profesyonel GörünümYüksek kaliteli, net görünürlüklü imza tasarımı

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
  • Esnek YerleştirmeSayfanın herhangi bir konumuna ve yönüne destek.
  • Sayfa HedeflemeBelirli sayfalara veya tüm belgelere uygulayın.
  • Boyut Kontrolü: En uygun yerleştirme için özelleştirilebilir boyutlar

Gelişmiş Özellikler​

  • Opaklık Kontrolüİnce veya belirgin imzalar için ayarlanabilir şeffaflık
  • Arka Plan Moduİmza ekleme seçeneği: İmzaları içeriğin arkasına veya önüne yerleştirme seçeneği.
  • Yazdırma Kontrolüİmzaların yalnızca basılı veya ekranda görünmesini yapılandırın.
  • Profesyonel SonuçlarBelgelerin doğrulanmasını ve güvenliğini artıran imzalar oluşturun.
  • Esnek KonumlandırmaYatay ve dikey hizalamayı piksel hassasiyetinde kontrol edin.

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

Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri

  • Yasal Belgeler: Hukuki sözleşmelere, anlaşmalara ve resmi belgelere imza atmak
  • Sözleşme İmzalamaHukuki geçerlilik için sözleşmeleri ve anlaşmaları dijital olarak imzalayın.
  • Mahkeme BelgeleriMahkeme dosyalarına ve yasal belgelere dijital imza ekleyin.
  • Uyumluluk Gereksinimleri: Belge imzalama ve doğrulama için yasal gereklilikleri karşılamak

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started