Barcodes

Barcodes über 34 Symbologien erstellen, mit Farbe, Größe und Beschriftung.

Unterstützte Typen

Übergeben Sie type als einen dieser Symbologieschlüssel. value muss den Regeln dieses Typs entsprechen.

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

Barcode erstellen

Senden Sie JSON mit name, type und value. type ist ein Symbologieschlüssel wie C128 oder EAN13. Farben, width_scale, height und display_text steuern das gerenderte Bild.

Name	Typ	Erforderlich	Standard	Beschreibung
name	string	Ja	—	Bezeichnung, die an der Ressource gespeichert wird.
type	string	Ja	C128	Symbologieschlüssel wie C128, EAN13 oder UPCA.
value	string	Ja	—	Im Barcode kodierte Daten. Muss für den gewählten Typ gültig sein.
project_id	integer	Nein	—	Projekt, dem die Ressource zugeordnet wird.
is_bulk	boolean	Nein	false	Wenn true, wird pro Zeile in value ein Barcode erzeugt.
foreground_color	string	Nein	#000000	Modulfarbe als HEX.
background_color	string	Nein	#ffffff	Hintergrund-HEX-Farbe. Heller halten als die Module.
width_scale	integer	Nein	2	Balkenbreiten-Multiplikator, 1–10.
height	integer	Nein	30	Balkenhöhe in Pixeln, 30–1000.
display_text	boolean	Nein	false	Wenn true, wird value unter den Balken gedruckt.

Anfragebeispiel

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
}'

Weitere Beispiele

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
}'

Antwortbeispiel

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

GET/api/v1/barcodes

Barcode auflisten

Name	Typ	Erforderlich	Beschreibung
page	integer	Nein	Page number (default 1)
results_per_page	integer	Nein	Items per page (default 25, max 100)
search	string	Nein	Search term
search_by	string	Nein	Column to search
order_by	string	Nein	Sort column
order_type	string	Nein	asc or desc
datetime_start	string	Nein	ISO datetime filter start
datetime_end	string	Nein	ISO datetime filter end

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

GET/api/v1/barcodes/{id}

Einen Barcode lesen

Name	Typ	Erforderlich	Beschreibung
id	integer	Ja	—

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

PATCH/api/v1/barcodes/{id}

Barcode aktualisieren

Name	Typ	Erforderlich	Standard	Beschreibung
id	integer	Ja	—	—
name	string	Nein	—	Bezeichnung, die an der Ressource gespeichert wird.
type	string	Nein	C128	Symbologieschlüssel wie C128, EAN13 oder UPCA.
value	string	Nein	—	Im Barcode kodierte Daten. Muss für den gewählten Typ gültig sein.
project_id	integer	Nein	—	Projekt, dem die Ressource zugeordnet wird.
is_bulk	boolean	Nein	false	Wenn true, wird pro Zeile in value ein Barcode erzeugt.
foreground_color	string	Nein	#000000	Modulfarbe als HEX.
background_color	string	Nein	#ffffff	Hintergrund-HEX-Farbe. Heller halten als die Module.
width_scale	integer	Nein	2	Balkenbreiten-Multiplikator, 1–10.
height	integer	Nein	30	Balkenhöhe in Pixeln, 30–1000.
display_text	boolean	Nein	false	Wenn true, wird value unter den Balken gedruckt.

Anfragebeispiel

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}

Barcode löschen

Name	Typ	Erforderlich	Beschreibung
id	integer	Ja	—

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

Parameternamen und JSON-Beispiele sind auf Englisch. Ersetzen Sie YOUR_API_KEY durch Ihren Kontoschlüssel.