Barcode Generator & Reader

Buat barcode 1D dan 2D (Code 128, EAN, UPC, Data Matrix, PDF417, Aztec) dan baca isi barcode dari gambar.

Hasilkan barcode PNG atau SVG untuk label produk, tiket, dan dokumen: code128, code39, ean13, ean8, upca, upce, itf14, codabar, qrcode, datamatrix, pdf417, dan azteccode. Digit cek EAN/UPC/ITF dihitung otomatis atau divalidasi; teks non-Latin pada simbologi 2D disandikan UTF-8 dengan penanda ECI. Endpoint decode membaca semua format umum - QR, Data Matrix, Aztec, PDF417, MaxiCode, EAN/UPC, Code 128/39/93, ITF, Codabar, DataBar - dari satu gambar, lengkap dengan byte mentah (base64 dan hex), encoding yang dipakai, posisi, dan uraian GS1.

Semua respons memakai amplop { "is_success", "message", "data" } kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

Endpoint (2)

Baca semua barcode 1D/2D dari gambar, lengkap dengan byte mentah

POST https://api.apipedia.id/v1/barcode/decode

Membaca barcode dari gambar dengan zxing-cpp (WebAssembly di server, tanpa panggilan jaringan). Format yang dikenali: QR Code, Micro QR, rMQR, Data Matrix, Aztec, PDF417, MaxiCode, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, ITF, Codabar, DataBar, dan DataBar Expanded. formats (opsional) membatasi pencarian, mis. ["EAN13", "Code128"]; huruf besar-kecil dan pemisah diabaikan, nama simbologi /barcode/generate (azteccode, codabar) serta grup AllLinear dan AllMatrix juga diterima. Kosong = semua format.

Body: image_base64 wajib (base64 mentah atau data URL; PNG, JPEG, WebP, GIF, atau BMP; maksimal 8 MB dan 40 megapiksel). try_harder (default true) mencoba rotasi dan skala lain. max_symbols 1-50 (default 10). charset opsional memaksa label encoding WHATWG (utf-8, shift_jis, euc-kr, gbk, gb18030, big5, iso-8859-1, windows-1252, utf-16le, dst.) saat mendekode byte.

Encoding universal: setiap simbol selalu membawa bytes_hex dan bytes_base64 - byte mentah persis seperti tersimpan di simbol - jadi isi berencoding apa pun, termasuk biner, bisa dipulihkan tanpa kehilangan data. text adalah hasil dekode byte tersebut, dan encoding_source menyebut asal charset-nya: eci (penanda ECI di simbol, dihormati otomatis; eci berisi daftar nomornya), request (field charset menang atas ECI maupun tebakan), atau guessed (tebakan pembaca). text_is_binary: true berarti isinya bukan teks - pakai byte mentah. Untuk GS1, text_hri berisi bentuk "(01)...(17)..." dan parsed.elements berisi Application Identifier-nya.

parsed.type mengklasifikasi isi: url (lengkap dengan hasil /url/parse), wifi, vcard, mecard, email, tel, sms, geo, qris (diurai seperti /qris/parse), gs1, binary, atau text.

Gambar tanpa barcode BUKAN error: dijawab 200 dengan count: 0, symbols: [], dan hint berisi saran perbaikan gambar. Error 400 hanya untuk masukan rusak: base64 tidak valid, bukan gambar yang didukung, lebih dari 8 MB/40 megapiksel, gambar rusak, format tidak dikenal, max_symbols di luar rentang, atau charset tidak dikenal. Respons di-cache 24 jam (header X-Cache).

Body (application/json, wajib):

