PDFHQ logosu

Belgeler

BelgelerBaşlarken

İdempotentlik ve yeniden deneme güvenliği

Proje kapsamlı Idempotency-Key başlıklarını kullanarak ağ zaman aşımları arasında belge görev oluşturmayı güvenli bir şekilde yeniden deneyin ve bunları ücretli işlem ve sağlayıcı gönderiminden ayırt edin.

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

Yeniden oynatmaya uygun görev oluşturma#

POST /v1/tasks isteğe bağlı olarak kabul eder Idempotency-Key (8–128 ASCII harf, rakam, nokta, alt çizgi, iki nokta veya tire; harf veya rakamla başlar). Aynı HQTools hesabı ve API projesi için bir anahtarı tekrarlamak mevcut görevi döndürür. Aynı anahtarı farklı bir araç için yeniden kullanmak 409 IDEMPOTENCY_KEY_REUSED.

Yeniden deneme anahtarı ile görev oluşturun
curl -q --fail-with-body -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_SERVER_SIDE_API_KEY' \
  -H 'Idempotency-Key: job-20261025-00001' \
  -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

Döndürülen görev kimliği yeniden denemeler arasında kararlıdır. Anahtarlar bir hesap ve API projesi kapsamındadır ve temel kayıt silinene kadar görevle ilişkili kalır. Yeni bir görev için yeni bir anahtar oluşturun.

Farklı kaynaklar için farklı yeniden deneme kuralları#

Görev oluşturma: ağ kesintisinden sonra aynı Idempotency-Key kullanarak yeniden oynat. Görev işleme: sabit görev kimliği zaten özdeş seçenekler için arka uç işi/kredi idempotentliği sağlar; tekrar denemeden önce durumunu inceleyin. AI işleri: AI uç noktası tarafından desteklenen yeni bir kullanıcı onaylı alıntı ve kararlı Idempotency-Key kullanın. eİmza gönder: belirsiz bir sağlayıcı yanıtı zarf uzlaştırması gerektirir; imza isteğini körü körüne yeniden göndermeyin.

İmzalı S3 yüklemeleri kısa ömürlü POST form ilkeleri kullanır. Göndermeyin x-api-key veya Idempotency-Key'i S3'e ekleyin. Depolama yüklemeleri ve fiyat tahmini kendi başlarına kredi talep etmez; işleme talep eder.

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.