PDF Belgesini Şifrele API

Q: What encryption strength does the Protect endpoint apply?

PDF4me applies AES encryption that conforms to the PDF specification (ISO 32000). Modern PDF readers use 128-bit or 256-bit AES depending on the PDF version. Both meet GDPR and HIPAA encryption requirements.

Q: Can I set an owner password and a user password separately?

The single password field is applied as the user password, the password required to open the document. The pdfPermission field controls owner-level restrictions such as printing, copying, and editing. Together they behave as a combined owner plus user password setup.

Q: How do I disable printing or copying on the encrypted PDF?

Set pdfPermission to None to block every action except opening, or pick a specific allowed flag such as Copy, Annotate, Fill Forms, Support Disabilities, Assemble, or Digital Print. Anything you do not explicitly allow is blocked.

Q: Can I encrypt PDFs in bulk?

Yes. Each Protect call handles one PDF and the endpoint is stateless. For bulk password protect PDF workflows, loop over your files in code or use a Make, Zapier, Power Automate, or n8n scenario that fires the Protect action per file.

PDF4me Belgeyi Koru Bu, bir PDF dosyasını parola ile koruyan ve alıcıların onunla neler yapabileceğini kısıtlayan bir REST uç noktasıdır. Dosyayı Base64 olarak POST edin. /api/v2/Protect Bir parola ve izin bayrağı ile giriş yapıldığında, yanıt olarak yeni bir AES şifreli PDF dosyası oluşturulur. Yazdırma, kopyalama, düzenleme ve form doldurma işlemleri yalnızca siz izin verdiğiniz takdirde gerçekleştirilebilir.

Bu uç noktanın işlevi

PDF4me Belgeyi Koruyun şifreler PDF Bir parola ile izin bayraklarını tek bir yerde ayarlar. REST Çağrı. Gönder PDF gibi Base64Parolayı ve hangi işlemlerin (yazdırma, kopyalama, not ekleme, form doldurma) izin verildiğini seçin ve yeni bir tane alın. AES-şifrelenmiş PDF Yanıtta. Uygulanan şifreleme şudur: AES-128 veya AES-256 başına PDF özelliklere uygun, şunlar için GDPR, HIPAAve uyumluluk odaklı diğer iş akışları.

İ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

Her PDF4me REST API Çağrınızda mutlaka sizin de bulunmanız gerekiyor. API anahtara girin Authorization Başlık. Geliştirici kontrol panelinden bir anahtar oluşturun veya seçin ve sunucu tarafında tutun. Asla tarayıcı kodunda ifşa etmeyin.

Get your API Key

Kaçırmamanız Gereken Önemli Bilgiler

Parola ve izinler birlikte uygulanır.

Tek şifre Tarla kapılarının açılış belgesi. pdfİzin `enum`, belge açıldıktan sonra kullanıcıların neler yapabileceğini kontrol eder. İkisini birlikte kullanarak bir belgeyi gönderebilirsiniz. PDF Parola gerektiren VE yazdırma veya kopyalama işlemlerini devre dışı bırakan bir özellik.

İzin bayrakları, reddetme listesi değil, izin listesidir.

Dahil etmediğiniz her şey pdfİzin Engellendi. Ayarlayın. Hiçbiri Açma işlemi dışında her işlemi engellemek veya belirli bir bayrağa (örneğin) odaklanmak. Formları Doldurun Sadece form doldurmaya izin vermek, başka hiçbir şeye izin vermemek.

Kaynak PDF asla değiştirilmez

O API şifrelenmiş veriyi döndürür. PDF Yanıt gövdesinde (Content-Type application/pdf) ham ikili baytlar olarak gönderilir. Orijinal dosyanız dokunulmadan kalır. Yanıt baytlarını doğrudan yeni bir .pdf dosyasına yazın. Korunmasız kaynağın bozulmadan kalması gereken uyumluluk denetim izleri için kullanışlıdır.

REST API uç nokta

Yöntem: POSTALAMAK
URL: https://api.pdf4me.com/api/v2/Protect

