# Barcode Generator & Reader

Barcode Generator & Reader API APIPedia: Buat barcode 1D dan 2D (Code 128, EAN, UPC, Data Matrix, PDF417, Aztec) dan baca isi barcode dari gambar. Panggil dengan satu token API di `https://api.apipedia.id/v1/barcode`.

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.

- Base URL: `https://api.apipedia.id/v1/barcode`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Dokumen
- Halaman: https://apipedia.id/docs/barcode-generator
- OpenAPI: https://console.apipedia.id/openapi/barcode-generator.yaml

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

## Endpoint (2)

- `POST /decode`: Baca semua barcode 1D/2D dari gambar, lengkap dengan byte mentah
- `POST /generate`: Buat barcode 1D/2D sebagai gambar PNG atau SVG

### 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):

```json
{
  "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:

```bash
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):

```json
{
  "is_success": true,
  "message": "1 barcode(s) read",
  "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):

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

Contoh request:

```bash
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):

```json
{
  "is_success": true,
  "message": "Barcode created",
  "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..."
  }
}
```
