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

Belgeyi Bölme - Belge Bölümleme API

PDF4me Belgeyi Bölünmüş Bu özellik, Word belgelerini esnek bölme seçenekleri ve kapsamlı yapılandırma kontrolüyle birden fazla küçük belgeye bölmenizi sağlar. API Bu hizmet, Word dosyalarını işler ve bunları sayfalara, bölümlere, başlıklara veya özel sayfa aralıklarına göre böler; bölme kriterleri, belge adlandırması ve çıktı organizasyonu üzerinde tam kontrol sağlar. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Sayfa bazlı bölme, bölüm bazlı ayırma, başlık bazlı ayırma ve özel sayfa aralıkları desteğiyle bu çözüm, belge yönetimi, içerik dağıtımı ve iş akışı otomasyonu 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​

  • Çoklu Bölme TürleriSayfalara, bölümlere, başlıklara veya özel aralıklara göre bölün
  • Sayfa Aralığı Desteği: Belirli sayfa numaralarına veya aralıklarına göre bölme
  • Bölüm Bazlı BölmeHer Word bölümünden sonra belgeyi ikiye bölün.
  • Başlık Bazlı BölümlemeBelirtilen stildeki her başlığın ardından belgeyi ikiye bölün (örneğin, Başlık 1, Başlık 2).
  • Esnek Yapılandırma: splitConfig parametresiyle özel bölme kriterleri
  • Benzersiz Belge AdlarıBölünmüş her belgeye benzersiz bir GUID dosya adı atanır.
  • Biçim KorumaOrijinal belge biçimlendirmesini ve yapısını korur.
  • Kültür Desteği: Bölgeye özgü belge işleme

REST API Uç nokta​

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

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

REST API Parametreler​

Bölünmüş 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. splitConfig parametre şu durumlarda gereklidir: splitType "Dizi", "sayfa sayısı" veya "başlıklar"dır.

Gerekli Parametreler​

ParametreTipTanımÖrnek
belge*ObjectBelge referansı. İçermelidir. İsim (string): .docx uzantılı Word dosya adı. Referans ve işleme amacıyla kullanılır.{ "Name": "document.docx" }
belge içeriği*Base64Word belgesinin içeriği kodlanmıştır. Base64Belge, belirtilen kriterlere göre bölünür. Geçerli bir Word belgesi olmalıdır (.docx, .doc formatları).base64EncodedDocumentContent

İsteğe bağlı parametreler​

ParametreTipTanımÖrnek
bölünmüşTürüStringBelge bölme türü. Seçenekler: allpages - Ayrı sayfalara bölünmüş (varsayılan), array - Belirli sayfa aralıklarına göre bölünmüştür (örneğin "1-3,4,5-7"), numberofpages - Her N sayfada bir bölme işlemi (yapılandırma: "3" veya "5" gibi pozitif bir tamsayı), section - Belgeyi her bölümden sonra ikiye ayırın, headings - Belirtilen stilin her başlığından sonra belgeyi bölün (örneğin, "Başlık 1"). Bölünmüş her belgeye benzersiz bir kimlik atanır. GUID dosya adı"allpages"
bölünmüş yapılandırmaStringBölme işlemi için yapılandırma. Dizi içinSayfa aralıkları "1-3,4,5-7" (sayfa 1-3, sayfa 4, sayfa 5-7) veya tek sayfalar "1,3,5" şeklinde olabilir. Sayfa sayısı için: "3" veya "5" gibi pozitif bir tamsayı: her N sayfada bir bölme işlemi yapar. Başlıklar içinBaşlık stili adı, örneğin "Başlık 1" veya "Başlık 2". splitType "array", "numberofpages" veya "headings" olduğunda gereklidir. Sayfa numaraları 1'den başlar. Başlık eşleştirmesi büyük/küçük harf duyarlı değildir."1-3,4,5-7" veya "3" veya "Heading 1"
kültürAdıStringBelge işleme için kültür kodu (örneğin, "en-US", "de-DE", "fr-FR"). Varsayılan: "en-US". Belge dilini ve biçimlendirmesini etkiler. Meta veri ve yerelleştirme işlemleri için kullanılır.en-US

Bölme Tipi Seçenekleri​

O API Belge bölme işlemleri için farklı bölme türleri sunar:

