Sayfa Numarası Ekle PDF - Sayfalama API
PDF4me Sayfa Numarası Ekle PDF Bu özellik, özelleştirilebilir sayfa numaraları eklemenizi sağlar. PDF Konum, biçim ve stil üzerinde kontrol sağlayan belgeler. API hizmet süreçleri PDF Dosyalara sayfa numaraları eklerken, biçimlendirme yer tutucularını kullanır. # Geçerli sayfa numarasını temsil eder ve {1} Sayfa sayısının toplamını temsil eder. API alır PDF içerik aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Bu çözüm, belge düzenleme, yasal dokümantasyon, akademik makaleler ve kurumsal uygulamalar için idealdir. PDF iş akışları.
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 Biçimlendirme: Birden fazla sayfa numarası biçimi arasından seçim yapın.
#mevcut sayfa için ve{1}toplam sayfa sayısı için (örneğin, "# of 1", "Sayfa #") - Hassas KonumlandırmaYatay ve dikey hizalamayı piksel hassasiyetinde kontrol edin.
- Özel StilYazı tipi boyutunu, kalınlığını, italikliğini ve diğer metin biçimlendirme seçeneklerini ayarlayın.
- Marj KontrolüEn uygun yerleştirme için milimetre cinsinden hassas kenar boşlukları ayarlayın.
- İlk Sayfayı Atlaİlk sayfadan sayfa numaralarını hariç tutma seçeneği
- Profesyonel SonuçlarBelgeler genelinde tutarlı ve profesyonel sayfa numaralandırması oluşturun.
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm sayfa numarası ekleme işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POSTALAMAK
- Uç nokta:
/api/v2/AddPageNumber
REST API Parametreler
Sayfa Numarası Ekle seçeneğinin 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ı* | Sicim | Çıktı PDF .pdf uzantılı dosya adı | output.pdf |
| belge içeriği* | Base64 | PDF dosya içeriği kodlanmış Base64 | JVBERi... |
| sayfaNumarasıFormatı* | Sicim | Sayfa numarası biçimi. Kullanın. # Mevcut sayfa numarası için, {1} Toplam sayfa sayısı için. Örnekler: "# of 1", "Sayfa #", "# / 1" | # of {1} |
| hizalaX* | Sicim | Yatay hizalama: sol, merkez, veya Sağ | right |
| hizalaY* | Sicim | Dikey hizalama: tepe, orta, veya alt | bottom |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| marginXinMM | Tamsayı | Kenardan yatay mesafe milimetre cinsinden (0-100) | 2 |
| marjıMM | Tamsayı | Kenardan dikey mesafe milimetre cinsinden (0-100) | 2 |
| yazı tipi boyutu | Tamsayı | Sayfa numaraları için yazı tipi boyutu (8-72) | 12 |
| buztopu | Mantıksal | Sayfa numaralarını kalın (doğru) veya normal (yanlış) yapın. | true |
| isİtalyanca | Mantıksal | Sayfa numaralarını italik (doğru) veya normal (yanlış) yap | false |
| İlk sayfayı atla | Mantıksal | İlk sayfada numaralandırmayı atla (doğru) veya dahil et (yanlış) | false |
| asenkron | Mantıksal | 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 |
Sayfa Numarası Biçimi Yer Tutucuları
O pageNumberFormat Bu parametre aşağıdaki yer tutucuları kullanır:
#- Geçerli sayfa numarasıyla (1, 2, 3, vb.) değiştirildi.{1}- Toplam sayfa sayısı ile değiştirildi.
Biçimlendirme Örnekleri:
"# of {1}"→ "1/10", "2/10", "3/10" vb. görüntüler."Page #"→ "Sayfa 1", "Sayfa 2", "Sayfa 3" vb. görüntüler."# / {1}"→ "1 / 10", "2 / 10", "3 / 10" vb. görüntüler."- # -"→ "- 1 -", "- 2 -", "- 3 -" vb. görüntüler."[#/{1}]"→ "[1/10]", "[2/10]", "[3/10]" vb. görüntüler."(#)"→ "(1)", "(2)", "(3)" vb. görüntüler."#"→ Yalnızca sayfa numarasını gösterir: "1", "2", "3", vb.
Çıktı
O PDF4me Sayfa Numarası 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 Sayfa numaraları 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/AddPageNumber/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ı,sayfaNumarasıFormatı,hizalaX,hizalaY) - Geçersiz Base64 kodlamada
belge içeriği - Geçersiz hizalama değerleri (alignX için "sol", "orta", "sağ"; alignY için "üst", "orta", "alt" olmalıdır)
- Geçersiz yazı tipi boyutu (8-72 arasında olmalıdır)
- 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ı
- Sayfa numarası 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==",
"pageNumberFormat": "# of {1}",
"alignX": "right",
"alignY": "bottom"
}
Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"pageNumberFormat": "# of {1}",
"alignX": "right",
"alignY": "bottom",
"marginXinMM": 2,
"marginYinMM": 2,
"fontSize": 12,
"isBold": true,
"isItalic": false,
"skipFirstPage": false,
"async": true
}
Kod Örnekleri
O PDF4me Sayfa Numarası 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
Sayfa Numarası Özellikleri
Biçimlendirme Seçenekleri
- Çoklu BiçimlerÇeşitli numaralandırma stilleri ve desenleri için destek
- Esnek KonumlandırmaSayfa numaralarının yerleştirilmesinde hassas kontrol
- Özel StilYazı tipi görünümü ve biçimlendirmesi üzerinde tam kontrol.
- İlk Sayfa KontrolüKapak sayfalarını numaralandırmadan hariç tutma seçeneği
Belge Geliştirme
- Profesyonel DüzenlemeBelgeler genelinde tutarlı ve profesyonel sayfa numaralandırması oluşturun.
- Yazdırma OptimizasyonuFarklı baskı gereksinimleri için sayfa sayısını optimize edin.
- Dijital DağıtımFarklı görüntüleme cihazlarında biçimlendirmeyi koruyun.
- Marka Tutarlılığı: Kuruluşlar genelinde tek tip sayfa numaralandırma standartları uygulayın.
Gelişmiş Özellikler
- Toplu İşleme: Tutarlı sayfa numaralandırmasıyla birden fazla belgeyi işleyin
- Kalite GüvencesiSayfa numaralarının bütünlüğünü ve doğruluğunu sağlayın. PDF uyumluluk
- Yerleşim Planının KorunmasıSayfa numaraları eklerken belge yapısını koruyun.
- Özel Kenar BoşluklarıSayfa numarası konumlandırması üzerinde hassas kontrol
Sektör Kullanım Örnekleri ve Uygulamaları
- Legal & Professional Services
- Education & Research
- Business & Enterprise
- Government & Compliance
Hukuk ve Profesyonel Hizmetler Kullanım Örnekleri
- Yasal BelgelerSözleşmelerde, anlaşmalarda ve hukuki belgelerde sayfa numaralandırma.
- Mahkeme BelgeleriMahkeme dosyalarına ve yasal belgelere sayfa numaraları ekleyin.
- Uyumluluk BelgeleriUyumluluk ve düzenleyici belgelerdeki sayfa numaralarını belirtin.
- Müşteri DokümantasyonuMüşteri belgelerini sayfa numaralandırması kullanarak düzenleyin.
Eğitim ve Araştırma Kullanım Örnekleri
- Akademik MakalelerAraştırma makalelerini ve tezleri uygun sayfa numaralandırmasıyla biçimlendirin.
- Araştırma BelgeleriAraştırma makalelerine ve yayınlara sayfa numaraları ekleyin.
- Tez BiçimlendirmeTez ve doktora tezlerinde sayfa numaralandırmak
- Eğitim MateryalleriEğitim materyallerini sayfa numaralarıyla düzenleyin.
İşletme ve Kurumsal Kullanım Senaryoları
- İş RaporlarıTutarlı sayfa numaralandırmasıyla profesyonel raporlar oluşturun.
- Belge OrganizasyonuRaporlara, kılavuzlara ve teknik belgelere sayfa numaraları ekleyin.
- Teknik KılavuzlarTeknik dokümantasyonu net sayfa referanslarıyla düzenleyin.
- Kurumsal BelgelerKurumsal belgelerde ve kılavuzlarda sayfa numaralandırmak
Hükümet ve Uyumluluk Kullanım Örnekleri
- Arşiv BelgeleriUzun süreli saklama için belgeleri sayfa numaralarıyla hazırlayın.
- Hükümet Raporları: Devlet raporlarına ve belgelerine sayfa numaraları ekleyin.
- Düzenleyici Dokümantasyon: Yönetmelik ve uyumluluk belgelerindeki sayfa numaralandırması
- Kamu Kayıtları: Kamu kayıtlarını sayfa numaralandırmasıyla düzenleyin.