Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Güvenli Belge - Belge Güvenliği API

PDF4me Güvenli Belge Bu özellik, kapsamlı güvenlik kontrolleri ve düzenleme kısıtlamalarıyla Word belgelerine parola koruması ve güvenlik kısıtlamaları eklemenizi sağlar. API Bu hizmet, Word dosyalarını işler ve açık parola koruması, belge düzenleme kısıtlamaları, salt okunur koruma, yalnızca yorum erişimi, form alanı düzenleme ve revizyon takibi uygular. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Güvenlik seviyeleri ve parola gereksinimleri üzerinde tam kontrol sağlayan bu çözüm, gizli belgeler, ortak düzenleme ve belge erişim kontrolü iş akışları için idealdir.

İ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​

Erişmek için PDF4me REST APIHer istek, geçerli kimlik doğrulama bilgilerini içermelidir. Kimlik doğrulama, güvenli iletişimi sağlar ve yetkili bir kullanıcı olarak kimliğinizi doğrular. REST API.

Get your api Key

Başlıca Özellikler​

  • Parola KorumasıBelgeleri açmak için parola gereksinimi ekleyin.
  • Belge KorumasıÇeşitli koruma türleriyle düzenleme yeteneklerini kısıtlayın.
  • Salt Okuma GüvenliğiBelgeleri yetkisiz düzenlemeyi önlemek için salt okunur hale getirin.
  • Yalnızca Yorumlara ErişimYalnızca yorumların eklenmesine veya değiştirilmesine izin ver.
  • Form Alanı DüzenlemeDüzenlemeyi yalnızca form alanlarıyla sınırlandırın.
  • Revizyon TakibiYalnızca izlenen değişikliklere ve revizyonlara izin ver
  • Birleşik GüvenlikHem parola korumasını hem de düzenleme kısıtlamalarını uygulayın.
  • Esnek Erişim KontrolüFarklı kullanım durumları için farklı güvenlik seviyeleri.

REST API Uç nokta​

O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm belge güvenliği işlemleri tek bir uç nokta üzerinden gerçekleştirilir:

  • Yöntem: POST
  • Uç nokta: office/ApiV2Word/ApplySecurity

REST API Parametreler​

Güvenli Belge için parametrelerin tam listesi REST APIParametreler, daha iyi anlaşılması ve uygulanması için kategoriye göre düzenlenmiştir.

Önemli: Yıldız (*) ile işaretlenmiş parametreler zorunludur. Parola parametreleri, ilgili güvenlik seçenekleri etkinleştirildiğinde zorunludur.

Gerekli Parametreler​

ParametreTipTanımÖrnek
belge*ObjectBelge referansı. İçermelidir. İsim (string): .docx uzantılı Word dosya adı{ "Name": "document.docx" }
belge içeriği*Base64Word belgesinin içeriği kodlanmıştır. Base64Bu belgeye güvenlik ayarları uygulanmıştır. Geçerli bir Word belgesi olmalıdır (.docx, .doc formatları).base64EncodedDocumentContent

İsteğe Bağlı Parametreler (Güvenlik Ayarları)​

ParametreTipTanımÖrnek
secureOnOpenStringBelgeyi açmak için parola korumasını etkinleştirin. "yes" = Açmak için parola gereklidir. "no" = Açmak için parola gerekmez (varsayılan). Gereklidir secureOnOpenPassword etkinleştirildiğinde"yes"
secureOnOpenPasswordStringBelgeyi açmak için parola gereklidir. Parola şu durumlarda gereklidir: secureOnOpen dır "yes"Güçlü bir parola kullanın (8 karakterden fazla). Büyük/küçük harf duyarlı olmalıdır."SecurePass123!"
Güvenlik SeçenekleriObjectBelge koruma seçenekleri. Özellikler: korumaTipi (string: NoProtection, ReadOnly, AllowComments, AllowFormFields, AllowRevisions), korumaŞifresi (string). protectionType "NoProtection" olmadığında gereklidir.{ "protectionType": "ReadOnly", "protectionPassword": "EditPass456!" }

Koruma Türü Seçenekleri​

O API Belge düzenleme kısıtlamaları için farklı koruma türleri sunar:

Koruma TürüTanımKullanım Durumu
NoProtectionDüzenleme kısıtlaması yok (varsayılan)Serbestçe düzenlenebilen belgeler
ReadOnlyBelge düzenlenemez, yalnızca görüntülenebilir.Son belgeler, yayınlanmış raporlar
AllowCommentsYalnızca yorumlar eklenebilir/değiştirilebilir.Belge inceleme iş akışları
AllowFormFieldsYalnızca form alanları düzenlenebilir.Doldurulabilir formlar, anketler
AllowRevisionsYalnızca izlenen değişikliklere/revizyonlara izin verilir.Değişiklik takibi ile ortak düzenleme

