바코드

34가지 심볼로지로 바코드를 만들며 색상, 크기, 라벨을 지정할 수 있습니다.

지원 유형

type을 다음 심볼로지 키 중 하나로 전달하세요. value는 해당 유형의 규칙을 따라야 합니다.

C32
C39
C39+
C39E
C39E+
C93
S25
S25+
I25
I25+
ITF14
C128
C128A
C128B
C128C
EAN2
EAN5
EAN8
EAN13
UPCA
UPCE
MSI
MSI+
POSTNET
PLANET
TELEPENALPHA
TELEPENNUMERIC
RMS4CC
KIX
IMB
CODABAR
CODE11
PHARMA
PHARMA2T

POST/api/v1/barcodes

바코드 생성

name, type, value를 담은 JSON을 보내세요. type은 C128 또는 EAN13 같은 심볼로지 키입니다. 색상, width_scale, height, display_text가 렌더링 이미지를 제어합니다.

이름	유형	필수	기본값	설명
name	string	예	—	리소스에 저장되는 레이블.
type	string	예	C128	C128, EAN13, UPCA 같은 심볼로지 키.
value	string	예	—	바코드에 인코딩되는 데이터. 선택한 유형에 유효해야 합니다.
project_id	integer	아니오	—	리소스를 연결할 프로젝트.
is_bulk	boolean	아니오	false	true이면 value의 각 줄마다 바코드 하나가 만들어집니다.
foreground_color	string	아니오	#000000	모듈 색상(HEX).
background_color	string	아니오	#ffffff	배경 HEX 색상. 모듈보다 밝게 유지하세요.
width_scale	integer	아니오	2	막대 너비 배수, 1–10.
height	integer	아니오	30	픽셀 단위 막대 높이, 30–1000.
display_text	boolean	아니오	false	true이면 막대 아래에 value가 인쇄됩니다.

요청 예

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}'

더 많은 예

EAN-13

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Retail EAN-13",
  "type": "EAN13",
  "value": "5901234123457",
  "height": 70,
  "display_text": true
}'

응답 예제

{
  "data": {
    "id": 1,
    "type": "C128",
    "name": "Product SKU",
    "value": "FORQR-1001",
    "barcode": "https://…/barcodes/…/barcode.svg"
  }
}

GET/api/v1/barcodes

바코드 목록

이름	유형	필수	설명
page	integer	아니오	Page number (default 1)
results_per_page	integer	아니오	Items per page (default 25, max 100)
search	string	아니오	Search term
search_by	string	아니오	Column to search
order_by	string	아니오	Sort column
order_type	string	아니오	asc or desc
datetime_start	string	아니오	ISO datetime filter start
datetime_end	string	아니오	ISO datetime filter end

curl -X GET 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET/api/v1/barcodes/{id}

바코드 하나 읽기

이름	유형	필수	설명
id	integer	예	—

curl -X GET 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH/api/v1/barcodes/{id}

바코드 업데이트

이름	유형	필수	기본값	설명
id	integer	예	—	—
name	string	아니오	—	리소스에 저장되는 레이블.
type	string	아니오	C128	C128, EAN13, UPCA 같은 심볼로지 키.
value	string	아니오	—	바코드에 인코딩되는 데이터. 선택한 유형에 유효해야 합니다.
project_id	integer	아니오	—	리소스를 연결할 프로젝트.
is_bulk	boolean	아니오	false	true이면 value의 각 줄마다 바코드 하나가 만들어집니다.
foreground_color	string	아니오	#000000	모듈 색상(HEX).
background_color	string	아니오	#ffffff	배경 HEX 색상. 모듈보다 밝게 유지하세요.
width_scale	integer	아니오	2	막대 너비 배수, 1–10.
height	integer	아니오	30	픽셀 단위 막대 높이, 30–1000.
display_text	boolean	아니오	false	true이면 막대 아래에 value가 인쇄됩니다.

요청 예

curl -X PATCH 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "value": "FORQR-2002",
  "height": 90
}'

DELETE/api/v1/barcodes/{id}

바코드 삭제

이름	유형	필수	설명
id	integer	예	—

curl -X DELETE 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

매개변수 이름과 JSON 예제는 영어로 표시됩니다. YOUR_API_KEY를 계정 키로 바꾸세요.