Göndermek İçerik Türü: application/json ve bir Yetkilendirme başlığınızla birlikte API Anahtar. Ayarla. asenkron ile YANLIŞ senkron bir yanıt için (HTTP 200 şifrelenmiş PDF ham ikili baytlar olarak) veya doğru almak için HTTP 202 artı bir Konum 200 değerini döndürene kadar sorguladığınız başlık. PDF.

Postman isteği kurulumu

Ayar	Değer
Method	POST
URL	https://api.pdf4me.com/api/v2/Protect
Headers	Content-Type: application/json
Authorization	Basic Auth with your API key, or header Authorization: Basic YOUR_API_KEY
Body	raw JSON with docContent, docName, password, pdfPermission, and async fields
Response (sync)	When async is false: HTTP 200 with the encrypted PDF as raw binary bytes. Save the response body directly to a .pdf file.
Response (async)	When async is true: HTTP 202 with a Location header. GET that URL until you receive 200 plus the binary PDF. Useful for large files or slow networks.

Parametreler

Her zaman gerekli: belge içeriği, belge adı, şifre, pdfİzin. O asenkron bayrak isteğe bağlıdır (varsayılan değer şudur: YANLIŞ) ve yanıtın hemen mi yoksa bir sorgulama URL'si aracılığıyla mı döndürüleceğini kontrol eder.

Parametre	Gerekli	Tip	Ne işe yarar?	Örnek
`docContent`	Required	Base64 String	The source PDF file encoded as Base64 (no data: prefix). Read the file as bytes and run it through your language's Base64 encoder.	`JVBERi0xLjQK...`
`docName`	Required	String	Filename of the source PDF including the .pdf extension. Used for tracking and the output filename.	`invoice.pdf`
`password`	Required	String	The password applied to the encrypted PDF. Users must enter this to open the document.	`Str0ng-P@ss!`
`pdfPermission`	Required	Enum	What the user can do once the PDF is unlocked. One of: All, None, Copy, Annotate, Fill Forms, Support Disabilities, Assemble, Digital Print. See the flag reference card grid below.	`Fill Forms`
`async`	Optional	Boolean	Defaults to false. When false the API returns the encrypted PDF immediately as binary bytes (HTTP 200). When true the API returns HTTP 202 with a Location header; poll that URL with GET until you receive 200 with the binary PDF. Use true for large PDFs or batch processing.	`false`

Hangi pdfPermission bayrağını seçmeliyim?

Parola ve izin bayrağı farklı şeylere karşı koruma sağlar. Parola açılışı kontrol eder; izin bayrağı ise açıldıktan sonra ne olacağını kontrol eder.

Parola mı yoksa izinler mi?	`password` alan	`pdfPermission` alan
Şunlara karşı koruma sağlar:	Yetkisiz açılış	Açıldıktan sonra istenmeyen işlemler
Kimleri etkiliyor?	Şifresi olmayan herkes	Belgeyi açan herkes
Tipik kullanım	Gizli teslimat	salt okunur sözleşmeler, prova kopyaları
En kısıtlayıcı değer	Güçlü ve benzersiz bir parola	`None` (sadece açık)

TümHer şeye izin veriliyor.

Açın, yazdırın, kopyalayın, düzenleyin, not ekleyin, formları doldurun. Başka kısıtlama olmaksızın yalnızca parola koruması için kullanın.

HiçbiriSadece açılış

Blok baskı, kopyalama, düzenleme, not ekleme, form doldurma. En kısıtlayıcı seçenek.

KopyalaMetni veya görselleri açın ve kopyalayın.

Blok baskı, düzenleme, not ekleme.

Açıklama ekleAçın ve not ekleyin

Yapışkan notlar ve vurgulamalar serbesttir. Kopyalama, yazdırma ve düzenleme engellenmiştir.

Formları DoldurunForm alanlarını açın ve doldurun.

Blok baskı, kopyalama, düzenleme. Gizli bilgi formlarında yaygın olarak kullanılır.

