Barkod Ekle PDF - QR Code Entegrasyon API
PDF4me Barkod Ekle PDF Profesyonel barkodlar eklemenizi sağlar ve QR codes ile PDF Hassas konumlandırma, boyutlandırma ve biçimlendirme kontrollerine sahip belgeler. API hizmet süreçleri PDF Dosyaları kullanarak barkod ekler ve ekler. Base64 Güvenli iletim için kodlama. 150'den fazla barkod türünü destekler, bunlar arasında şunlar bulunur: QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Özel formatlar da dahil olmak üzere, bu çözüm envanter yönetim sistemleri, kargo etiketi otomasyonu, belge izleme iş akışları ve kurumsal barkod entegrasyonu 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ı Barkod Desteği150'den fazla barkod türü dahil QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, posta kodları ve özel sektör formatları
- Hassas Konumlandırma KontrolüBarkodları istediğiniz yere yerleştirin. PDF Hem milimetre hem de nokta ölçüm sistemlerini kullanarak piksel hassasiyetinde sayfalar oluşturun.
- Gelişmiş Boyutlandırma SeçenekleriOtomatik boyutlandırma özelliği ve özel genişlik/yükseklik kontrolleriyle esnek barkod boyutları, optimum tarama performansı sağlar.
- Profesyonel Metin YönetimiBarkod metninin görüntülenmesini, konumunu (üstte/altta) ve görünürlüğünü özelleştirilebilir biçimlendirme seçenekleriyle yapılandırın.
- Opaklık ve ŞeffaflıkBarkod şeffaflık seviyelerini filigran efektleri, belge üst üste bindirmeleri ve profesyonel sunum için ayarlayın.
- Kurumsal Toplu İşlemeOtomatik işleme iş akışlarıyla birden fazla sayfaya, belgeye veya tüm belge koleksiyonlarına barkod ekleyin.
REST API Uç nokta
O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm barkod işlemleri tek bir uç nokta üzerinden gerçekleştirilir:
- Yöntem: POST
- Uç nokta:
/api/v2/addbarcode
Desteklenen Barkod Türleri
150'den fazla barkod türünü destekler, kapsamlı kullanım sağlar. PDF entegrasyon.
Popüler 1D Barkodlar
- Code128 - Evrensel barkod (en fazla 255 karakter)
- Code39 - Alfanümerik barkod (en fazla 43 karakter)
- EAN13/EAN8 - Perakende ürün kodları (13/8 karakter)
- UPC-A/UPC-E - Kuzey Amerika perakende satışları (12/8 karakter)
Popüler 2B Barkodlar
- QR Code - Mobil tarama (en fazla 4.296 karakter)
- DataMatrix - Yüksek yoğunluklu 2 boyutlu (en fazla 2.335 karakter)
- PDF417 - Yüksek veri kapasitesi (maksimum 2.710 karakter)
- Aztec - Mükemmel hata düzeltme (maksimum 3.832 karakter)
Özel Formatlar
- Posta Kodları: USPS, Royal Mail, Australia Post, Deutsche Post
- Sağlık hizmeti: HIBC, GS1 DataBar, Pharmacode
- Lojistik: MaxiCode, SSCC-18, ITF-14, GS1-128
- QR Varyantları: Micro QR, iQR, rMQR
REST API Parametreler
Barkod 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 |
|---|---|---|---|
| docName* | String | Çıktı PDF .pdf uzantılı dosya adı | output.pdf |
| docContent* | Base64 | Girişin içeriği PDF dosya şu şekilde kodlanmıştır: Base64 | JVBERi... |
| metin* | String | Barkodun içine kodlanacak metin. Metin uzunluğu barkod türüne bağlıdır. | PDF4me Barcode Sample |
| barcodeType* | String | Barkod format türü. Seçenekler: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE | qrCode |
| sayfalar* | String | Hedef sayfalar (ör. "1-3", "tümü", "1", "1,3,5", "2-5", "1,3,7-10", "2-") | 1-3 |
| alignX* | String | Yatay hizalama: Sol, Merkez, veya Sağ | Right |
| alignY* | String | Dikey hizalama: Tepe, Orta, veya Alt | Bottom |
| hideText* | Boolean | Barkod metin etiketini gizle (true=gizle, false=barkodun yanında metni göster) | true |
İsteğe bağlı parametreler
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| heightInMM | String | Barkod yüksekliği milimetre cinsinden (0 = otomatik) | 40 |
| widthInMM | String | Barkod genişliği milimetre cinsinden (0 = otomatik) | 40 |
| marginXInMM | String | Yatay kenar boşluğu milimetre cinsinden | 20 |
| marginYInMM | String | Dikey kenar boşluğu milimetre cinsinden | 20 |
| heightInPt | String | Barkod yüksekliği (nokta cinsinden) | 113 |
| widthInPt | String | Barkod genişliği (nokta cinsinden) | 113 |
| marginXInPt | String | Yatay kenar boşluğu (puan cinsinden) | 57 |
| marginYInPt | String | Dikey kenar boşluğu (puan cinsinden) | 57 |
| opacity | Integer | Şeffaflık seviyesi (0-100): 0=görünmez, 100=tamamen opak | 100 |
| displayText | String | Metin konumu: üstünde veya altında | below |
| showOnlyInPrint | Boolean | Yalnızca yazdırmada göster (doğru) veya görüntüleme ve yazdırmada göster (yanlış) | false |
| isTextAbove | Boolean | Barkodun üstündeki metin (doğru) veya altındaki metin (yanlış) | false |
| async | 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 Barkod 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ı:
- docName (dize): Çıktı PDF dosya adı
- docContent (dize): The PDF Barkod 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/addbarcode/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.
- Geçersiz Base64 kodlamada
docContent - Geçersiz barkod türü
- Geçersiz hizalama değerleri
- Geçersiz veya eksik API anahtar
- API anahtar düzgün değil Base64 kodlanmış Authorization başlık
- Eksik
Authorization: Temelbaşlık
- Sunucu tarafı işlem hatası
- PDF işlem hatası
- Barkod oluşturma 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==",
"text": "PDF4me Barcode Sample",
"barcodeType": "qrCode",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"hideText": true
}
Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"text": "PDF4me Barcode Sample",
"barcodeType": "qrCode",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"hideText": true,
"heightInMM": "40",
"widthInMM": "40",
"marginXInMM": "20",
"marginYInMM": "20",
"heightInPt": "113",
"widthInPt": "113",
"marginXInPt": "57",
"marginYInPt": "57",
"opacity": 100,
"displayText": "below",
"showOnlyInPrint": false,
"isTextAbove": false,
"async": true
}
Kod Örnekleri
O PDF4me Barkod 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
- Google Script
- n8n
- AWS Lambda
Google Script Örnek
Google Apps Script uygulama için Google Workspace entegrasyon:
Sektör Kullanım Örnekleri ve Uygulamaları
- E-commerce & Retail
- Logistics & Shipping
- Healthcare & Medical
- Government & Compliance
- Education & Libraries
- Business & Finance
E-ticaret ve Perakende Kullanım Örnekleri
- Ürün KataloglarıStok yönetimi ve ürün tanımlaması için barkod oluşturma
- Fiyat EtiketleriOtomatik ödeme için barkod entegrasyonu ile dinamik fiyatlandırma oluşturun
- Sipariş TakibiGönderi belgelerine takip kodları ekleyerek paket takibini gerçek zamanlı olarak gerçekleştirin.
- Envanter SistemleriDepo yönetimi ve stok kontrolü için toplu barkod oluşturma
Lojistik ve Nakliye Kullanım Örnekleri
- Kargo EtiketleriPaket takibini kolaylaştırmak için teslimat belgelerine takip barkodları ekleyin.
- Paket TakibiTedarik zinciri genelinde her sevkiyat için benzersiz tanımlayıcılar oluşturun.
- Depo YönetimiDepo konumları ve ürün tanımlaması için barkodlar oluşturun.
- Tedarik ZinciriÜrünleri, yerleşik kodlar kullanarak tüm dağıtım ağı boyunca takip edin.
Sağlık ve Tıbbi Kullanım Alanları
- Hasta KayıtlarıHastaların hızlı bir şekilde tanımlanması ve tıbbi geçmişlerine erişim için barkod ekleyin.
- İlaç Uygulamasıİlaç takibi ve dozaj doğrulaması için barkod oluşturma
- Tıbbi EkipmanBakım barkodlarıyla ekipmanları etiketleyerek varlık yönetimini kolaylaştırın.
- Laboratuvar SonuçlarıHasta verilerinin güvenli bir şekilde birbirine bağlanması için test sonuç belgelerine barkod ekleyin.
Hükümet ve Uyumluluk Kullanım Örnekleri
- Kimlik BelgeleriSürücü ehliyetlerine ve pasaportlara doğrulama için güvenlik barkodları ekleyin.
- Vergi BelgeleriVergi formları ve uyumluluk takibi için izleme kodları oluşturun.
- Uyumluluk FormlarıDüzenleyici takip ve denetim kayıtları için barkod ekleyin.
- Kamu KayıtlarıDevlet veritabanları için aranabilir belge tanımlayıcıları oluşturun.
Eğitim ve Kütüphaneler Kullanım Örnekleri
- Öğrenci KimlikleriÖğrenci kimlik tespiti ve kampüs giriş kontrolü için barkod oluşturma
- Kütüphane SistemleriOtomatik ödeme sistemleri için kitaplara ve kaynaklara barkod ekleyin.
- Sınav KağıtlarıSınav belgeleri ve akademik dürüstlük için benzersiz tanımlayıcılar oluşturun.
- Kampüs HizmetleriEğitim kurumlarındaki ekipman ve kaynak kullanımını takip edin.
İş ve Finans Kullanım Örnekleri
- Fatura İşlemeOtomatik faturalama ve ödeme işlemleri için barkod ekleyin.
- Belge Yönetimiİş belgeleri ve kayıtları için benzersiz tanımlayıcılar oluşturun.
- Varlık TakibiKuruluşlar genelinde ekipman ve varlıklar için barkod oluşturun.
- Denetim İzleriUyumluluk belgeleri ve mali kayıtlar için takip kodları ekleyin.