Node.JS'de PDF'den DOCX'e Dönüştürme

Mon, 03 Aug 2026 10:51:03 +0000

PDF dosyalarını DOCX formatına dönüştürmek, özellikle düzenlenebilir Word çıktısına ihtiyaç duyulduğunda, belge‑odaklı uygulamalar geliştirirken sık karşılaşılan bir gereksinimdir. GroupDocs.Conversion Cloud SDK for Node.js bu görevi basit ve ölçeklenebilir hâle getiren sağlam bir API sağlar. Bu kılavuzda tam bir asenkron kod örneğini görecek, aynı sonucu cURL REST çağrılarıyla nasıl elde edeceğinizi öğrenecek, SDK’yı kuracak ve güvenilir dönüşümler için en iyi uygulama önerilerini uygulayacaksınız.

Tam Kod Örneği: Node.JS’te Asenkron PDF’den DOCX’e Dönüştürme

Bu örnek, GroupDocs.Conversion Cloud SDK for Node.js kullanarak asenkron bir PDF’den DOCX’e dönüşümün nasıl gerçekleştirileceğini gösterir.

// PDF to DOCX conversion using GroupDocs.Conversion Cloud SDK for Node.js

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const path = require('path');

// -------------------- Configuration --------------------
const CLIENT_ID = process.env.GROUPDOCS_CLIENT_ID || 'YOUR_CLIENT_ID';
const CLIENT_SECRET = process.env.GROUPDOCS_CLIENT_SECRET || 'YOUR_CLIENT_SECRET';

// Initialize API client
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient = new GroupDocsConversionCloud.ApiClient();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';
apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

// -------------------- Conversion Logic --------------------
async function convertPdfToDocx() {
    try {
        // Input file information (must already be uploaded to GroupDocs Cloud storage)
        const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
        inputFileInfo.filePath = path.normalize('input.pdf'); // generic path in cloud storage

// DOCX specific conversion options (optional, shown for demonstration)
        const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
        docxOptions.preserveOriginalFormatting = true; // keep original PDF layout as much as possible
        docxOptions.password = null; // if PDF is password protected, set it here

// Build conversion request
        const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
        convertRequest.format = 'docx';
        convertRequest.fileInfo = inputFileInfo;
        convertRequest.outputPath = path.normalize('output.docx'); // result will be stored in cloud storage
        convertRequest.options = docxOptions; // attach format‑specific options

// Perform conversion (async)
        const conversionResult = await apiInstance.convertDocument(convertRequest);

// conversionResult contains the path of the generated file and other metadata
        console.log('Conversion succeeded.');
        console.log('Output file path:', conversionResult.path);
        console.log('File size (bytes):', conversionResult.size);
    } catch (error) {
        // Detailed error handling
        if (error.response && error.response.body) {
            console.error('API error:', error.response.body);
        } else {
            console.error('Unexpected error:', error.message);
        }
    }
}

// -------------------- Execution --------------------
(async () => {
    // Optional: set a timeout to avoid hanging indefinitely
    const timeoutMs = 300000; // 5 minutes
    const timeout = setTimeout(() => {
        console.error('Conversion timed out after', timeoutMs / 1000, 'seconds');
        process.exit(1);
    }, timeoutMs);

await convertPdfToDocx();

clearTimeout(timeout);
    // Graceful shutdown
    process.exit(0);
})();

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.pdf, output.docx vb.) gerçek konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların yüklü olduğundan emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API Kullanarak Belgeleri Dönüştürme

Kod yazmadan aynı PDF’ten DOCX’e dönüşümü, GroupDocs.Conversion Cloud REST uç noktalarını doğrudan çağırarak gerçekleştirebilirsiniz. Aşağıdaki adımlar bir erişim belirteci almayı, bir PDF yüklemeyi, dönüşümü başlatmayı ve ortaya çıkan DOCX dosyasını indirmeyi gösterir.

Kimlik doğrulaması yapın ve bir erişim belirteci alın
YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini kimlik bilgilerinizle değiştirin.

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{
           "grant_type":"client_credentials",
           "client_id":"YOUR_CLIENT_ID",
           "client_secret":"YOUR_CLIENT_SECRET"
         }'

Yanıt, sonraki çağrılarda kullanacağınız access_token içerir.

Kaynak PDF’yi yükleyin

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @./local/input.pdf

Dönüşümü yürütün

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "format":"docx",
           "fileInfo":{"filePath":"input.pdf"},
           "outputPath":"output.docx",
           "options":{"preserveOriginalFormatting":true}
         }'

Yanıt, oluşturulan DOCX dosyasının yolunu döndürür.

Dönüştürülmüş DOCX’i İndir

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file/output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o ./local/output.docx

İstek yükleri ve ek seçenekler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’de PDF’den DOCX Dönüşümünü Parçalara Ayırma

Aşağıda, eşzamanlı kod örneğinin ana bölümlerine kısa bir inceleme yer almaktadır.