Engellilere DestekErişilebilirlik araçlarıyla açın

Ekran okuyucu ve yardımcı araç erişimi. Varsayılan olarak erişilebilir PDF'ler için gereklidir.

Bir araya getirinSayfa düzeyinde değişikliklere izin verilir.

Sayfaları ekleyin, silin veya döndürün. Sonraki aşamalardaki araçların PDF dosyasını yeniden yapılandırması gerektiğinde kullanılır.

Dijital BaskıSadece düşük çözünürlüklü baskı

Yüksek çözünürlüklü baskı ve kopyalamayı engeller. Prova baskıları için kullanışlıdır.

Örnekler isteyin

Örnek A: Sadece parola ile şifrele (`All` izinler)

{
  "docContent": "JVBERi0xLjQK...",
  "docName": "invoice.pdf",
  "password": "Str0ng-P@ss!",
  "pdfPermission": "All",
  "async": false
}

Örnek B: Maksimum kısıtlamalarla şifrele (`None`)

Blok baskı, kopyalama, düzenleme, not ekleme ve form doldurma.

{
  "docContent": "JVBERi0xLjQK...",
  "docName": "confidential.pdf",
  "password": "Str0ng-P@ss!",
  "pdfPermission": "None",
  "async": false
}

Örnek C: Şifreleyin ve yalnızca form doldurmaya izin verin.

Alıcının doldurması gereken ancak başkalarına dağıtmaması gereken gizli başvuru formları için kullanışlıdır.

{
  "docContent": "JVBERi0xLjQK...",
  "docName": "intake-form.pdf",
  "password": "Form-2026",
  "pdfPermission": "Fill Forms",
  "async": true
}

Başarılı yanıt (senkronizasyon, `async: false`)

HTTP 200 şifrelenmiş PDF ham yanıt gövdesi olarak (ikili) application/pdf). HAYIR JSON Paketleme. Yanıt baytlarını doğrudan bir dosyaya kaydedin.

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="protected.pdf"

<binary PDF bytes>

Başarılı yanıt (eşzamansız, `async: true`)

