PDFHQ logosu

Belgeler

Belgelerİmzalama

eİmza istekleri API

Sürümlü imza taslakları oluşturun ve düzenleyin, gönderici tarafından atanan alanları yerleştirin ve doğrulayın, açık sandbox istekleri gönderin ve imzalı yapıtları alın.

Sunucu tarafı API anahtarları İmzalı depolama yüklemeleri

İmza isteği yaşam döngüsü — önce sandbox#

PDFHQ eSign, sağlayıcıdan bağımsız bir zarf kaynağını destekler: bir PDF'yi yükleyin ve doğrulayın POST /v1/documents/uploads, ardından bir imza isteği taslağı oluşturun. Taslakların kendi kimliği, imzacıları ve PDF dönüştürme görevlerinden ayrı durumu vardır.

Mevcut sürüm: Dropbox Sign test modu yalnızca. Test belgeleri filigranlanmış ve yasal olarak bağlayıcı değildir. Sağlayıcı kendi imzacı e-postalarını gönderir. Canlı imza istekleri, kurumsal OAuth bağlantıları ve üretim tarifeleri etkinleştirilmemiştir.

eİmza taslağı oluştur
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"upload_id":"VERIFIED_UPLOAD_UUID","provider":"managed","title":"Mutual NDA","subject":"Please review and sign","message":"Please sign this agreement.","signers":[{"name":"Alice Example","email":"alice@example.com","order":0},{"name":"Bob Example","email":"bob@example.com","order":1}]}'

Tam imzacı alanlarını ve sürümlü taslakları hazırlayın#

Sandbox istemcileri, mühürlü, dik, kırpılmamış US Letter PDF'sine imza, paraf ve imza tarihi alanları yerleştirebilir. Genel dikdörtgen koordinatları sayfanın sol üst köşesine göre 0 ile 1 arasında normalleştirilir; sayfa numarası 1'den başlar. Her imzacı gerekli bir imza alanı almalıdır. Çakışan, eksik veya sınır dışı yerleşimleri reddedin. Diğer tüm sayfa boyutları için atla fields sağlayıcının eklenen imza sayfasını kullanmak için destek doğrulanırken.

Konumlandırılmış, iki imzacı taslak oluştur
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Idempotency-Key: sample-signing-draft-001' \
  -H 'Content-Type: application/json' \
  -d '{"upload_id":"VERIFIED_UPLOAD_UUID","provider":"managed","title":"NDA", "subject":"Sign NDA","message":"Please review and sign","signers":[{"name":"Example One","email":"first@example.test","order":0},{"name":"Example Two","email":"second@example.test","order":1}],"fields":[{"field_id":"first_sig","signer_index":0,"type":"signature","page":1,"rect":{"x":0.10,"y":0.72,"width":0.30,"height":0.08},"required":true},{"field_id":"second_sig","signer_index":1,"type":"signature","page":1,"rect":{"x":0.55,"y":0.72,"width":0.30,"height":0.08},"required":true}]}'

Oluşturma, isteğe bağlı bir Idempotency-Key. Aynı anahtar ve aynı mühürlü belge/taslak verileri mevcut taslağı döndürür; farklı bir yük 409 döndürür. Bir taslak yalnızca gönderilmeden önce şu kişi tarafından düzenlenebilir: PATCH /v1/esign/envelopes/ENVELOPE_UUID tam bir değiştirme alan seti ve If-Match: 1 onun draft_version. Düzenlemeler sürümü ve özeti artırır. Alanlar gönderildikten sonra değişmez kalır.

Kaynak ve alan düzenini önceden kontrol et
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/validate' \
  -H 'x-api-key: YOUR_API_KEY'

Bu ön kontrol, sayfa boyutlarını ve döndürmeyi tarayıcı meta verilerine değil, gerçek mühürlü baytlara karşı karşılaştırır. Hız sınırlıdır ve salt okunurdur. Geçen yerel önizleme, Dropbox Sign piksel mükemmel yerleşimini onaylamaz; üretim aktivasyonundan önce gerçek test imzalama törenini gözden geçirin.

Açık test onayı ile gönder#

