No Description

Matt Clark d499ed04d1 Updating dependencies. 2 weeks ago
.github a3a236012c fix cron schedule 2 years ago
config ac532ce938 Using new log library and more. 1 month ago
resources 01899448f0 Updating logging and using LibMetrics. 2 weeks ago
src d499ed04d1 Updating dependencies. 2 weeks ago
.env d499ed04d1 Updating dependencies. 2 weeks ago
.gitignore 2f2b6117e8 Minor refactoring. 2 years ago
.project 0fc7c5e30f Refactoring in most code generators, adding more customization options. 1 year ago
Dockerfile f7b6128108 include resources in container 2 years ago 6a9da4daef Added Readme, URL encoding in requests. 6 years ago 7013b96ca4 add docker to readme 2 years ago
pom.xml d499ed04d1 Updating dependencies. 2 weeks ago

The web server was designed to provide an easy to use barcode generation API via the HTTP protocol for use in external / mobile applications where generation libraries might not exist or resources limited; the WebUI is also designed to be responsive such that users may generate barcodes to be scanned directly from their web browser or download the barcodes after testing them out.

Web Server

The server comes with a minimal set of static HTML and Javascript files that allow users to generate barcodes in their web browser with ease. The UI allows users to quickly download, print, or copy the images for use in other applications.

API Server

The server will generate a barcode for any content passed to the /api endpoint; this can be done using a web browser, fetched through a user script, or even simply with cURL.

curl > gen.png

Automatic Code Type Detection

When calling the API endpoint without specifying an eplitit code type the server will make its best judgement as to which code type will be best suited for the supplied data.


Defined Code Type

A list of all supported barcodes types is available by calling the /types/ endpoint; this will be a JSON Array containing details for each type including a regex format to prevalidate the date before a request.

Specific barcode types may be requested by adding the type string in the request URL:


Docker Container

To build the image run:
docker build -t barcodeAPIServer .

And to run the container:
docker run -p 8080:8080 -v $(pwd)/config:/config barcodeAPIServer

Third-Party is only made possible with the use of third-party software.

Jetty, Apache 2.0

  • The BarcodeAPI server was built around the Jetty web server framework.

Barcode4J, Apache 2.0

  • Barcode4J is an open source barcode generator; it is used for the generation of the following code types:

ZXing, Apache 2.0

  • ZXing is a barcode processing library that makes QR code generation possible.


Copyright 2020

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.