Word Belgelerinden Meta Verileri Çıkarma - Belge Analizi API
PDF4me Word'den Meta Verileri Çıkarma Bu özellik, ayrıntılı belge analizi yetenekleriyle Word belgelerinden kapsamlı meta verileri ve özellikleri çıkarmanızı sağlar. API Bu servis, Word dosyalarını işler ve yerleşik belge özelliklerini, özel özellikleri, belge istatistiklerini, yazar bilgilerini, oluşturma tarihlerini ve revizyon takibini alır. API Word belgesi içeriğini şu yolla alır: REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Kültüre özgü biçimlendirme ve yerelleştirme desteğiyle bu çözüm, belge yönetimi, uyumluluk takibi, içerik analizi ve kurumsal belge 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
- Kapsamlı Meta Veri ÇıkarmaBelgeye ait tüm yerleşik ve özel özellikleri alın.
- Belge İstatistikleri: Sayfa sayısını, kelime sayısını, karakter sayısını ve paragraf sayısını gerçek zamanlı olarak öğrenin.
- Yazar BilgileriYazar, yönetici, şirket ve iletişim bilgilerini çıkarın.
- Tarih/Saat ÖzellikleriOluşturma, değiştirme ve yazdırma zaman damgalarını al
- Özel ÖzelliklerOtomatik önekleme özelliğiyle tüm özel belge özelliklerine erişin.
- Kültür DesteğiTarih ve saatleri belirtilen yerel ayara göre biçimlendirin.
- Sadece Okuma İşlemiOrijinal belgeyi değiştirmeden meta verileri çıkarın.
- Yapılandırılmış Çıktı: Düzenlenmiş meta verileri döndürün JSON kolay işleme için format
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm meta veri çıkarma işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
office/ApiV2Word/ExtractMetadata
REST API Parametreler
Word'den Meta Verileri Çıkarma 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 ve mutlaka sağlanmalıdır. API doğru şekilde çalışması için.
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
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| kültürAdı | String | Tarih/saat biçimlendirmesi için kültür kodu (örneğin, "en-US", "de-DE", "fr-FR"). Varsayılan: InvariantCulture (tutarlı biçimlendirme). Meta verilerdeki tarih/saat görüntüleme biçimini etkiler. Geçersiz kültürler InvariantCulture'a geri döner. | en-US |
Çıktı
O PDF4me Word'den Meta Verileri Çıkarma REST API İşleme moduna bağlı olarak farklı yanıtlar döndürür. API meta verileri şu şekilde döndürür: JSON nesneİ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": null,
"fileName": null,
"success": true,
"errorMessage": null,
"metadata": {
"Author": "John Doe",
"Title": "Project Proposal",
"Subject": "Q1 2024 Planning",
"Keywords": "planning, budget, strategy",
"Comments": "Draft version for review",
"Category": "Business",
"Company": "Acme Corporation",
"Manager": "Jane Smith",
"Created": "1/15/2024 10:30:00 AM",
"LastModified": "1/20/2024 2:45:00 PM",
"LastPrinted": "1/18/2024 9:15:00 AM",
"RevisionNumber": 3,
"TotalEditingTime": 120,
"Pages": 8,
"Words": 2150,
"Characters": 12800,
"Paragraphs": 45,
"Custom_Department": "Marketing",
"Custom_ProjectCode": "PRJ-2024-001",
"Custom_Confidential": "Internal"
}
}
Yanıt Alanları:
- belge (Base64 (veya boş): Meta veri çıkarımı için kullanılmaz; boş olabilir.
- dosya adı (dize veya boş): Meta veri çıkarımı için kullanılmaz; boş olabilir.
- 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ı
- meta veriler (nesne): Tüm belge özelliklerini içeren kapsamlı meta veri sözlüğü
Kullanım Talimatları:
- Çıkarın
metadatatarladan JSON cevap - İhtiyaç duyulduğunda bireysel özelliklere erişim sağlayın.
- Belge sınıflandırması, uyumluluk takibi veya analizi için meta verileri kullanın.
Örnek (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const author = data.metadata.Author;
const pageCount = data.metadata.Pages;
// Access any metadata property
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 şekliyle (dahil olmak üzere) metadata, success, errorMessage).
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 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ı
- Meta veri çıkarma 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 JSON Meta veri nesnesi ile birlikte.
Yanıt Yapısı:
{
"document": "Base64 or null",
"fileName": "string or null",
"success": true,
"errorMessage": "string or null",
"metadata": {
// Built-in properties
"Author": "string",
"Title": "string",
"Subject": "string",
"Keywords": "string",
"Comments": "string",
"Category": "string",
"Company": "string",
"Manager": "string",
"Created": "string (formatted date/time)",
"LastModified": "string (formatted date/time)",
"LastPrinted": "string (formatted date/time)",
"RevisionNumber": "integer",
"TotalEditingTime": "integer (minutes)",
// Document statistics
"Pages": "integer",
"Words": "integer",
"Characters": "integer",
"Paragraphs": "integer",
// Custom properties (prefixed with Custom_)
"Custom_PropertyName": "value"
}
}
İçerik Türü Başlığı:
- Başarı:
application/json - Meta veriler yapılandırılmış bir biçimde döndürülür. JSON nesne
Meta Verilere Erişim:
JavaScript/Node.js:
const metadata = response.metadata;
console.log(`Author: ${metadata.Author}`);
console.log(`Pages: ${metadata.Pages}`);
console.log(`Words: ${metadata.Words}`);
Python:
metadata = response['metadata']
print(f"Author: {metadata['Author']}")
print(f"Pages: {metadata['Pages']}")
print(f"Words: {metadata['Words']}")
C#:
var metadata = response.Metadata;
Console.WriteLine($"Author: {metadata["Author"]}");
Console.WriteLine($"Pages: {metadata["Pages"]}");
Console.WriteLine($"Words: {metadata["Words"]}");
Meta Veri Özellikleri
Dahili Belge Özellikleri
| Mülk Adı | Tip | Tanım | Örnek |
|---|---|---|---|
| Yazar | String | Belge yazarının adı | "John Doe" |
| Başlık | String | Belge başlığı | "Project Proposal" |
| Ders | String | Belge konusu | "Q1 2024 Planning" |
| Anahtar Kelimeler | String | Belge anahtar kelimeleri (virgülle ayrılmış) | "planning, budget, strategy" |
| Yorumlar | String | Belge yorumları | "Draft version for review" |
| Kategori | String | Belge kategorisi | "Business" |
| Şirket | String | Firma Adı | "Acme Corporation" |
| Müdür | String | Yönetici adı | "Jane Smith" |
| Oluşturuldu | String | Belgenin oluşturulma tarihi/saati (biçimlendirilmiş) | "1/15/2024 10:30:00 AM" |
| SonDeğiştirilme Tarihi | String | Son kaydedilme tarihi/saati (biçimlendirilmiş) | "1/20/2024 2:45:00 PM" |
| SonYazdırma | String | Son yazdırma tarihi/saati (biçimlendirilmiş) | "1/18/2024 9:15:00 AM" |
| Revizyon Numarası | Integer | Belge revizyon numarası | 3 |
| ToplamDüzenlemeSüresi | Integer | Toplam düzenleme süresi (dakika) | 120 |
Belge İstatistikleri
| Mülk Adı | Tip | Tanım | Örnek |
|---|---|---|---|
| Sayfalar | Integer | Toplam sayfa sayısı | 8 |
| Kelimeler | Integer | Toplam kelime sayısı | 2150 |
| Karakterler | Integer | Toplam karakter sayısı | 12800 |
| Paragraflar | Integer | Toplam paragraf sayısı | 45 |
Özel Özellikler
Özel özellikler şu ön ekle belirtilir: Custom_ Yanıtta:
Custom_Department- Gümrük departmanına ait mülkCustom_ProjectCode- Özel proje kodu özelliğiCustom_Confidential- Özel gizlilik seviyesi- Word belgesinde tanımlanmış diğer özel özellikler
Desteklenen Kültür Örnekleri
| Kültür Kodu | Tanım | Tarih Biçimi Örneği |
|---|---|---|
en-US | İngilizce (Amerika Birleşik Devletleri) | "15/01/2024 10:30:00" |
en-GB | İngilizce (Birleşik Krallık) | "15/01/2024 10:30:00" |
de-DE | Almanca (Almanya) | "15.01.2024 10:30:00" |
fr-FR | Fransızca (Fransa) | "15/01/2024 10:30:00" |
es-ES | İspanyolca (İspanya) | "15/01/2024 10:30:00" |
ja-JP | Japonca (Japonya) | "2024/01/15 10:30:00" |
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 (Sadece Gerekli Alanlar):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC..."
}
Gelişmiş Örnek (İsteğe Bağlı Alanlarla):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"cultureName": "en-US"
}
Kod Örnekleri
O PDF4me Word'den Meta Verileri Çıkarma 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 SınıflandırmasıHukuki belgeleri dava türüne, müvekkile veya uzmanlık alanına göre sınıflandırın.
- Uyumluluk TakibiMevzuat uyumluluğu için belge oluşturma tarihlerini ve revizyon geçmişini izleyin.
- Müşteri Belge YönetimiMüşteri dosyası organizasyonu için belge özelliklerini takip edin.
- Denetim İzleme BakımıHukuki denetim gereklilikleri için belge meta verilerini kaydet.
İşletme ve Kurumsal Kullanım Senaryoları
- Teklif YönetimiMüşteri takibi ve analizi için tekliflerden meta verileri çıkarın.
- Pazarlama Materyali OrganizasyonuPazarlama belgelerini kampanya ve hedef kitleye göre sınıflandırın.
- İçerik Performans Analiziİçerik optimizasyonu için belge istatistiklerini analiz edin.
- Müşteri Teslimat TakibiMüşteri proje yönetimi için belge özelliklerini izleyin.
Eğitim ve Araştırma Kullanım Örnekleri
- Tıbbi Belge SınıflandırmasıTıbbi belgeleri hasta, işlem veya departmana göre sınıflandırın.
- Araştırma DokümantasyonuAraştırma belgelerinden çalışma takibi için meta verileri ayıklamak.
- Akademik ve Hasta KayıtlarıAkademik ve hasta belgelerini meta veri özelliklerine göre düzenlemek
- Uyumluluk ve EtikSağlık ve araştırma mevzuatına uyumluluk için belge meta verilerini izleyin.
Finans ve Bankacılık Kullanım Örnekleri
- Finansal Rapor AnaliziUyumluluk takibi için finansal raporlardan meta verileri çıkarın.
- Bütçe Belge YönetimiBütçe belgelerini departmana ve mali yıla göre sınıflandırın.
- Denetim DokümantasyonuDenetim izi bakımı için belge özelliklerini takip edin.
- Düzenleyici Dosyalama: Düzenleyici başvuru gereklilikleri için belge meta verilerini izleyin.