cURL
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/send' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"confirm_test_mode":true,"draft_version":1}'

# Poll the envelope for status; never auto-retry an uncertain send.
curl 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID' -H 'x-api-key: YOUR_API_KEY'

Sağlayıcı gönderimi açık sunucu tarafı yapılandırması tarafından korunur ve üretimde devre dışı bırakılır. Dropbox'a ulaşmış olabilecek ancak yanıtını kaybetmiş istekler needs_reconciliation ve kör olarak yeniden gönderilemez.

Sandbox hatırlatmaları ve iptal — imzalı geri çağrılar yetkilidir#

Test isteği gönderildikten sonra, gönderici 24 saat içinde alıcı başına bir test e-posta hatırlatması gönderebilir. İptal istekleri sağlayıcı API'sini zaman uyumsuz olarak kullanır; HTTP 202 yalnızca iptal talebinin yapıldığı anlamına gelir, alıcıların artık imzalayamayacağı anlamına gelmez. Her iki işlem de üretim elektronik imza iş akışı değildir.

Bir alıcıya hatırlatma isteği gönder
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/remind'   -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"recipient_index":0,"confirm_test_mode":true}'

curl 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/reminders'   -H 'x-api-key: YOUR_API_KEY'

Hatırlatma makbuzları gerçek e-posta teslimini değil, kabul/reddetme/belirsizliği raporlar. Denenen hatırlatma, sağlayıcıyla iletişim kurmadan önce kalıcı olarak kaydedilir; ağ sonucu belirsizse, yeniden denemeyin. Yalnızca orijinal hesap/API projesi içindeki arayanlar makbuzlara erişebilir; imzalayan e-postaları hariç tutulur.

Eşzamansız iptal isteyin; durumu inceleyin
curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/void'   -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"reason":"agreement_withdrawn","confirm_test_mode":true}'

curl -X POST 'https://api.pdfhq.io/v1/esign/envelopes/ENVELOPE_UUID/sync'   -H 'x-api-key: YOUR_API_KEY'

İptal yalnızca gönderilen, görüntülenen veya teslim bekleyen durumdayken izin verilir. Kısmen imzalanan ve tamamlanan istekler PDFHQ'dan iptal edilemez. Sağlayıcı HTTP 200, zarfın iptal edildiği anlamına gelmez. Kimliği doğrulanmış bir signature_request_canceled geri çağırma veya onaylanmış sağlayıcı durumu. Yanıtlar şöyle: cancel_uncertain operatör araştırması gerektirir; hiçbir zaman kör bir şekilde yeniden göndermeyin.

Bu API, önceden gönderilen davetlerin silinmesini, yasal uygulanabilirliği, mevcut imzanın geriye dönük iptali, otomatik geri ödemeyi veya üretim sınıfı sağlayıcı SLA'sını garanti etmez. Gelecekteki canlı mod, merkezi kredi tabanlı faturalandırma, kimlik doğrulaması, sözleşmesel inceleme ve tam aşamalı sağlayıcı kabulü gerektirir.

İmzalı belge alımı#

Doğrulandıktan sonra signature_request_downloadable geri arama, kullan POST /v1/esign/envelopes/ENVELOPE_UUID/archive . PDFHQ tamamlanan PDF'yi Dropbox'tan özel HQ depolama ad alanına indirir. Ardından GET /v1/esign/envelopes/ENVELOPE_UUID/download-url kısa ömürlü, hesap kapsamlı çıktı URL'si için.

Kaynak PDF asla müşteri tarafından belirtilen bir URL üzerinden gönderilmez. Doğrulanmış mühürlü dosya baytlarını sabit Dropbox API ana bilgisayarına ileteriz. Sağlayıcı tarafından barındırılan imzacı sayfaları ve sağlayıcı denetim kanıtları seçilen hizmet tarafından yönetilir.

Webhook güvenliği ve durum geçişleri →
PDFHQ logosu

PDF araçları ve belge zekası. Belgelerinizi hazırlayın, anlayın ve çalışın.

© 2026 PDFHQ. Tüm hakları saklıdır.