Tambahkan Kode Batang ke PDF - QR Code Integrasi API
PDF4me Tambahkan Kode Batang ke PDF memungkinkan Anda untuk menambahkan barcode profesional dan QR codes ke PDF dokumen dengan kontrol posisi, ukuran, dan format yang tepat. Ini API proses layanan PDF file dan menambahkan barcode menggunakan Base64 Pengkodean untuk transmisi yang aman. Dengan dukungan untuk 150+ jenis barcode termasuk QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Dengan berbagai format khusus, solusi ini ideal untuk sistem manajemen inventaris, otomatisasi label pengiriman, alur kerja pelacakan dokumen, dan integrasi barcode perusahaan.
Memverifikasi Identitas Anda API Meminta
Untuk mengakses PDF4me REST APISetiap permintaan harus menyertakan kredensial otentikasi yang tepat. Otentikasi memastikan komunikasi yang aman dan memvalidasi identitas Anda sebagai pengguna yang berwenang. REST API.
Fitur Utama
- Dukungan Kode Batang yang Komprehensif: 150+ jenis barcode termasuk QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, kode pos, dan format industri khusus
- Kontrol Pemosisian yang Tepat: Letakkan barcode di mana saja pada PDF Halaman dengan akurasi piksel sempurna menggunakan sistem pengukuran milimeter dan titik.
- Opsi Ukuran LanjutanDimensi barcode yang fleksibel dengan kemampuan penyesuaian ukuran otomatis dan kontrol lebar/tinggi khusus untuk performa pemindaian yang optimal.
- Manajemen Teks ProfesionalKonfigurasikan tampilan teks barcode, posisi (di atas/di bawah), dan visibilitas dengan opsi pemformatan yang dapat disesuaikan.
- Kekaburan dan TransparansiSesuaikan tingkat transparansi barcode untuk efek watermark, overlay dokumen, dan presentasi profesional.
- Pemrosesan Batch PerusahaanTambahkan barcode ke beberapa halaman, dokumen, atau seluruh koleksi dokumen dengan alur kerja pemrosesan otomatis.
REST API Titik akhir
Yang PDF4me REST API menggunakan standar HTTP Metode untuk berinteraksi dengan sumber daya. Semua operasi barcode dilakukan melalui satu titik akhir:
- Metode: POST
- Titik akhir:
/api/v2/addbarcode
Jenis Kode Batang yang Didukung
Mendukung lebih dari 150 jenis barcode untuk solusi komprehensif. PDF integrasi.
Kode Batang 1D Populer
- Code128 - Kode batang universal (maksimal 255 karakter)
- Code39 - Kode batang alfanumerik (maksimal 43 karakter)
- EAN13/EAN8 - Kode produk ritel (13/8 karakter)
- UPC-A/UPC-E - Ritel Amerika Utara (12/8 karakter)
Kode Batang 2D Populer
- QR Code - Pemindaian seluler (maksimal 4.296 karakter)
- DataMatrix - 2D dengan kepadatan tinggi (maksimal 2.335 karakter)
- PDF417 - Kapasitas data besar (maksimal 2.710 karakter)
- Aztec - Koreksi kesalahan yang sangat baik (maksimal 3.832 karakter)
Format Khusus
- Kode Pos: USPS, Royal Mail, Australia Post, Deutsche Post
- Perawatan kesehatan: HIBC, GS1 DataBar, Pharmacode
- Logistik: MaxiCode, SSCC-18, ITF-14, GS1-128
- Varian QR: Micro QR, iQR, rMQR
REST API Parameter
Daftar lengkap parameter untuk Menambahkan Kode Batang ke PDF REST APIParameter-parameter tersebut diorganisir berdasarkan kategori untuk pemahaman dan implementasi yang lebih baik.
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi dan harus diberikan agar dapat digunakan. API agar berfungsi dengan benar.
Parameter yang Diperlukan
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| docName* | String | Keluaran PDF nama file dengan ekstensi .pdf | output.pdf |
| docContent* | Base64 | Isi dari input PDF berkas yang dikodekan dalam Base64 | JVBERi... |
| teks* | String | Teks yang akan dikodekan dalam barcode. Panjang teks bergantung pada jenis barcode. | PDF4me Barcode Sample |
| barcodeType* | String | Jenis format kode batang. Opsi: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE | qrCode |
| halaman* | String | Halaman target (misalnya, "1-3", "semua", "1", "1,3,5", "2-5", "1,3,7-10", "2-") | 1-3 |
| alignX* | String | Penyelarasan horizontal: Kiri, Tengah, atau Benar | Right |
| alignY* | String | Penyelarasan vertikal: Atas, Tengah, atau Dasar | Bottom |
| hideText* | Boolean | Sembunyikan label teks barcode (true=sembunyikan, false=tampilkan teks di samping barcode) | true |
Parameter Opsional
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| heightInMM | String | Tinggi kode batang dalam milimeter (0 = otomatis) | 40 |
| widthInMM | String | Lebar kode batang dalam milimeter (0 = otomatis) | 40 |
| marginXInMM | String | Margin horizontal dalam milimeter | 20 |
| marginYInMM | String | Margin vertikal dalam milimeter | 20 |
| heightInPt | String | Tinggi kode batang dalam poin | 113 |
| widthInPt | String | Lebar kode batang dalam poin | 113 |
| marginXInPt | String | Margin horizontal dalam poin | 57 |
| marginYInPt | String | Margin vertikal dalam poin | 57 |
| opacity | Integer | Tingkat transparansi (0-100): 0=tidak terlihat, 100=sepenuhnya buram | 100 |
| displayText | String | Posisi teks: di atas atau di bawah | below |
| showOnlyInPrint | Boolean | Hanya ditampilkan dalam bentuk cetak (benar) atau dalam tampilan dan cetak (salah) | false |
| isTextAbove | Boolean | Teks di atas barcode (benar) atau di bawah (salah) | false |
| async | Boolean | Aktifkan pemrosesan asinkron. Saat true, itu API mengembalikan status 202 dan menyediakan polling URL di dalam Location judul | true |
Keluaran
Yang PDF4me Tambahkan Kode Batang ke PDF REST API Mengembalikan respons yang berbeda berdasarkan mode pemrosesan. API mengembalikan PDF sebagai Base64-string yang dikodekan dalam JSON format, bukan sebagai data biner.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Pemrosesan Sinkron (Default)
Kapan async tidak diatur atau diatur ke false, itu API memproses permintaan tersebut dengan segera:
Kode Status: 200 OK
Content-Type: application/json
Isi Tanggapan:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}
Kolom Respons:
- docName (string): Output PDF nama file
- docContent (string): The PDF berkas dengan barcode ditambahkan, dikodekan sebagai Base64 rangkaian
Cara Penggunaan:
- Ekstrak
docContentlapangan dari JSON tanggapan - Uraikan kodenya Base64 string untuk mendapatkan biner PDF data
- Simpan atau proses PDF berkas sesuai kebutuhan
Contoh (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes
Pemrosesan Asinkron
Kapan async: true sudah ditetapkan, API memproses permintaan secara asinkron:
Kode Status: 202 Accepted
Header Respons:
Location: https://api.pdf4me.com/api/v2/addbarcode/poll/12345-abcde-67890
Proses Pemungutan Suara:
- Ekstrak
Locationheader dari respons 202 - Jajak pendapat URL menggunakan GET permintaan
- Lanjutkan jajak pendapat hingga Anda menerima 200 OK status
- Jawaban terakhir berisi hal yang sama. JSON format dengan
docNameDandocContent(Base64)
Contoh Polling:
// 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
}
Respons Kesalahan
Yang API pengembalian standar HTTP Kode kesalahan beserta detail kesalahannya:
- Parameter permintaan tidak valid
- Kolom yang wajib diisi belum terisi
- Tidak sah Base64 pengkodean dalam
docContent - Jenis barcode tidak valid
- Nilai penyelarasan tidak valid
- Tidak valid atau hilang API kunci
- API kunci tidak berfungsi dengan benar Base64 dikodekan dalam Authorization judul
- Hilang
Authorization: Dasarjudul
- Kesalahan pemrosesan sisi server
- PDF kegagalan pemrosesan
- Kegagalan pembuatan kode batang
Format Respons Kesalahan:
{
"error": "Error message describing what went wrong"
}
Detail Format Respons
Penting: Yang API selalu kembali JSON, tidak pernah biner PDF data secara langsung.
Struktur Respons:
{
"docName": "string", // Output PDF filename
"docContent": "string" // Base64-encoded PDF content
}
Content-Type Judul:
- Kesuksesan:
application/json - Yang PDF tertanam sebagai Base64 tali di dalam JSON tanggapan
Mengapa Base64?
- JSON- Pengkodean aman untuk data biner
- Mudah ditransmisikan melalui HTTP
- Kompatibel dengan semua bahasa pemrograman
- Dapat langsung disematkan di JSON tanpa menghindari masalah
Mendekode Base64 ke 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);
Contoh Permintaan
Judul
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Catatan:
- Dapatkan milikmu API kunci dari PDF4me Dasbor
- Yang API kunci harus Base64 dikodekan dan diawali dengan "Basic" di dalam Authorization judul
- Contoh: Jika Anda API kuncinya adalah
abc123, mengkodekannya menjadi Base64 dan menggunakanAuthorization: Basic YWJjMTIz
Muatan
Contoh Sederhana (Hanya Kolom yang Wajib Diisi):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"text": "PDF4me Barcode Sample",
"barcodeType": "qrCode",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"hideText": true
}
Contoh Lanjutan (Dengan Semua Kolom Opsional):
{
"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
}
Contoh Kode
Yang PDF4me Tambahkan Kode Batang ke PDF REST API Menyediakan contoh kode dalam berbagai bahasa pemrograman. Pilih bahasa yang paling sesuai dengan lingkungan pengembangan Anda:
- C#
- Java
- JavaScript
- Python
- Salesforce
- Google Script
- n8n
- AWS Lambda
C# (CSharp) Contoh
Menyelesaikan C# implementasi untuk menambahkan barcode ke PDF dokumen:
Java Contoh
Java Implementasi dengan penanganan kesalahan dan pemrosesan respons yang lengkap:
JavaScript Contoh
Node.js dan kompatibel dengan browser JavaScript implementasi:
Google Script Contoh
Google Apps Script implementasi untuk Google Workspace integrasi:
Studi Kasus & Aplikasi Industri
- E-commerce & Retail
- Logistics & Shipping
- Healthcare & Medical
- Government & Compliance
- Education & Libraries
- Business & Finance
Studi Kasus E-commerce & Ritel
- Katalog Produk: Menghasilkan barcode untuk manajemen inventaris dan identifikasi produk
- Label HargaBuat penetapan harga dinamis dengan integrasi barcode untuk proses pembayaran otomatis.
- Pelacakan PesananTambahkan kode pelacakan ke dokumen pengiriman untuk pemantauan paket secara real-time.
- Sistem InventarisasiPembuatan barcode massal untuk manajemen gudang dan pengendalian stok.
Studi Kasus Logistik & Pengiriman
- Label PengirimanTambahkan barcode pelacakan ke dokumen pengiriman untuk memudahkan pelacakan paket.
- Pelacakan Paket: Menghasilkan pengidentifikasi unik untuk setiap pengiriman di seluruh rantai pasokan
- Manajemen GudangBuat barcode untuk lokasi penyimpanan dan identifikasi produk.
- Rantai PasokanLacak produk di seluruh jaringan distribusi dengan kode tertanam.
Kasus Penggunaan di Bidang Kesehatan & Medis
- Catatan PasienTambahkan barcode untuk identifikasi pasien yang cepat dan akses riwayat medis.
- Pemberian Obat: Menghasilkan barcode untuk pelacakan obat dan verifikasi dosis
- Peralatan MedisBeri label pada peralatan dengan kode batang perawatan untuk manajemen aset.
- Hasil LaboratoriumTambahkan barcode ke dokumen hasil tes untuk pengaitan data pasien yang aman.
Studi Kasus Pemerintahan & Kepatuhan
- Dokumen IdentitasTambahkan barcode keamanan pada surat izin mengemudi dan paspor untuk keperluan verifikasi.
- Dokumen Pajak: Menghasilkan kode pelacakan untuk formulir pajak dan pemantauan kepatuhan
- Formulir KepatuhanTambahkan barcode untuk pelacakan regulasi dan jejak audit.
- Catatan Publik: Membuat pengidentifikasi dokumen yang dapat dicari untuk basis data pemerintah
Studi Kasus di Bidang Pendidikan & Perpustakaan
- Kartu Identitas Pelajar: Menghasilkan kode batang untuk identifikasi siswa dan kontrol akses kampus
- Sistem PerpustakaanTambahkan kode batang ke buku dan sumber daya untuk sistem peminjaman otomatis.
- Soal Ujian: Membuat pengenal unik untuk dokumen ujian dan integritas akademik
- Layanan KampusMelacak penggunaan peralatan dan sumber daya di seluruh fasilitas pendidikan.
Studi Kasus Bisnis & Keuangan
- Pemrosesan FakturTambahkan barcode untuk penanganan faktur dan pemrosesan pembayaran otomatis.
- Manajemen DokumenBuat pengidentifikasi unik untuk dokumen dan catatan bisnis.
- Pelacakan Aset: Menghasilkan kode batang untuk peralatan dan aset di seluruh organisasi
- Jejak AuditTambahkan kode pelacakan untuk dokumentasi kepatuhan dan catatan keuangan.