Bölünmüş TipTanımSplitConfig gerektirir.Kullanım Durumu
allpagesAyrı sayfalara bölünmüş (varsayılan)HAYIRHer sayfayı ayrı bir belge olarak çıkarın.
arraySayfa aralıkları belirtilerek bölünür. Virgülle ayrılmış her aralık bir belge haline gelir (örneğin "1-3,4,5-7" → 3 belge).EvetBelirli sayfa aralıklarından veya tek sayfalardan belge oluşturun.
numberofpagesHer N sayfada bir bölünür. Bölme işlemi ardışık olarak yapılır: her N sayfa bir belge oluşturur; kalan kısım son belgedir.EvetEşit büyüklükte parçalara bölün (örneğin her 3 veya 5 sayfada bir).
sectionHer Word bölümünden sonra belgeyi bölün.HAYIRBölüm başına bir belge
headingsBelirtilen stildeki her başlığın ardından belgeyi bölün (örneğin, "Başlık 1").EvetBaşlık düzeyine göre bölümleri veya kısımları çıkarın.

Bölünmüş Yapılandırma Örnekleri​

Bölme yapılandırmasını anlamak, belge bölme iş akışlarınızı optimize etmenize yardımcı olur:

array: açık sayfa aralıkları​

  • "1-3,4,5-7" → 3 belge: sayfalar 1-3, sayfa 4, sayfalar 5-7
  • "1,3,5" → 3 belge: sayfa 1, sayfa 3, sayfa 5
  • "1-5,6-10" → 2 belge: sayfalar 1-5, sayfalar 6-10

numberofpages: her N sayfadan sonra bölün​

Davranış: Her N sayfada bir ardışık olarak bölünür. Yapılandırma: Gerekli, format tek bir pozitif tam sayı olmalıdır (örneğin, "3", "5").

Örnekler:

  • Yapılandırma "3" 10 sayfalık bir belgede → 4 belge: Belge 1: 1-3. sayfalar, Belge 2: 4-6. sayfalar, Belge 3: 7-9. sayfalar, Belge 4: 10. sayfa
  • Yapılandırma "5" 12 sayfalık bir belgede → 3 belge: Belge 1: 1-5. sayfalar, Belge 2: 6-10. sayfalar, Belge 3: 11-12. sayfalar

headings: her başlıktan sonra bölün​

  • "Heading 1"Her blokta bir belge bulunur ve bu belge bir sonraki Başlık 1'de (veya belgenin sonunda) sona erer.
  • "Heading 2"Her blokta bir belge bulunur ve bu belge bir sonraki Başlık 2'de (veya belgenin sonunda) sona erer.
  • Büyük/küçük harf duyarlılığı olmayan eşleştirme

section​

Herhangi bir yapılandırma gerekmez. Belge, her Word bölüm sonundan sonra bölünür; her bölüm tek bir belge haline gelir.

Çıktı​

O PDF4me Belgeyi Bölünmüş REST API Bölme sonucunu şu şekilde döndürür: JSON. O API Yanıt olarak standart yanıt alanlarıyla birlikte tek bir belge (ilk bölünmüş belge) döndürür.

Senkron İşleme (Varsayılan)

O API İsteği işler ve ilk bölünmüş belgeyi döndürür:

Durum Kodu: 200 OK

İçerik Türü: application/json

Yanıt Metni:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "a1b2c3d4-e5f6-7890-abcd-ef1234567890.docx",
"success": true,
"errorMessage": null
}

Yanıt Alanları:

  • belge (string): Bölünmüş belgenin ilk içeriği, şu şekilde kodlanmıştır: Base64 sicim
  • dosya adı (string): Bölünmüş belge için oluşturulan dosya adı (GUID-temelli)
  • 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 elde etmek için kullanılan dize
  3. Kullanın fileName Bölünmüş belgeyi kaydetmek için

Örnek (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save with data.fileName or custom name

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 (Tüm Sayfaları Böl - Varsayılan):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "allpages"
}

Sayfa Aralığı Örneği (dizi):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "array",
 "splitConfig": "1-3,4,5-7"
}

Her N sayfadan sonra bölme örneği (sayfa sayısı):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "numberofpages",
 "splitConfig": "3"
}

Başlık Bazlı Örnek (her başlıktan sonra bölme):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "headings",
 "splitConfig": "Heading 1",
 "cultureName": "en-US"
}

Bölüm Bazlı Örnek (her bölümden sonra bölünmüştür):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "splitType": "section",
 "cultureName": "en-US"
}

Kod Örnekleri​

O PDF4me Belgeyi Bölünmüş 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 belgelerini bölmek için uygulama:

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

Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri

  • Sözleşme YönetimiÇok taraflı sözleşmeleri ayrı bölümlere ayırın
  • Dava BelgeleriDosyalardan belirli sayfaları ayıklamak
  • Uyumluluk Raporlarıİlgili bölümleri farklı departmanlara dağıtın.
  • Hukuk AraştırmasıBüyük hukuk belgelerini konu veya bölüme göre ayırın.

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started