PDFHQ logosu

Belgeler

BelgelerBaşlarken

Yükleme öncesi ön kontrol

Dosyaları mühürlemeden veya yüklemeden önce PDF işlemi uygunluğunu, imzalı meta verileri, toplu işlem sınırlarını ve HQ kredisi tahminlerini kontrol edin.

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

PDF işlemlerini yüklemeden doğrulayın#

POST /v1/preflight, depolama alanı ayırmadan, görev oluşturmadan veya kredi düşmeden önerilen PDF işlemini, meta verileri, ayarları, plan kısıtlarını ve tahmini HQ kredisi tutarını doğrular. Her dosya için format, size_bytes ve page_count sağlayın. Kimlik doğrulama, hesap oturumuyla veya görev izinleri olan bir API anahtarıyla yapılır; sınırlı anonim istekler bakiyeleri göremez.

cURL
curl -X POST 'https://api.pdfhq.io/v1/preflight'   -H 'Content-Type: application/json'   -H 'x-api-key: YOUR_API_KEY'   -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'

supported, eligible, can_proceed, blockers, quote ve next_actions alanlarını inceleyin. Yalnızca HQTools tarafından merkezi olarak doğrulanmış bir teklif, satın almayla çözülebilen engeli kaldırabilir. Teknik olarak desteklenmeyen bir istekte ödeme ekranı gösterilmemelidir.

Yürütme ve güvenlik#

Hız sınırları ve sıkı istek doğrulaması anonim uç noktayı korur. Başarılı bir ön kontrolün kredi ayırdığını, fiyatı sabitlediğini veya yüklenen PDF içeriğini kanıtladığını varsaymayın. Doğrudan depolamaya imzalayıp yükleyin, görevi oluşturun ve sunucunun gerçek belgeleri, yetkileri, kotaları ve HQ kredilerini yürütme sırasında yeniden doğrulamasını sağlayın.

Referans SDK'lar preflight(request) işlevini on dilde sunar; canlı OpenAPI /openapi.json genel sözleşmeleri açıklar. HTTP 422 doğrulama, 429 hız sınırı ve 503 kullanılamıyor yanıtlarını ele alın.

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.