Belgeyi Optimize Et - Belge Optimizasyonu API
PDF4me Belgeyi Optimize Et Bu özellik, üç farklı sıkıştırma seviyesi ve kapsamlı optimizasyon teknikleri kullanarak Word belgelerinizi boyut ve performans açısından optimize etmenizi sağlar. API Bu hizmet, Word dosyalarını işler, dosya boyutunu küçültür, görüntüleri sıkıştırır, içeriği temizler, biçimlendirmeyi normalleştirir ve kişisel bilgileri kaldırır. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Düşük, Orta ve Yüksek optimizasyon seviyelerini destekleyerek %0-90 dosya boyutu küçültme sağlayan bu çözüm, belge hazırlama, depolama optimizasyonu ve performans iyileştirme 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
- Maksimum OptimizasyonMaksimum dosya boyutu küçültme için maksimum sıkıştırma profili
- Dosya Boyutu KüçültmeMaksimum optimizasyon ile dosya boyutunda %80-90 oranında azalma sağlayın.
- Görüntü SıkıştırmaKaliteyi koruyarak akıllı görüntü optimizasyonu
- İçerik TemizliğiKullanılmayan makroları, yorumları ve gizli içeriği kaldırın.
- Biçimlendirme NormalizasyonuGereksiz biçimlendirmeleri ve kullanılmayan stilleri temizleyin.
- Kişisel Bilgilerin SilinmesiYazar, yönetici ve şirket bilgilerini kaldırın.
- Yazı Tipi OptimizasyonuYazı tiplerini normalleştirin ve gereksiz yazı tipi özelliklerini kaldırın.
- Uyumluluk GeliştirmeWord 2016 uyumluluğu için belgeleri optimize edin.
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm belge optimizasyon işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
office/ApiV2Word/OptimizeDocument
REST API Parametreler
Belgeyi Optimize Etme 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. Optimizasyon seviyesi, uygulanan optimizasyon tekniklerinin agresifliğini belirler.
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. Base64Orijinal belge değiştirilmedi - yeni, optimize edilmiş bir sürüm oluşturuldu. | UEsDBBQABgAIAAAA... |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| optimizasyonSeviyesi | String | Optimizasyon seviyesi (örneğin Düşük, Orta, Maksimum). Maksimum - Maksimum sıkıştırma (~%80-90). Optimizasyon tekniklerinin agresifliğini kontrol eder. | "Max" |
| kelime sürümü | String | Uyumluluk için hedef Word sürümü | null |
| kültürAdı | String | Belge işlemeye yönelik kültür kodu (ör. "en-US", "de-DE", "fr-FR") | en-US |
Optimizasyon Profili
O Maksimum Optimizasyon profili maksimum sıkıştırma sağlar:
- Dosya Boyutu Küçültme: %80-90
- Görüntü KalitesiBoyut için optimize edilmiştir.
- Biçimlendirme: Agresif temizlik
- Yorumlar: Kaldırıldı
- Revizyonlar: Kaldırıldı
- Kişisel Bilgiler: Kaldırıldı
- Makrolar: Kaldırıldı
- Kullanılmayan Stiller: Kaldırıldı
- Gizli İçerik: Kaldırıldı
Çıktı
O PDF4me Belgeyi Optimize Et 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): Dosya boyutu küçültülmüş, optimize edilmiş 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 (
belgeileİsim,belge içeriği) - Geçersiz Base64 kodlamada
belge içeriği - Geçersiz veya bozuk Word belgesi
- Geçersiz optimizasyon seviyesi
- 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 optimizasyonunda başarısızlık
- Sıkıştırma ayarları uygulanırken hata oluştu.
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 (Varsayılan Maksimum Optimizasyon):
{
"document": { "Name": "document.docx" },
"docContent": "base64EncodedDocumentContent",
"optimizationLevel": "Max"
}
Gelişmiş Örnek (İsteğe Bağlı Alanlarla):
{
"document": { "Name": "document.docx" },
"docContent": "base64EncodedDocumentContent",
"optimizationLevel": "Max",
"wordVersion": null,
"cultureName": "en-US"
}
Kod Örnekleri
O PDF4me Belgeyi Optimize Et 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
- Belge DağıtımıMüşteri dağıtımı için yasal belgeleri optimize edin:
- Kamuya Açık Dosyalama: Kamuoyu önünde mahkemeye sunulacak belgeleri hazırlayın.
- Arşiv DepolamaHukuki belgelerin uzun süreli saklanması için optimizasyon
- Uyumluluk Belgeleri: Düzenleyici kurumlara yapılacak başvurular için belgeleri düzenleyin.
İşletme ve Kurumsal Kullanım Senaryoları
- Teklif DağıtımıMüşteriye teslimat için teklifleri optimize edin
- Pazarlama Materyali Paylaşımı: Pazarlama belgelerini halka dağıtım için optimize edin
- Sunum OptimizasyonuSunumları e-posta dağıtımı için optimize edin.
- Müşteri Teslim Edilecek Ürün HazırlığıMüşteriye teslimat için belgeleri düzenleyin.
Eğitim ve Araştırma Kullanım Örnekleri
- Hasta Raporu DağıtımıGüvenli paylaşım için tıbbi raporları optimize edin.
- Araştırma DokümantasyonuYayın için araştırma belgelerini optimize edin.
- Protokol Paylaşımı: Departman dağıtımı için tıbbi protokolleri optimize edin
- Uyumluluk Belgeleri: Düzenleyici kurumlara yapılacak başvurular için belgeleri düzenleyin.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal Rapor DağıtımıPaydaşlara dağıtım için finansal raporları optimize edin:
- Denetim DokümantasyonuDış paylaşım için denetim belgelerini temizleyin.
- Bütçe Belgesi Paylaşımı: Departman dağıtımı için bütçe belgelerini optimize edin
- Düzenleyici Dosyalama: Düzenleyici kurumlara yapılacak başvurular için belgeleri hazırlayın.