Belgeleri Birleştir - Belge Montajı API
PDF4me Belgeleri Birleştir Bu özellik, gelişmiş biçimlendirme ve uyumluluk seçenekleriyle birden fazla Word belgesini tek bir belgede birleştirmenizi sağlar. API Bu hizmet, birden fazla Word dosyasını işler ve esnek belge sıralaması, özelleştirilebilir biçimlendirme modları, uyumluluk düzeyi ayarları, saat dilimi meta verileri ve akıllı stil yönetimi ile birleştirir. API belge içeriklerini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Sınırsız belge birleştirme desteği ve birleştirme davranışı üzerinde tam kontrol ile bu çözüm, belge derleme, rapor konsolidasyonu ve içerik yönetimi iş akışları için idealdir.
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.
Başlıca Özellikler
- Çoklu Belge DesteğiSınırsız sayıda belgeyi tek bir belgede birleştirin.
- Basit Dizi YapısıKullanımı kolay dizi Base64-kodlanmış belge içeriği
- Sıralı BirleştirmeBelgeler, dizide göründükleri sırayla birleştirildi.
- Temel Belge Kavramıİlk belge, birleştirme işleminin temelini oluşturur.
- Çoklu Biçim DesteğiWord belgelerini, PDF'leri ve diğer desteklenen formatları birleştirin.
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm belge birleştirme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
office/ApiV2Word/MergeDocuments
REST API Parametreler
Belgeleri Birleştirme 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. belgeler Dizi en az bir belge içermelidir.
Gerekli Parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| belgeler* | Array | Birleştirilecek belge nesnelerinin dizisi. En az bir belge içermelidir. Her nesne şu özelliklere sahip olmalıdır: dosya adı (dize) ve belge içeriği (Base64 (Dize). Belgeler dizide göründükleri sırayla birleştirilir. İsteğe bağlı belge başına alanlar: sıralamaKonumu (tam sayı), formatModu (sicim) | [{ "filename": "doc1.docx", "docContent": "base64..." }, { "filename": "doc2.docx", "docContent": "base64..." }] |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| birleştirme seçenekleri | Object | Birleştirme seçenekleri (biçimlendirme, uyumluluk vb.). Kullanılabilir özellikler için eklenti modeline bakın. | {} |
Belge Birleştirme Sırası
Belgeler, göründükleri sırayla birleştirilir. belgeler sıralamak:
- Dizideki ilk belge şu hale gelir: temel belge
- Sonraki tüm belgeler şunlardır: eklenmiş temel belgeye dizi sırasına göre
Çıktı
O PDF4me Belgeleri Birleştir 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.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Senkron İşleme (Varsayılan)
O API İsteği işler ve geri döner:
Durum Kodu: 200 Tamam
İçerik Türü: application/json
Yanıt Metni:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "merged-document.docx",
"success": true,
"errorMessage": null
}
Yanıt Alanları:
- belge (dize): Tüm girdi belgelerini içeren birleştirilmiş Word belgesi, şu şekilde kodlanmıştır: Base64 sicim
- dosya adı (dize): Çıktı Word dosyasının adı
- başarı (mantıksal değer): İsteğin başarılı olup olmadığını gösterir.
- hataMesajı (dize veya boş): Başarı başarısız olduğunda hata ayrıntıları
Kullanım Talimatları:
- Çıkarın
documenttarladan JSON cevap (Base64) - Şifreyi çöz Base64 Word belgesinin ikili verilerini almak için kullanılan dize
- Word dosyasını gerektiği gibi kaydedin veya işleyin.
Örnek (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Asenkron İşleme
Asenkron davranış (202) Accepted (Yoklama ile birlikte) bu özellik, istek gövdesi parametresiyle değil, sunucu yapılandırmasıyla kontrol edilir. Etkinleştirildiğinde, API yoklama işlemiyle 202 durum kodu döndürebilir. URL içinde Location başlık. Sorgula URL ile GET 200 talep alana kadar OK Aynı yanıt biçimiyle (belge, dosya adı, başarı, hata mesajı).
Hata Yanıtları
O API standart iadeler HTTP Hata kodları ve hata detayları:
- Geçersiz istek parametreleri
- Gerekli alanlar eksik (
belgelersıralamak) - Birleştirilecek belge yok (boş belge dizisi)
- Geçersiz Base64 belge içeriğinde kodlama
- Geçersiz veya bozuk belgeler
- Geçersiz veya eksik API anahtar
- API anahtar düzgün değil Base64 kodlanmış Authorization başlık
- Eksik
Yetkilendirme: Temelbaşlık
- Sunucu tarafı işlem hatası
- Word belgesi işleme hatası
- Belge birleştirme hatası
Hata Yanıtı Biçimi:
{
"error": "Error message describing what went wrong"
}
Yanıt Biçimi Ayrıntıları
Önemli: O API her zaman geri döner JSONAsla ikili Word verilerini doğrudan kullanmayın.
Yanıt Yapısı:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
İçerik Türü Başlığı:
- Başarı:
application/json - Word belgesi şu şekilde yerleştirilmiştir: Base64 dize içinde JSON cevap
Neden Base64?
- JSON-ikili veriler için güvenli kodlama
- İletilmesi kolay HTTP
- Tüm programlama dilleriyle uyumludur.
- Doğrudan içine yerleştirilebilir JSON sorunlardan kaçmadan
Kod çözme Base64 Word Belgesine:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
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ınAuthorization: Basic YWJjMTIz
Yük
Temel Örnek (İki Belge):
{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" }
]
}
Gelişmiş Örnek (Birleştirme Seçenekleriyle Birden Çok Belge):
{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" },
{ "filename": "doc3.docx", "docContent": "base64EncodedDocument3" }
],
"mergeOptions": {}
}
Kod Örnekleri
O PDF4me Belgeleri Birleştir REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
Google Script Örnek
Google Apps Script uygulama için Google Workspace entegrasyon:
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri
- Sözleşme MontajıSözleşme bölümlerini birleştirerek eksiksiz yasal belgeler oluşturun.
- Hukuki Özetlerin BirleştirilmesiBirden fazla kısa bölümü birleştirerek kapsamlı hukuki özetler oluşturun.
- Uyumluluk Belgeleri: Mevzuat başvuruları için uyumluluk belgelerini bir araya getirin.
- Müşteri Belgesi DerlemeMüşteriye özel belgeleri eksiksiz paketler halinde birleştirin.
İşletme ve Kurumsal Kullanım Senaryoları
- Öneri ToplantısıTeklif bölümlerini birleştirerek eksiksiz müşteri teklifleri oluşturun.
- Pazarlama Materyallerinin KonsolidasyonuKampanyalar için pazarlama belgelerini birleştirin
- Satış Sunumu MontajıSunum bölümlerini birleştirerek eksiksiz sunumlar oluşturun.
- Müşteri Teslim Edilecek Ürün MontajıMüşteriye özel materyalleri bir araya getirin.
Eğitim ve Araştırma Kullanım Örnekleri
- Tıbbi Rapor DerlemesiTıbbi rapor bölümlerini birleştirerek eksiksiz hasta raporları oluşturun.
- Protokol DokümantasyonuProtokol bölümlerini kapsamlı tıbbi protokollere birleştirin.
- Araştırma DokümantasyonuÇalışma raporları için araştırma belgelerini bir araya getirin.
- Uyumluluk Kılavuzu MontajıSağlık hizmetleri uyumluluk belgelerini birleştirin:
Finans ve Bankacılık Kullanım Örnekleri
- Finansal Rapor DerlemesiFinansal rapor bölümlerini birleştirerek eksiksiz raporlar oluşturun.
- Denetim DokümantasyonuKapsamlı denetim raporları için denetim belgelerini bir araya getirin.
- Bütçe KonsolidasyonuFarklı departmanlardaki bütçe bölümlerini birleştirin.
- Düzenleyici Dosyalama Toplantısı: Gönderim için düzenleyici belgeleri birleştirin