{
  "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVoAAAEsAQAAAACqUUYHAAACN0lEQVR42u3asW7UQBCA4X99FriAxB1IJIp5A+gCinT7CDwARURDkyKchESBklV0RWhISkRDCmoegGqDIuEmgjfAAj+Ac7rCB2sPxd0R8KWADsRMtVp9Gs3Maro1wm/HccQfhGLFihX/L7gZsJrmZjcpz+6sukkpyepgEh/YxuXlCDOYZHt5pqNTrFixYsWKFStWrFixYsWKFStWrFixYsWKFStWrFixYsWKFStWrFix4n8PIyLhkXRiZbdz8X5NRPw884gmY0hDkzbGQRPRcByTc+Y46pRx4MaV7DB24xo8BAjQyl0+etnu4KGvnrTLVFQbvQDQUtP/3C7zrmi7Dd4oevfZcgXX3oANAAZSttzV7dDFGWUa9jghgeBmbVDhOLS1644uowV/HWBCDVBCCY661838iQQDm7OUADnkPCXjShc/sDXz380lFaQEIHpGsfiC1hGBBUa8BRjz2HFoIkgueO6VKt4BeE3fxUeXC/CSAdt+AZ+4JmMIsM+GB5ZkrcDKEmduAb/0aRzhQFIiEkjIaGkfYtMulpvFEsYDXzcxAAIOwtCtnzcYzw/O7HMbwAHjb4CtcJOIS9kvmXvPwVakRMAEwIVpegweC6wXP9fswVHNL2xMjU8DAu0Fm3IoGeWsAfovGE0Lam1YmIb5QGvJgSZuBhbIzCkQb0zrOl8rERH6tciahN3CBERe1cvi+rUE5IvIwdT8WCtvDWRELiXqAdzCekPPEMO9GTL6N16xYsWK/0r8Hf6n+l5U9bSfAAAAAElFTkSuQmCC",
  "formats": [
    "QRCode",
    "EAN13"
  ],
  "try_harder": true,
  "max_symbols": 10
}

Contoh request:

curl -X POST "https://api.apipedia.id/v1/barcode/decode" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVoAAAEsAQAAAACqUUYHAAACN0lEQVR42u3asW7UQBCA4X99FriAxB1IJIp5A+gCinT7CDwARURDkyKchESBklV0RWhISkRDCmoegGqDIuEmgjfAAj+Ac7rCB2sPxd0R8KWADsRMtVp9Gs3Maro1wm/HccQfhGLFihX/L7gZsJrmZjcpz+6sukkpyepgEh/YxuXlCDOYZHt5pqNTrFixYsWKFStWrFixYsWKFStWrFixYsWKFStWrFixYsWKFStWrFix4n8PIyLhkXRiZbdz8X5NRPw884gmY0hDkzbGQRPRcByTc+Y46pRx4MaV7DB24xo8BAjQyl0+etnu4KGvnrTLVFQbvQDQUtP/3C7zrmi7Dd4oevfZcgXX3oANAAZSttzV7dDFGWUa9jghgeBmbVDhOLS1644uowV/HWBCDVBCCY661838iQQDm7OUADnkPCXjShc/sDXz380lFaQEIHpGsfiC1hGBBUa8BRjz2HFoIkgueO6VKt4BeE3fxUeXC/CSAdt+AZ+4JmMIsM+GB5ZkrcDKEmduAb/0aRzhQFIiEkjIaGkfYtMulpvFEsYDXzcxAAIOwtCtnzcYzw/O7HMbwAHjb4CtcJOIS9kvmXvPwVakRMAEwIVpegweC6wXP9fswVHNL2xMjU8DAu0Fm3IoGeWsAfovGE0Lam1YmIb5QGvJgSZuBhbIzCkQb0zrOl8rERH6tciahN3CBERe1cvi+rUE5IvIwdT8WCtvDWRELiXqAdzCekPPEMO9GTL6N16xYsWK/0r8Hf6n+l5U9bSfAAAAAElFTkSuQmCC","formats":["QRCode","EAN13"],"try_harder":true,"max_symbols":10}'

Contoh respons (200):

