Ek dosyaya ekle PDF - Dosya Gömme API
PDF4me Ek dosyaya ekle PDF Dosya ekleri eklemenizi sağlar PDF Belgeler, gömülü dosyalar içeren kapsamlı belge paketleri oluşturma. Bu API hizmet süreçleri PDF belgeleri ve çeşitli ek dosya türlerini doğrudan içine yerleştirme PDFs. O API kaynağı alır PDF dosyalar ve ek dosyalar aracılığıyla REST API aramalar, kullanarak Base64 Güvenli dosya iletimi için kodlama. Çoklu dosya türü desteği ve toplu ek işleme özelliğiyle bu çözüm, belge yönetim sistemleri, kurumsal iş akışları ve güvenilirliğe ihtiyaç duyan iş uygulamaları için idealdir. PDF Ek işlevselliği.
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
- Birden Çok Dosya TürüÇeşitli dosya eki formatlarını destekler; bunlar arasında metin, resim ve dokümanlar bulunur.
- Toplu EklerTek bir dosyaya birden fazla ek dosya ekleyin. PDF belge
- Base64 Kodlama: Güvenli dosya içeriği iletimi kullanarak Base64 kodlama
- Belge KorumaOrijinal halini korur PDF ekler eklerken yapı
- Esnek AdlandırmaDaha iyi düzenleme için dosya adlarını özelleştirin.
- Profesyonel Ambalajlama: Gömülü kaynaklar içeren kapsamlı belge paketleri oluşturun
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm ek dosya ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
/api/v2/AddAttachmentToPdf
REST API Parametreler
Ek dosya ekleme işlemi için parametrelerin tam listesi PDF 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 adı* | String | Çıktı PDF .pdf uzantılı dosya adı | output.pdf |
| belge içeriği* | Base64 | Girişin içeriği PDF dosya şu şekilde kodlanmıştır: Base64 | JVBERi... |
| ekler* | Array | Gömülecek ek nesnelerin dizisi PDFHer nesne şunları içermelidir: docName (dize) ve docContent (base64 dizesi) | Aşağıdaki örneğe bakın. |
Ek Nesne Yapısı
Her bir öğe attachments Dizi, aşağıdaki yapıya sahip bir nesne olmalıdır:
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| belge adı | String | Ek dosya adı ve uzantısı (örneğin, .txt, .pdf, .jpg, vb.) | attachment.txt |
| belge içeriği | Base64 | Ekli dosyanın içeriği şu şekilde kodlanmıştır: Base64 | RXhhbXBsZSBvZiBhdHRhY2htZW50IGZpbGUuIA== |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| asenkron | Boolean | Asenkron işlemeyi etkinleştirin. true, o API 202 durum kodu döndürür ve bir yoklama işlemi sağlar. URL içinde Location başlık | true |
Çıktı
O PDF4me Ek dosyaya ekle PDF REST API İşleme moduna bağlı olarak farklı yanıtlar döndürür. API geri döner PDF olarak 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)
Ne zaman async ayarlanmamış veya ayarlanmış false, o API İsteği hemen işleme koyar:
Durum Kodu: 200 OK
İçerik Türü: application/json
Yanıt Metni:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}
Yanıt Alanları:
- belge adı (dize): Çıktı PDF dosya adı
- belge içeriği (dize): The PDF Ekli dosyalar içeren ve şu şekilde kodlanmış dosya: Base64 sicim
Kullanım Talimatları:
- Çıkarın
docContenttarladan JSON cevap - Şifreyi çöz Base64 ikili veriyi elde etmek için kullanılan dize PDF veri
- Kaydet veya işle PDF Dosyayı gerektiği gibi düzenleyin.
Örnek (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes
Asenkron İşleme
Ne zaman async: true ayarlanmıştır, API İsteği eşzamansız olarak işler:
Durum Kodu: 202 Kabul Edildi
Yanıt Başlıkları:
Location: https://api.pdf4me.com/api/v2/AddAttachmentToPdf/poll/12345-abcde-67890
Anket Süreci:
- Çıkarın
Location202 yanıtından gelen başlık - Ankete katılın URL kullanarak GET istekler
- Yanıt alana kadar anket yapmaya devam edin. 200 OK durum
- Son yanıt aynı içeriği içermektedir. JSON format ile
docNameVedocContent(Base64)
Anket Örneği:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const data = await pollResponse.json();
// Process data.docContent (Base64 PDF)
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Hata Yanıtları
O API standart iadeler HTTP Hata kodları ve hata detayları:
- Geçersiz istek parametreleri
- Gerekli alanlar eksik (
belge adı,belge içeriği,ekler) - Geçersiz Base64 kodlamada
belge içeriğiveya ekbelge içeriği - Geçersiz ek nesne yapısı
- 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ı
- PDF işlem hatası
- Ek yerleş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 değil PDF verileri doğrudan.
Yanıt Yapısı:
{
"docName": "string", // Output PDF filename
"docContent": "string" // Base64-encoded PDF content
}
İçerik Türü Başlığı:
- Başarı:
application/json - O PDF gömülüdür 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 ile PDF:
JavaScript/Node.js:
const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js
Python:
import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
f.write(pdf_bytes)
C#:
byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);
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
Tek Bağlantı:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"attachments": [
{
"docName": "output.txt",
"docContent": "RXhhbXBsZSBvZiBhdHRhY2htZW50IGZpbGUuIA=="
}
]
}
Çoklu Ekler:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"attachments": [
{
"docName": "file1.txt",
"docContent": "RXhhbXBsZSBvZiBhdHRhY2htZW50IGZpbGUuIA=="
},
{
"docName": "file2.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MK..."
}
],
"async": true
}
Kod Örnekleri
O PDF4me Ek dosyaya ekle PDF 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
PDF Ek Özellikleri
Ek İşleme
- Birden Çok Dosya TürüÇeşitli ek formatlarını destekler; bunlar arasında metin dosyaları (.txt, .csv, .log), dokümanlar (.pdf, .doc, .docx, .xls, .xlsx), resimler (.jpg, .jpeg, .png, .gif), arşivler (.zip, .rar) ve diğer dosya türleri bulunur.
- Toplu İşlemeTek bir dosyaya birden fazla ek dosya ekleyin. PDF Bir dizi ek nesne sağlayarak belgeyi tek bir işlemde işleyin.
- Base64 KodlamaDosya içeriğinin güvenli bir şekilde iletilmesi için kullanılan yöntem: Base64 kodlama
- Dosya AdlandırmaHer ekte bir bilgi bulunmalıdır.
docNameuygun dosya uzantısıyla
Belge Geliştirme
- PDF KorumaOrijinal halini korur PDF Ekler eklerken yapı ve içerik
- Dosya Organizasyonu: Gömülü eklerin özel adlandırılması ve düzenlenmesi yoluyla
docNamealan - Belge Taşınabilirliği: İlgili tüm dosyaları içine yerleştirerek, kendi kendine yeten belge paketleri oluşturun. PDF
- Profesyonel AmbalajlamaDağıtım için kapsamlı belge paketleri oluşturun.
Yanıt İşleme
- Senkron İşlemeVarsayılan olarak, API İstekleri eş zamanlı olarak işler ve geri döndürür. PDF Ekli (200 durumu)
- Asenkron İşleme: Ayarlamak
async: trueAsenkron işlemeyi etkinleştirmek için. API Yoklama işlemiyle 202 durum kodu döndürür. URL içinde Location başlık - İkili Yanıt: The API geri döner PDF Başarılı olduğunda dosyayı ikili içerik (application/pdf) olarak kaydedin.
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Education & Research
- Business & Enterprise
- Technology & Development
Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri
- Yasal BelgelerKanıt dosyaları, sözleşmeler ve destekleyici belgeleri ekleyin.
- Mahkeme DosyalarıMahkeme dosyalarına ve hukuki özetlere destekleyici belgeler ekleyin.
- Müşteri DokümantasyonuMüşteri belgelerini destekleyici materyallerle birlikte paketleyin.
- Uyumluluk BelgeleriSertifikaları, lisansları ve düzenleyici belgeleri ekleyin.
Eğitim ve Araştırma Kullanım Örnekleri
- Akademik MakalelerVeri kümelerini, araştırma materyallerini ve ek bilgileri dahil edin.
- Araştırma DokümantasyonuAraştırma verilerini ve ek materyalleri ekleyin.
- Tez SunumlarıTezleri destekleyici belgeler ve veri kümeleriyle birlikte paketleyin.
- Eğitim MateryalleriKaynakları, alıştırmaları ve referans kılavuzlarını ekleyin.
İşletme ve Kurumsal Kullanım Senaryoları
- İş RaporlarıElektronik tabloları, grafikleri ve detaylı analiz dosyalarını ekleyin.
- Proje Teslim EdilecekleriProje dosyalarının tamamını tek bir PDF belgesine paketleyin.
- Belge Paketleri: Destekleyici materyaller içeren kapsamlı belge paketleri oluşturun.
- Kurumsal BelgelerKurumsal belgelere destekleyici materyaller ekleyin.
Teknoloji ve Geliştirme Kullanım Örnekleri
- Teknik Dokümantasyon: Gömülü kod örnekleri, yapılandırma dosyaları ve referans materyalleri
- Yazılım DokümantasyonuKod dosyalarını ve teknik özellikleri ekleyin.
- API DokümantasyonuKod örneklerini ve yapılandırma dosyalarını ekleyin.
- Geliştirici KaynaklarıPaket geliştirici kaynakları ve referans materyalleri