İmzalı bir PDF belgesinden imzaları kaldırmak, daha sonraki işleme veya arşivleme için temiz bir kopyaya ihtiyacınız olduğunda yaygın bir gereksinimdir. GroupDocs.Signature Cloud SDK for Node.js programatik olarak PDF imzalarını yönetmenizi sağlayan sağlam bir kütüphane sunar. Bu öğreticide, Node.js kullanarak bir PDF’den tüm imzaları nasıl sileceğinizi öğrenecek, tam bir kod örneğini görecek ve REST API için eşdeğer cURL komutlarını keşfedeceksiniz.
Node.JS’te İmzalı PDF Belgesinden İmzaları 5 Adımda Kaldırma
Aşağıdaki adımlar, GroupDocs.Signature Cloud SDK for Node.js kullanarak İmzalı PDF belgesinden İmzaları kaldırma gösterir.
- Kimlik bilgileriyle yapılandırmayı başlat: İstemci kimliğinizi ve gizlinizi tutan bir
Configurationnesnesi oluşturun.
const config = new Configuration({
clientId: process.env.GROUPDOCS_CLIENT_ID,
clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
- API istemcisi ve Signature API örneği oluşturun: Yapılandırmayı kullanarak bir
ApiClientve ardından birSignatureApioluşturun.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
- Kaynak PDF dosyası bilgilerini tanımlayın: GroupDocs depolamasında bulunan PDF’nin
filePathdeğerini ayarlayın.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
- Çıktı yolu ile silme isteği hazırlama:
DeleteSignaturesRequestoluşturun,fileInfoöğesini atayın ve sonucun nereye kaydedileceğini belirtin.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
- İsteği yürüt ve sonucu işle:
deleteSignaturesmetodunu çağır ve yanıtı işle.
try {
const result = await signatureApi.deleteSignatures(deleteRequest);
console.log("All signatures removed successfully.");
console.log("Result file stored at:", result.path);
} catch (err) {
console.error("Failed to remove signatures:", err);
}
Her sınıf hakkında daha fazla ayrıntı için, API Referansı adresine bakın.
PDF’den Tüm İmzaları Kaldırma - Tam Kod Örneği
Aşağıdaki örnek, imzalı bir PDF belgesinden imzaları kaldırma sürecinin tam iş akışını göstermektedir.
const { Configuration, ApiClient, SignatureApi, DeleteSignaturesRequest, FileInfo } = require("@groupdocs/signature-cloud");
async function removeSignaturesFromPdf() {
// Initialize configuration with your GroupDocs credentials
const config = new Configuration({
clientId: process.env.GROUPDOCS_CLIENT_ID,
clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
// Create API client and Signature API instance
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
// Define source PDF file (must be already uploaded to GroupDocs storage)
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf"; // path in GroupDocs storage
// Prepare request to delete all signatures and store result as a new file
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf"; // resulting file path in storage
try {
const result = await signatureApi.deleteSignatures(deleteRequest);
console.log("All signatures removed successfully.");
console.log("Result file stored at:", result.path);
} catch (err) {
console.error("Failed to remove signatures:", err);
}
}
removeSignaturesFromPdf();
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.
cURL Kullanarak REST API ile PDF İmzalarını Kaldırma
Aşağıda, GroupDocs REST API aracılığıyla aynı işlemi gerçekleştiren cURL komutları bulunmaktadır.
- Kimlik doğrulaması yapın ve bir erişim belirteci alın
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Kaynak PDF’yi GroupDocs depolamasına yükleyin
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/pdf" \
--data-binary @input.pdf
- İmzaları silme işlemini yürütün
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/delete" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fileInfo": { "filePath": "input.pdf" },
"outputPath": "output.pdf"
}'
- Oluşturulan PDF’yi indirin
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
Tam API sözleşmesi için, API Referansı sayfasına bakın.
Ortamı Hazırlama
Kütüphaneyi npm aracılığıyla kurun ve Node.js sürümünüzün minimum gereksinimleri karşıladığından emin olun.
npm install groupdocs-signature-cloud
En son paketi ayrıca indirme sayfasından indirebilirsiniz. Geçerli bir GroupDocs hesabınızın olduğundan ve istemci kimlik bilgilerini oluşturduğunuzdan emin olun.
GroupDocs.Signature Cloud SDK for Node.js’i PDF İmza Kaldırma İçin İdeal Kılan Nedir
- Tüm imza türlerini sil - Metin, görüntü, barkod, QR kod ve dijital imzaları destekler.
- Bulut depolama entegrasyonu - Dosyalar doğrudan GroupDocs cloud’da depolanır, yerel dosya işlemlerine gerek kalmaz.
- Yüksek performans - Büyük PDF belgeleri ve toplu işleme için optimize edilmiştir.
- Kapsamlı API - Tam REST uç noktaları Node.js kütüphanesinde yansıtılmıştır, kod ya da cURL seçme esnekliği sağlar.
- Güvenli işleme - Tüm işlemler HTTPS üzerinden gerçekleşir ve hesabınızın izinlerine saygı gösterir.
Daha derin bir anlayış için, resmi belgelere bakın.
İmza Silme Seçeneklerini İnce Ayarlama
Temel istek her imzayı kaldırırken, aşağıdaki gibi seçenekleri ayarlayabilirsiniz:
- outputPath - İmzalanmamış PDF için farklı bir klasör veya dosya adı seçin.
- fileInfo.password - Kaynak PDF şifre korumalıysa, şifreyi burada ayarlayın.
Çıktı yolunu ayarlama örneği (yukarıdaki kod parçacığında zaten gösterilmiştir):
deleteRequest.outputPath = "output.pdf";
Ek parametreler API referansında listelenmiştir.
PDF’lerde İmzaları Kaldırma için En İyi Uygulamalar
- Dosya varlığını doğrulayın isteği göndermeden önce gereksiz API çağrılarını önlemek için.
- Ortam değişkenlerini kullanın istemci kimlik bilgileri için, böylece kaynak kontrolünden dışarıda tutulur.
- İmzalanmamış sonucu ayrı bir klasöre kaydedin orijinal imzalı belgeyi korumak için.
- Hataları nazikçe ele alın istisnaları yakalayarak ve hata detaylarını kaydederek.
- Farklı imza türleriyle test edin silme işleminin tüm senaryolarda çalıştığından emin olmak için.
Sonuç
İmzalı bir PDF belgesinden imzaları kaldırmak, GroupDocs.Signature Cloud SDK for Node.js ile çok basit hale gelir. Kütüphane kimlik doğrulama, depolama erişimi ve silme işlemini sadece birkaç satır kodla yönetirken, REST API aynı yeteneği cURL üzerinden sunar. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisansı geçici lisans sayfasından edinebilirsiniz. Bu araçlarla, PDF imza kaldırma işlemini herhangi bir Node.js iş akışında otomatikleştirebilirsiniz.
FAQs
GroupDocs.Signature Cloud SDK for Node.js ile İmzalı PDF belgesinden imzaları kaldırma nasıl çalışır?
Kütüphane, istemci kimliğiniz ve gizli anahtarınızı kullanarak kimlik doğrulaması yapar, ardından belirtilen PDF’den tüm imzaları kaldırmak için DeleteSignatures uç noktasını çağırır. Ayrıntılar için GroupDocs.Signature Cloud SDK for Node.js belgelerine bakın.GroupDocs bulut depolamasında saklanan bir PDF’den imzaları silebilir miyim?
Evet.FileInfonesnesinde depolama yolunu sağlayın ve SDK dosyaya doğrudan erişecektir. Depolama yönetimi için resmi belgelere bakın.Orijinal imzalı PDF’nin bir kopyasını saklamam gerekirse ne olur?
Orijinal dosyanın dokunulmaz kalması ve yeni dosyanın imza içermemesi içinDeleteSignaturesRequestiçinde farklı biroutputPathbelirtin.Bu işlevi üretimde kullanmak için özel bir lisansa ihtiyacım var mı?
Üretim kullanımında geçerli bir lisans gereklidir. Geçici bir lisansı geçici lisans sayfasından alabilirsiniz.