HTTP 202 ile Location başlık. Anket URL ile GET (Aynı Authorization (başlık) alana kadar HTTP 200 ikili ile PDF.

HTTP/1.1 202 Accepted
Location: https://api.pdf4me.com/api/v2/JobStatus/<job-id>

curl örnekleri

Senkronizasyon modu (yanıt gövdesini doğrudan bir dosyaya kaydet):

curl -X POST https://api.pdf4me.com/api/v2/Protect \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic YOUR_API_KEY" \
  -o protected.pdf \
  -d '{"docContent":"JVBERi0xLjQK...","docName":"invoice.pdf","password":"Str0ng-P@ss!","pdfPermission":"Fill Forms","async":false}'

Asenkron mod (not) -D headers.txt yakalamak için Location (sorgulama için başlık):

curl -X POST https://api.pdf4me.com/api/v2/Protect \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic YOUR_API_KEY" \
  -D headers.txt \
  -d '{"docContent":"...","docName":"invoice.pdf","password":"Str0ng-P@ss!","pdfPermission":"Fill Forms","async":true}'

API ne döndürüyor?

Şifrelenmiş belgenin kendisi. Koruma şu şekilde uygulanır: AES şifrelemesi tarafından tanımlandığı gibi PDF spesifikasyonuBu nedenle, standartlara uygun herhangi bir okuyucu parola ister ve izin bayrağını uygular.

Alan	Tip	İçeriğinde neler var?
Response body (HTTP 200)	Binary	The encrypted PDF bytes (Content-Type application/pdf). Write them straight to a new .pdf file; the source file is never modified.
Location header (HTTP 202)	String (URL)	Returned when async is true and processing continues in the background. GET this URL with the same Authorization header.
Poll response (HTTP 200)	Binary	The finished encrypted PDF, returned once the async job completes.
Poll response (HTTP 202)	Empty	Job still processing. Wait and poll the same Location URL again.

Kod örnekleri

Entegrasyon örnekleri

Yaygın REST entegrasyon kalıplarıTypical ways developers call Protect Document.

Teslimat için faturaların toplu olarak şifrelenmesi

Her faturayı okuyun. PDF bir klasörden, S3 kova veya veritabanı kuyruğu.
Base64-baytları kodla ve POST Korumak için pdfİzin ayarlandı Formları Doldurun.
Yanıt baytlarını doğrudan bir .pdf dosyasına (ham ikili veri) yazın, ardından şifrelenmiş dosyayı e-postaya veya nesne depolama alanına yükleyin.
Tüm dosyaları döngüyle işleyin. Uç nokta durumsuzdur ve hız limitiniz dahilinde paralel çağrılar için güvenlidir.

Yasal süreçler için önce şifreleyin, sonra imzalayın.

POST kaynak PDF ile /api/v2/Koruma Alıcı şifresi ve seçilen izin ile.
İkili yanıt baytlarını alın, yeniden kodlayın Base64ve onları besleyin belge içeriği -e Dijital Tabela uç nokta.
Tek bir tane alın PDF bu ikisi de AES-Şifrelenmiş ve kriptografik olarak imzalanmıştır. Yasal ve uyumluluk gerektiren kullanım durumları için kurcalamaya karşı dayanıklıdır.

GDPR veya HIPAA alıcı başına şifreleme

Her alıcı için benzersiz bir parola oluşturun (UUID veya paylaşılan sırdan türetilmiştir).
POST Bu parolayla korumak için ve pdfİzin ayarlandı Hiçbiri Kopyalama ve yazdırma işlemlerini tamamen engellemek.
Şifrelenmiş e-postayı gönderin. PDF ve uyumluluk denetim kayıtları için parola ayrı bir kanal üzerinden iletilir.

Sıkça Sorulan Sorular

What encryption strength does the Protect endpoint apply?+

PDF4me applies AES encryption per the PDF specification (ISO 32000). Modern PDF readers use 128-bit or 256-bit AES depending on the PDF version of the source. Both meet GDPR and HIPAA encryption requirements for documents in transit and at rest.

Can I set an owner password and a user password separately?+

The password field is applied as the user password (required to open). The pdfPermission enum is the owner-level signal controlling what is allowed once the document is open. Together they behave like a combined owner-and-user setup. The endpoint does not currently accept two distinct passwords in one call.

How do I disable printing or copying on the encrypted PDF?+

Pick a pdfPermission value that does NOT include the action you want to block. Set it to None to block everything except opening. Set it to Copy to allow text or image copy only. Set it to Fill Forms to allow form filling only. The flag is allow-list: anything not explicitly listed is blocked.

Is the original PDF modified, or is a new copy returned?+

The original file is never touched. The API returns the encrypted PDF as raw binary bytes in the response body (Content-Type application/pdf). Write the response bytes directly to a new .pdf file. Useful when the unprotected source must remain intact for audit trails.

Can I encrypt PDFs in bulk?+

Each call protects one PDF and the endpoint is stateless. For bulk encryption, loop over files in your script (Python for loop, C# foreach, Node async map) or use a Make, Zapier, Power Automate, or n8n scenario that fires the Protect action per file picked up by a folder watcher.

Does this work as an alternative to SmallPDF, iLovePDF, or Adobe Acrobat password protection?+

Yes. The Protect endpoint provides the same outcome (password-encrypted PDF with permission control) through a REST API. No per-user license, no manual upload, and full automation. The same call from a script handles one document or one thousand.

Is the response binary or Base64?+

The response body is the raw binary PDF (Content-Type application/pdf), not JSON. Write the response bytes straight to a .pdf file: response.content in Python requests, response.body in fetch, await Content.ReadAsByteArrayAsync in C#. The Base64 envelope is only used for input (the docContent field you send in the request), not for the output.

How do I test the API without writing code?+

Open the Protect Document API Tester, paste your API key, upload a PDF, type a password, and pick a pdfPermission flag. The tester shows the request and lets you download the encrypted PDF directly.