API 참조

Code 128 및 GS1 바코드를 프로그래밍 방식으로 생성하세요. JSON 응답과 이미지 다운로드를 지원하는 간단한 REST API입니다.

Free: 일일 100건 Business: 월 50,000건

빠른 시작

curl "https://www.barcode-code128.com/api/barcode/render?value=HELLO-WORLD&format=PNG&resolution=300" --output barcode.png

엔드포인트

GET /api/barcode/render 바코드 이미지 다운로드

매개변수	유형	기본값	설명
value	string	—	필수. 인코딩할 바코드 데이터입니다.
symbology	string	Code128Auto	Code128Auto, Code128A, Code128B, Code128C, GS1_128, GS1_DataMatrix, GS1_QR
format	string	PNG	PNG, SVG, PDF, EPS
resolution	int	300	DPI: 150, 300, 600, 1200
xDimension	decimal	0.33	바 모듈 너비(mm)
barHeight	decimal	25.4	바 높이(mm)
showText	bool	true	바코드 아래에 판독 가능 텍스트 표시
foregroundColor	string	#000000	바 색상(hex)
backgroundColor	string	#FFFFFF	배경 색상(hex)
barWidthReduction	decimal	0	인쇄 보정값(mm)

POST /api/barcode/batch 여러 바코드를 ZIP 파일로 생성

값 배열이 포함된 JSON 본문을 전송합니다. 값마다 바코드 하나가 포함된 ZIP 파일이 반환됩니다.

{
  "values": ["SKU-001", "SKU-002", "SKU-003"],
  "symbology": "Code128Auto",
  "format": "PNG",
  "resolution": 300
}

POST /api/gs1/render 구조화된 데이터로 GS1 바코드 생성

GS1 응용 식별자(AI) 필드를 전송합니다. API가 인코딩, FNC1 구분 기호 및 체크 디지트를 처리합니다.

{
  "fields": [
    { "ai": "01", "value": "05412345000013" },
    { "ai": "10", "value": "LOT-A23" },
    { "ai": "17", "value": "260731" }
  ],
  "symbology": "GS1_128",
  "format": "PNG",
  "resolution": 300
}

GET /api/barcode/quota 현재 사용량 확인

{ "usedToday": 3, "dailyLimit": 5, "remaining": 2, "tier": "Free" }

플레이그라운드

API를 실시간으로 사용해 보세요 — 가입할 필요가 없습니다.

값

형식

DPI

cURL

코드 예제

cURL

curl "https://www.barcode-code128.com\
/api/barcode/render\
?value=SKU-4711\
&format=PNG\
&resolution=300" \
  --output barcode.png

Python

import requests

resp = requests.get(
    "https://www.barcode-code128.com"
    "/api/barcode/render",
    params={
        "value": "SKU-4711",
        "format": "PNG",
        "resolution": 300
    }
)

with open("barcode.png", "wb") as f:
    f.write(resp.content)

Node.js

const fs = require('fs');

const url = new URL(
  "https://www.barcode-code128.com"
  + "/api/barcode/render"
);
url.searchParams.set("value", "SKU-4711");
url.searchParams.set("format", "PNG");
url.searchParams.set("resolution", "300");

const resp = await fetch(url);
const buf = await resp.arrayBuffer();
fs.writeFileSync(
  "barcode.png",
  Buffer.from(buf)
);