Güvenlik Yapılandırması​

Parola Koruması (Açık Parola)​

  • AmaçBelgeyi açmak için parola gereklidir.
  • Ne zaman kullanılır?Gizli belgeler, hassas bilgiler
  • Gereklilik: secureOnOpenPassword sağlanmalıdır secureOnOpen dır "yes"
  • KuvvetÖnerilen karakter sayısı: Alfanümerik ve özel karakterler dahil olmak üzere en az 8 karakter.

Belge Koruması (Düzenleme Kısıtlamaları)​

  • AmaçDüzenleme özelliklerini kısıtlarken belge görüntülemeye izin verir.
  • Ne zaman kullanılır?: İşbirliğine dayalı düzenleme, form dağıtımı, inceleme iş akışları
  • Gereklilik: securityOptions.protectionPassword sağlanmalıdır securityOptions.protectionType "Koruma Yok" değildir.
  • EsneklikÇift katmanlı güvenlik için açık parola ile birlikte kullanılabilir.

Çıktı​

O PDF4me Güvenli Belge REST API İşleme moduna bağlı olarak farklı yanıtlar döndürür. API Word belgesini şu şekilde döndürür: Base64-kodlanmış dize içinde JSON formatİkili veri olarak değil.

Senkron İşleme (Varsayılan)

O API İsteği işler ve geri döner:

Durum Kodu: 200 OK

İçerik Türü: application/json

Yanıt Metni:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}

Yanıt Alanları:

  • belge (string): Güvenlik ayarları uygulanmış Word belgesi, şu şekilde kodlanmıştır: Base64 sicim
  • dosya adı (string): Çıktı Word dosyasının adı
  • başarı (boolean): İsteğin başarılı olup olmadığını gösterir.
  • hataMesajı (string veya boş): Başarı başarısız olduğunda hata ayrıntıları

Kullanım Talimatları:

  1. Çıkarın document tarladan JSON cevap (Base64)
  2. Şifreyi çöz Base64 Word belgesinin ikili verilerini almak için kullanılan dize
  3. Word dosyasını gerektiği gibi kaydedin veya işleyin.
  4. Belge, Word'de açıldığında güvenlik ayarlarına bağlı olarak parola(lar) gerektirecektir.

Örnek (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes - document is password protected

Talep Örneği​

Başlık​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Not:

  • Alın API anahtardan PDF4me Kontrol Paneli
  • O API anahtar olmalı Base64 "Basic" önekiyle kodlanmış ve ön eklenmiş Authorization başlık
  • Örnek: Eğer sizin API anahtar şudur abc123onu kodla Base64 ve kullanın Authorization: Basic YWJjMTIz

Yük​

Temel Örnek (Sadece Parola Koruması):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "secureOnOpen": "yes",
 "secureOnOpenPassword": "SecurePass123!"
}

Gelişmiş Örnek (Parola + Salt Okuma Koruması):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "secureOnOpen": "yes",
 "secureOnOpenPassword": "SecurePass123!",
 "securityOptions": {
 "protectionType": "ReadOnly",
 "protectionPassword": "EditPass456!"
 }
}

Yalnızca Yorum Koruması Örneği:

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "secureOnOpen": "no",
 "securityOptions": {
 "protectionType": "AllowComments",
 "protectionPassword": "ReviewPass789!"
 }
}

Form Alanı Koruma Örneği:

{
 "document": { "Name": "form.docx" },
 "docContent": "base64EncodedDocumentContent",
 "secureOnOpen": "no",
 "securityOptions": {
 "protectionType": "AllowFormFields",
 "protectionPassword": "FormPass2024!"
 }
}

Kod Örnekleri​

O PDF4me Güvenli Belge REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:

C# (CSharp) Örnek

Tamamlamak C# Word belgelerinin güvenliğini sağlamaya yönelik uygulama:

Sektör Kullanım Örnekleri ve Uygulamaları​

Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri

  • Gizli Müşteri BelgeleriHassas hukuki belgelere parola koruması uygulayın.
  • Sözleşme GüvenliğiMüşteri incelemesi için salt okunur korumaya sahip güvenli sözleşmeler.
  • Yasal Form Dağıtımı: Yasal formlara form alanı koruması uygulayın
  • Belge İncelemesiHukuki belge incelemesi için yalnızca yorum korumasını kullanın.

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started