Barcode parameters & Parameters for the REST API
The ActiveBarcode API creates PNG and JPG images to allow a wide range of applications. Best practise is to use PNG because this format creates compact and loseless images and is therefore a perfect match for barcodes.
PNG
PNG
https://api.activebarcode.net/v1/pngJPG
https://api.activebarcode.net/v1/jpg
access=You can try out and evaluate the REST API by omitting the API key. Without the access key, the barcode will be branded with a notice: "For evaluation use only". Use your API key that you received with your order confirmation instead of the placeholder. Convenient: The API key does not change as long as you do not terminate the monthly subscription. api.activebarcode.net/v1/png?access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
text=Sets the text that you want to display as a barcode. This may be an article number or a text message like "Hello World!". Make sure this parameter is URL-Encoded. You can enter control codes in human readable form like this: <CR>, <LF>, ... api.activebarcode.net/v1/png?text=ActiveBarcode&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?text=Hello%20World!&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?text=Hello<CR>World!&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?text=Hello<TAB>World!&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?text=(10)451214<FNC1>(37)20&typeno=108&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
showtext=Select whether the human readable line is visible or not. (1=visible, 0=invisible). api.activebarcode.net/v1/png?showtext=1&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?showtext=0&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
typeno=Barcode type as number that you want to use for encoding i.e.: 14 (=CODE128) api.activebarcode.net/v1/png?typeno=14&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?typeno=42&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?typeno=113&access=YOUR-KEY-HERE
Note: If you don't know the type number you can use the parameter "code" instead. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code=Set barcode type as a human readable name that you want to use for encoding i.e.: CODE128 Note: It's better to set the parameter "typeno=" because it's unique. api.activebarcode.net/v1/png?code=CODE128&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?code=CODEDATAMATRIXSQUARE&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?code=CODEQRCODE&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
backcolor=Background color as html color. E.g. ffffff = white, 000000 = black api.activebarcode.net/v1/png?backcolor=ff0000&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?backcolor=00ff00&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?backcolor=0000ff&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
forecolor=Foreground color as html color. E.g. ffffff = white, 000000 = black api.activebarcode.net/v1/png?forecolor=ff0000&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?forecolor=00ff00&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?forecolor=0000ff&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
width=Sets the width of the resulting image file. api.activebarcode.net/v1/png?width=250&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?width=600&backcolor=eeeeee&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
height=Sets the height of the resulting image file. api.activebarcode.net/v1/png?height=100&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?height=200&backcolor=eeeeee&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
rotate=Orientation (rotation) in degrees. Possible values: 0, 90, 180, 270 api.activebarcode.net/v1/png?rotate=0&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?rotate=90&height=200&width=150&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?rotate=180&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?rotate=270&height=200&width=150&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BorderWidth=Border left and right. (free space) api.activebarcode.net/v1/png?BorderWidth=0&width=360&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?BorderWidth=50&width=460&backcolor=eeeeee&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BorderHeight=Border top and bottom. (free space) api.activebarcode.net/v1/png?BorderHeight=0&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?BorderHeight=25&backcolor=eeeeee&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
alignment=Alignment of the barcode within the area to be displayed: alignment=left, alignment=center, alignment=right. If the parameter is not specified, the barcode is centered. Alternatively, numerical values can be used: alignment=0 (left), alignment=1 (center), alignment=2 (right). api.activebarcode.net/v1/png?alignment=left&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?alignment=center&backcolor=eeeeee&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?alignment=right&backcolor=eeeeee&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NotchHeightInPercent=Hight of the notches (EAN-13, UPC-A/E and others) in percent. api.activebarcode.net/v1/png?NotchHeightInPercent=50&code=CODEEAN13&text=123456789012&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?NotchHeightInPercent=100&code=CODEEAN13&text=123456789012&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontname=Font of the barcode cleartext line. api.activebarcode.net/v1/png?fontname=Arial&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontname=Times%20New%20Roman&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontsize=Font size of the barcode cleartext line. api.activebarcode.net/v1/png?fontsize=8&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontsize=28&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontbold=font bold (on/off/0/1) api.activebarcode.net/v1/png?fontbold=on&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontbold=off&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontitalic=font italic (on/off/0/1) api.activebarcode.net/v1/png?fontitalic=on&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontitalic=off&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontunderline=font underline (on/off/0/1) api.activebarcode.net/v1/png?fontunderline=on&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontunderline=off&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fontstrikeout=font strikeout (on/off/0/1) api.activebarcode.net/v1/png?fontstrikeout=on&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?fontstrikeout=off&access=YOUR-KEY-HERE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ocr=Optical character recognition (on/off/0/1) Enable OCR if the text generated in the barcode image needs to be analyzed. If automatic error handling is required, this allows the input text to be compared with the resulting text in the barcode image. When using parameters with critical values, a SIZE ERROR or TEXT ERROR image may be generated instead of the desired barcode. A human will visually see these errors and act accordingly. To detect these error situations when the API is automated, these error messages can be evaluated from the image using optical character recognition. When OCR is enabled, the OCR-result field is added to the http response header. Note that checksum characters might be added to the barcode text when comparing it to the input text. Also note that the barcode image must have a plain text line with recognizable text so choose the font accordingly. If this parameter is omitted, the default is off. Enable this feature only if it's really needed, as it will add some latency to perform OCR on the requested barcode. This feature is only available if the API key is provided. api.activebarcode.net/v1/png?ocr=on&access=YOUR-KEY-HERE api.activebarcode.net/v1/png?ocr=off&access=YOUR-KEY-HERE |