İstemciyi içe aktar ve yapılandır

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();

ConversionApi sınıfı (API reference) tüm dönüşüm işlemleri için giriş noktasıdır.

Kimlik doğrulama kimlik bilgilerini ayarlayın

apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

JWT kimlik doğrulaması, bulut hizmetine yapılan her isteği güvence altına alır.

Giriş dosyası bilgilerini hazırlayın

const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
inputFileInfo.filePath = path.normalize('input.pdf');

FileInfo API’ye kaynak PDF’nin GroupDocs Cloud depolamasında nerede bulunduğunu bildirir.

DOCX‑özel seçenekleri yapılandırın

const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
docxOptions.preserveOriginalFormatting = true;

DocxConvertOptions size orijinal düzeni korumanıza ve gerektiğinde şifreleri yönetmenize olanak tanır.

Dönüştürme isteğini oluşturun ve gönderin

const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
convertRequest.format = 'docx';
convertRequest.fileInfo = inputFileInfo;
convertRequest.outputPath = path.normalize('output.docx');
convertRequest.options = docxOptions;
const conversionResult = await apiInstance.convertDocument(convertRequest);

convertDocument yöntemi gerçek dönüşümü gerçekleştirir ve çıktı yolu ve dosya boyutu gibi meta verileri döndürür.

Kurulum ve Yapılandırma GroupDocs.Conversion Cloud SDK for Node.JS

Paketi yükleyin

npm install groupdocs-conversion-cloud

Paket, genel npm kaydından temin edilebilir. Sürüm ayrıntıları için indirme sayfasına bakın.

Önkoşullar
- Node.js 12 ve üzeri.
- Client ID ve client secret içeren bir GroupDocs Cloud hesabı.
Projenizde SDK’yı Başlatın (tam örnekten alıntı)

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';

Bölgesel bir uç nokta kullanıyorsanız basePath değerini ayarlayın.

Yüksek Performanslı Belge Dönüştürme için En İyi Uygulamalar

API istemcisini yeniden kullanın her dönüşüm için yeni bir örnek oluşturmaktan kaçının; bu, kimlik doğrulama yükünü azaltır.
Büyük PDF’ler için akış yüklemelerini etkinleştirin tüm dosyanın belleğe yüklenmesini önlemek için.
Mantıklı bir zaman aşımı ayarlayın (ör. 5 dakika) bekleyen işleri önlemek ve karmaşık belgelerin tamamlanmasına izin vermek için.
Orijinal biçimlendirmeyi yalnızca gerektiğinde koruyun; devre dışı bırakmak, yalnızca metin içeren basit PDF’lerde dönüşümü hızlandırabilir.
API kullanım limitlerini izleyin GroupDocs hesabınızın kontrol panelinde toplu işlemler sırasında sınırlamaya takılmamak için.

Sonuç

GroupDocs.Conversion Cloud SDK for Node.js PDF’den DOCX’e dönüşümü sorunsuz hale getirir, ister tam özellikli bir kütüphane ister cURL ile doğrudan REST çağrıları tercih edin. Asenkron kod örneğini izleyerek, istemciyi doğru şekilde yapılandırarak ve yukarıdaki performans ipuçlarını uygulayarak, herhangi bir Node.JS hizmetine güvenilir belge dönüşümünü entegre edebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans, değerlendirme amacıyla geçici lisans sayfası adresinden alınabilir.

SSS

PDF’den DOCX’e dönüşüm Node.JS’te karmaşık düzenleri nasıl ele alır?
SDK, varsayılan olarak orijinal biçimlendirmeyi korumaya çalışır. Hızı artırmak için doğrulukla takas yapmak amacıyla DocxConvertOptions içinde preserveOriginalFormatting seçeneğini açıp kapatabilirsiniz. Tüm seçenekler için API referansına bakın.
PDF’den DOCX’e dönüşümde dosya boyutu sınırları nelerdir?
Bulut hizmeti, ücretsiz hesaplar için 200 MB’a kadar dosyaları kabul eder; daha büyük dosyalar yükseltilmiş bir plan gerektirir. Yüklemeler akış olarak yapılır, bu yüzden sunucunuzdaki bellek kullanımı düşük kalır.
Tek bir istek içinde birden fazla PDF’i DOCX’e dönüştürebilir miyim?
API, istekte bir belge işler, ancak Node.JS’te bir dosya listesi üzerinde döngü yaparak ve hesabınızın eşzamanlılık limitlerine uyarak dönüşümleri paralel olarak çalıştırabilirsiniz.
Yerel olarak, ücretli bir lisans olmadan dönüşümü test etmenin bir yolu var mı?
Evet, geçici lisans sayfasından geçici bir değerlendirme lisansı talep edebilirsiniz. Bu, geliştirme ve test için tam işlevsellik sağlar.

nodejs conversion on Document Processing REST APIs | GroupDocs Cloud