Word'den Sayfaları Silme - Sayfa Yönetimi API
PDF4me Word'den Sayfaları Silme Bu özellik, esnek sayfa seçme seçenekleriyle Word belgelerinden belirli sayfaları veya sayfa aralıklarını kaldırmanıza olanak tanır. API Bu servis, Word dosyalarını işler ve aralık tabanlı silme (başlangıç sayfasından bitiş sayfasına), belirli sayfa numarası silme (virgülle ayrılmış listeler) ve birleşik silme kalıpları kullanarak sayfaları siler. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Sayfa seçimi, belge optimizasyonu ve içerik temizliği üzerinde tam kontrol desteğiyle bu çözüm, belge iyileştirme, içerik yönetimi ve belge hazırlama 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
- Esnek Sayfa SeçimiSayfaları belirli bir aralığa, sayılara veya her ikisinin kombinasyonuna göre silin.
- Aralık Tabanlı SilmeBaşlangıç sayfasından bitiş sayfasına kadar ardışık sayfaları kaldırın.
- Belirli Sayfa Silme: Virgülle ayrılmış sayfa numaraları kullanarak tek tek sayfaları kaldırın.
- Belge OptimizasyonuBelgeleri istenmeyen içerikleri kaldırarak temizleyin.
- Biçim KorumaOrijinal belge biçimini ve yapısını koruyun.
- Meta Veri KorumaBelge özelliklerini ve özel meta verilerini saklayın.
- DoğrulamaSayfa numarasının otomatik olarak doğrulanması ve hata yönetimi
- 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 sayfa silme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
office/ApiV2Word/DeletePages
REST API Parametreler
Word'den Sayfa Silme işlevinin parametrelerinin 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. En az bir sayfa silme parametresi (startPage, endPage veya pageNumbers) belirtilmelidir.
Gerekli Parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| belge* | Object | Belge referansı. İçermelidir. İsim (dize): .docx uzantılı Word dosya adı | { "Name": "document.docx" } |
| belge içeriği* | Base64 | Word belgesinin içeriği kodlanmıştır. Base64 | UEsDBBQABgAIAAAA... |
İsteğe Bağlı Parametreler (Sayfa silme işlemi için en az bir tanesi gereklidir)
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| başlangıç sayfası | Integer | Başlangıç sayfa numarası (1 tabanlı indeks). Silmeye başlanacak sayfa numarası. 1'den büyük veya eşit ve belge sayfa sayısından küçük veya eşit olmalıdır. Yalnızca startPage belirtilirse, bu sayfadan belgenin sonuna kadar silme işlemi yapılır. endPage'den büyük olamaz. | 2 |
| Sayfa sonu | Integer | Bitiş sayfa numarası (1 tabanlı indeks). Silme işleminin durdurulacağı sayfa numarası. Başlangıç sayfasından büyük veya eşit ve belge sayfa sayısından küçük veya eşit olmalıdır. Aralık kapsayıcıdır (hem başlangıç hem de bitiş sayfaları silinir). Karmaşık silme desenleri için sayfa numaralarıyla birleştirilebilir. | 5 |
| sayfa numaraları | String | Silinecek belirli sayfa numaralarının virgülle ayrılmış listesi. Biçim: "1,3,4" veya "1-3,5,7-9". Tek başına veya startPage/endPage ile birlikte kullanılabilir. Geçersiz sayfa numaraları sessizce göz ardı edilir. Örnek: "2,4,6,8" 2, 4, 6 ve 8. sayfaları siler. | "2,4,6" |
| kültürAdı | String | Belge işleme için kültür kodu (örneğin, "en-US", "de-DE", "fr-FR"). Varsayılan: null (kültüre özgü işlem yok). Belge dilini ve biçimlendirmesini etkiler. | en-US |
Sayfa Silme Modları
O API Birden fazla sayfa silme modunu destekler:
- Aralık Silme: Kullanmak
startPageVeendPageardışık sayfaları silmek için - Belirli Sayfa Silme: Kullanmak
pageNumberstek tek sayfaları silmek için - Birleşik SilmeHem aralık hem de belirli sayfa parametrelerini birlikte kullanın:
- Sonlandırmak için silinSadece şunu kullanın:
startPageo sayfadan silmek için belgenin sonuna kadar
Not: Tüm sayfa numaraları 1 tabanlıdır (ilk sayfa = 1, 0 değil). Sayfa numaraları, belge sayfa sayısına göre otomatik olarak doğrulanır.
Çıktı
O PDF4me Word'den Sayfaları Silme 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": "document.docx",
"success": true,
"errorMessage": null
}
Yanıt Alanları:
- belge (dize): Belirtilen sayfaları silinmiş 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 elde etmek 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 (
belgeileİsim,belge içeriği) - En az bir sayfa silme kriteri gereklidir (
başlangıç sayfası,Sayfa sonu, veyasayfa numaraları) - Geçersiz Base64 kodlamada
belge içeriği - Geçersiz veya bozuk Word belgesi
başlangıç sayfasıen büyük olamazSayfa sonu- Geçersiz sayfa numaraları (belge aralığı dışında)
- 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ı
- Sayfa silme 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);
Sayfa Silme Örnekleri
Farklı sayfa silme modellerini anlamak:
| Belge Sayfaları | başlangıç sayfası | Sayfa sonu | sayfa numaraları | Sonuç |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | Saklama kapasitesi: 1,5 |
| 1,2,3,4,5 | 3 | - | - | Saklananlar: 1,2 |
| 1,2,3,4,5 | - | - | "2,4" | Saklananlar: 1, 3, 5 |
| 1,2,3,4,5 | 2 | 3 | "5" | Saklananlar: 1,4 |
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 (Aralık Silme):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Örnek Sayfalar:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Gelişmiş Örnek (Birleşik Silme):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Kod Örnekleri
O PDF4me Word'den Sayfaları Silme 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şmeli TemizlikSözleşme kopyalarından imza sayfalarını ve eklerini çıkarın.
- Hukuki Belge HazırlığıMüşteriye dağıtımdan önce gizli sayfaları silin.
- Mahkeme Dosyalama OptimizasyonuDosyalama şartlarını karşılamak için gereksiz sayfaları kaldırın.
- Müşteri Belge Sürümleriİç notları kaldırarak temiz sürümler oluşturun.
İşletme ve Kurumsal Kullanım Senaryoları
- Teklif OptimizasyonuMüşteri tekliflerinden dahili maliyet sayfalarını kaldırın.
- Pazarlama Materyallerinin TemizlenmesiGüncel materyallerden eski içerik sayfalarını silin.
- Sunum HazırlığıSon sunumlardan yedek slaytları ve notları kaldırın.
- Müşteri Teslimatının Optimizasyonu: Dahili referansları kaldırarak temiz sürümler oluşturun
Eğitim ve Araştırma Kullanım Örnekleri
- Tıbbi Rapor TemizliğiHassas hasta bilgilerinin yer aldığı sayfaları kaldırın.
- Araştırma Belgesi OptimizasyonuÖn verileri nihai raporlardan silin.
- Protokol Belgesi HazırlığıYayınlanan protokollerden dahili inceleme sayfalarını kaldırın.
- Uyumluluk Belgeleri: Düzenleyici kurumlara yapılacak başvurular için belgeleri düzenleyin.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal Rapor TemizliğiÖzetlerden ayrıntılı ekleri kaldırın.
- Bütçe Belgesi Optimizasyonu: Mevcut bütçelerden geçmişe ait veri sayfalarını silin.
- Denetim Raporu HazırlanmasıHassas içerikli sayfaları dışarıya dağıtmadan önce kaldırın.
- Mevzuat Dosyası TemizliğiBelgelerinizi gönderim gereksinimlerini karşılayacak şekilde optimize edin.