Kenar boşluğu ekle PDF - Yerleşim Biçimlendirici API
PDF4me Kenar boşluğu ekle PDF Bu özellik, bir çizginin herhangi bir kenarına özel kenar boşlukları eklemenizi sağlar. PDF belge. Bu API hizmet süreçleri PDF Dosyaları düzenler ve milimetre cinsinden kenar boşlukları ekler, sayfa boyutunu kenar boşluklarına uyacak şekilde ayarlar. API alır PDF içerik aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Bu çözüm, belge biçimlendirme, baskı hazırlığı ve profesyonel belgeler için tutarlı sayfa düzenleri sağlamak 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
- Bireysel Marj KontrolüÜst, alt, sol ve sağ kenarlar için farklı kenar boşlukları belirleyin (bağımsız olarak).
- Milimetre HassasiyetiTüm kenar boşlukları milimetre cinsinden belirtilmiştir (0-100 aralığı).
- Sayfa Boyutu AyarlamasıSayfa boyutu, eklenen kenar boşluklarını karşılayacak şekilde otomatik olarak ayarlanır.
- Belge KorumaOrijinal içeriği korurken düzeni ayarlar.
- Asenkron İşlemeUzun süren işlemler için yoklama yöntemiyle eşzamansız işlemeyi destekleme
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm marj ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
/api/v2/AddMargin
REST API Parametreler
Kenar boşluğu ekleme işlevinin parametrelerinin 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 | PDF dosya içeriği kodlanmış Base64 | JVBERi... |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| sol kenar boşluğu | Integer | Sol kenar boşluğu milimetre cinsinden (0-100). Belirtilmezse, sol kenar boşluğu eklenmez. | 20 |
| kenar boşluğu | Integer | Sağ kenar boşluğu milimetre cinsinden (0-100). Belirtilmediği takdirde sağ kenar boşluğu eklenmez. | 20 |
| marginTop | Integer | Üst kenar boşluğu milimetre cinsinden (0-100). Belirtilmediği takdirde üst kenar boşluğu eklenmez. | 25 |
| kenar boşluğu | Integer | Alt kenar boşluğu milimetre cinsinden (0-100). Belirtilmezse, alt kenar boşluğu eklenmez. | 25 |
| 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 Kenar boşluğu 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
Content-Type: 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 Kenar boşlukları eklenmiş dosya, şu şekilde kodlanmıştır: 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 Accepted
Yanıt Başlıkları:
Location: https://api.pdf4me.com/api/v2/AddMargin/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 içeriği,belge adı) - Geçersiz Base64 kodlamada
belge içeriği - Geçersiz kenar boşluğu değerleri (0-100 arasında tamsayı olmalıdır)
- 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ı
- Marj ekleme 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
}
Content-Type Başlık:
- 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
Temel Örnek (Sadece Gerekli Alanlar):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}
Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"marginLeft": 20,
"marginRight": 20,
"marginTop": 25,
"marginBottom": 25,
"async": true
}
Kod Örnekleri
O PDF4me Kenar boşluğu 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 Kenar Özellikleri
Marj Kontrolü
- Bireysel KontrolBelgenin her kenarı için farklı kenar boşlukları ayarlayın (üst, alt, sol, sağ).
- Milimetre HassasiyetiTüm kenar boşlukları 0-100 aralığında milimetre cinsinden belirtilmiştir.
- Sayfa Boyutu AyarlamasıSayfa boyutu, eklenen kenar boşluklarını karşılayacak şekilde otomatik olarak ayarlanır.
- Yerleşim Planının KorunmasıBelge yapısını korurken kenar boşluklarını ayarlayın.
Belge Geliştirme
- Yazdırma Optimizasyonu: Belgelerin çeşitli kağıt boyutlarında doğru şekilde yazdırıldığından emin olun.
- Profesyonel BiçimlendirmeEkipler arasında tutarlı belge düzenleri oluşturun.
- İçerik KorumaOrijinal PDF Kenar boşlukları eklenirken içerik korunur.
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Education & Research
- Business & Enterprise
- Publishing & Printing
Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri
- Hukuki Belgeler: Yasal belge biçimlendirme standartlarına uyumu sağlayın.
- Sözleşme BiçimlendirmeSözleşmeleri ve anlaşmaları uygun kenar boşluklarıyla biçimlendirin.
- Mahkeme Belgeleri: Standart kenar boşluğu gereksinimlerine uygun mahkeme belgeleri hazırlayın.
- Uyumluluk BelgeleriUyumluluk belgelerini düzenleyici standartlara uygun şekilde biçimlendirin.
Eğitim ve Araştırma Kullanım Örnekleri
- Akademik MakalelerAraştırma makalelerini ve tezleri yayın gereksinimlerini karşılayacak şekilde biçimlendirin.
- Araştırma BelgeleriAraştırma makalelerini yayınlanmaya uygun kenar boşluklarıyla biçimlendirin.
- Tez BiçimlendirmeAkademik standartlara uygun şekilde tez ve doktora tezlerini biçimlendirmek.
- Eğitim MateryalleriEğitim belgelerini tutarlı kenar boşluklarıyla biçimlendirin.
İşletme ve Kurumsal Kullanım Senaryoları
- Belge BiçimlendirmeKurumsal belgelerde kenar boşluklarını standartlaştırın.
- İş RaporlarıTutarlı bir düzenle profesyonel raporlar oluşturun.
- Sunum MateryalleriSunum belgelerinin görsel çekiciliğini artırın.
- Kurumsal BelgelerKurumsal belgeleri standart kenar boşluklarıyla biçimlendirin.
Yayıncılık ve Baskı Kullanım Örnekleri
- Baskı HazırlığıPDF dosyalarını belirli baskı gereksinimlerine göre optimize edin.
- Kitap BiçimlendirmeKitap ve yayınları uygun kenar boşluklarıyla biçimlendirin.
- Dergi Düzeni: Standart kenar boşluklarıyla dergi sayfa düzenleri hazırlayın
- Baskı ÜretimiBelgeleri baskı üretim gereksinimlerine göre optimize edin.