{
  "is_success": true,
  "message": "1 barcode berhasil dibaca",
  "data": {
    "count": 1,
    "symbols": [
      {
        "format": "QRCode",
        "format_label": "QR Code",
        "symbology": "QRCode",
        "text": "Halo, 日本語 ✓",
        "content_type": "Text",
        "encoding": "utf-8",
        "encoding_source": "eci",
        "has_eci": true,
        "eci": [
          {
            "eci": 26,
            "charset": "utf-8"
          }
        ],
        "text_is_binary": false,
        "bytes_length": 19,
        "bytes_base64": "SGFsbywg5pel5pys6KqeIOKckw==",
        "bytes_hex": "48616c6f2c20e697a5e69cace8aa9e20e29c93",
        "position": {
          "topLeft": {
            "x": 30,
            "y": 30
          },
          "topRight": {
            "x": 180,
            "y": 30
          },
          "bottomRight": {
            "x": 180,
            "y": 180
          },
          "bottomLeft": {
            "x": 30,
            "y": 180
          }
        },
        "orientation": 0,
        "is_mirrored": false,
        "is_inverted": false,
        "symbology_identifier": "]Q1",
        "parsed": {
          "type": "text"
        }
      }
    ],
    "formats_searched": [
      "QRCode",
      "EAN13"
    ],
    "image": {
      "mime": "image/png",
      "bytes": 1819
    }
  }
}

Buat barcode 1D/2D sebagai gambar PNG atau SVG

POST https://api.apipedia.id/v1/barcode/generate

Dirender di server dengan bwip-js (port BWIPP), latar putih plus quiet zone supaya langsung terbaca pemindai. Gambar dikembalikan langsung sebagai image_data_url dan image_base64, bukan tautan CDN.

symbology (default code128): 1D code128 (ASCII penuh), code39 (angka, A-Z kapital, spasi, - . $ / + %), ean13, ean8, upca, upce, itf14, codabar (otomatis diapit A...A bila tanpa karakter start/stop); 2D qrcode, datamatrix, pdf417, azteccode. data wajib, maksimal 4.096 byte UTF-8.

Digit periksa EAN-13/EAN-8/UPC-A/ITF-14: kirim satu digit lebih pendek (mis. 12 digit untuk EAN-13) supaya dihitung otomatis; kalau dikirim lengkap, digit periksanya diverifikasi dan yang salah dijawab 400 sambil menyebut digit yang benar. Field data di respons selalu berisi data akhir termasuk digit periksa.

Simbologi 1D hanya mengenal ASCII; teks Unicode (huruf beraksen, aksara non-Latin, emoji) dijawab 400 dan harus memakai simbologi 2D. Di simbologi 2D, teks non-ASCII dikodekan UTF-8 dengan penanda ECI 26 (eci: "utf-8" di respons) supaya pemindai tidak salah menebak charset; teks ASCII murni dibiarkan tanpa ECI (eci: null).

Ukuran: format png (default) atau svg; scale 1-20 (default 3, piksel per modul); width/height 32-4000 piksel diperlakukan sebagai BATAS ATAS - skala dipilih sebesar mungkin yang masih muat, dan ukuran aktualnya dilaporkan di respons. include_text (default true) menampilkan teks di bawah batang dan hanya berlaku untuk 1D. error_correction L, M, Q, atau H hanya untuk qrcode.

Error 400: simbologi tidak dikenal, data kosong/lebih dari 4.096 byte/berisi karakter terlarang, digit periksa salah, ukuran di luar rentang, atau data melebihi kapasitas satu simbol. Respons di-cache 24 jam (header X-Cache).

Body (application/json, wajib):

{
  "data": "899123456789",
  "symbology": "ean13",
  "format": "png",
  "scale": 3,
  "include_text": true
}

Contoh request:

curl -X POST "https://api.apipedia.id/v1/barcode/generate" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"data":"899123456789","symbology":"ean13","format":"png","scale":3,"include_text":true}'

Contoh respons (200):

{
  "is_success": true,
  "message": "Barcode berhasil dibuat",
  "data": {
    "symbology": "ean13",
    "format": "png",
    "data": "8991234567891",
    "width": 346,
    "height": 300,
    "scale": 3,
    "include_text": true,
    "eci": null,
    "image_data_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVoAAAEsCAYAAACC...",
    "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAVoAAAEsCAYAAACC..."
  }
}

Versi Markdown halaman ini

Coba Barcode Generator & Reader di Sandbox