PDFHQ logosu

Belgeler

BelgelerPDF işlemleri

PDF İmzala (Görünür İşaretler) API'si

Ölçülen görev yaşam döngüsünü kullanarak bir PDF'ye yazılı ad, tarih veya çizilmiş imza görüntüsü yerleştirin. Bu, kimlikleri doğrulamaz veya sertifika destekli şifreleme imzaları yayınlamaz.

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

Uç nokta ve görev semantiği#

İşlem kodu: sign

Bu işlemi şununla başlatın POST /v1/tasks ve yukarıda gösterilen araç kodu. Kaynak PDF'lerini yükleyin ve ekleyin (veya görev kapsamlı yükleme uç noktalarını kullanın), ardından POST /v1/tasks/{task_id}/process işlem ayarları ile.

İmzacının izniyle belgelere gözden geçirilmiş görünür imza, baş harfler veya tarih ekleyin.

Girdiler: Tam olarak bir mühürlü PDF; 1–12 işaret; maksimum 100 MiB ve 500 sayfa (plan limitleri daha düşük olabilir). Zaten dijital imza içeren belgeler reddedilir.

Yapılandırma ve ek parametreler#

AyarTürDavranış
marksgerekli object[]1–12 işaret; her biri sayfa (1 tabanlı), x0, y0, x1, y1 içerir (sol üst PDF noktalarında) ve tür: yazılı, tarih veya çizilmiş. Yazılı/tarih işaretleri metin içerir; çizilmiş işaretler base64 PNG baytları içerir (veri URL öneki olmadan). Resimler maksimum 96 KiB, 1600 × 600 piksel.

Seçenekler API tarafından doğrulanır. Bilinmeyen ayarlar ve desteklenmeyen değerler yok sayılmak yerine bir hata döndürür.

Çalışan istek sırası#

Programming language: cURL

Bir dil seçin · tüm 10 SDK dili için yatay kaydırın

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"sign"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Tam Python kılavuzu ↓ Tam Bash/cURL kılavuzu ↓ Tüm uç noktalar → Doğrudan yüklemeler → Hata işleme →

Oluşturulan indirilebilir paketler yalnızca görev iş akışını kapsar. Tam hizmet SDK'ları doğrulanmış bir çalışma zamanı OpenAPI belirtimi gerektirir; Python, JavaScript ve TypeScript görev SDK'ları dosya yüklemelerini akışa alır; diğer diller, arayan tarafından uygulanan imzalı çok parçalı yüklemeler gerektirir.

Döndürülen görev kimliği hem durum yoklaması hem de alma için kullanılır. Görev başarılı olduktan sonra, bir indirme sırrı gömmek yerine imzalı bir çıktı URL'si isteyin.

Çıktı ve önemli ayrıntılar#

İstenen dikdörtgenlerde görünür imza işaretleri içeren yeni PDF. Kaynak sayfalar ve orijinal metin erişilebilir kalır.

Bu işlem dijital sertifika, alıcı denetim izi, yasal uyum onayı veya imzalayan kimlik doğrulaması oluşturmaz. Mevcut PDF dijital imzaları reddedilir; döndürülen hedef sayfalar desteklenmez. İşletme düzeyinde alıcı imza iş akışları için, özel bir sağlayıcı ile entegre olun.

Hatalar, yeniden denemeler ve faturalandırma
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.