The 12 Barcodes API

The 12 Barcodes API is a user-friendly RESTful API designed to provide a simple and practical solution for generating barcodes in applications. Developed in the Flask ecosystem and adopting the MVC architecture, this API offers ease of integration and flexibility. It forgoes the traditional database setup, streamlining the development process and reducing complexity. Checkout The 12 Barcodes API Swagger documentation.

This API may be of particular interest to developers, event organizers, manufacturers and suppliers, library technicians and archivists, students and educators.

Author

I'm Barbara Calderon, a software developer from Brazil.

• Github
• Linkedin
• Twitter

Run locally

1. Clone the repo

git clone git@github.com:barbaracalderon/the-12-barcodes-api.git

2. Enter the project directory

cd project-name

3. Install dependencies

Make sure you have Python installed.

pip install -r requirements.txt

4. Run

gunicorn --bind "0.0.0.0:80" wsgi:app

API Documentation

HTTP

Method	Returns	Object Format
GET	Retrieves barcode information	JSON
POST	Retrieves barcode image	PNG

POST endpoints

Endpoint	Parameter	Type	Description
/ean-8	product_data	String	Required
/ean-14	product_data	String	Required
/gs1-128	product_data	String	Required
/isbn-10	product_data	String	Required
/isbn-13	product_data	String	Required
/issn	product_data	String	Required
/jan	product_data	String	Required
/code-128	product_data	String	Required
/code-39	product_data	String	Required
/pzn7	product_data	String	Required
/upc-a	product_data	String	Required

Stack used

Frontend

• HTML5UP
• SCSS
• Javascript

Backend

• Flask
• Flask-Smorest
• Marshmallow
• BytesIO
• GUnicorn

Improvements

Implementing tests for this project will significantly enhance its reliability and stability. With the test directory already set up using Poetry and pytest, we think there is a foundation for creating comprehensive test suites. Hopefully they will be coming soon to further strengthen the project's robustness and maintainability.

Contributions

Encouraging contributions from the community is vital for the success and growth of any project. We could greatly improve by adopting tests.

Reporting Issues: If you encounter any bugs, glitches, or unexpected behavior, please don't hesitate to report them. You can do so by opening an issue on our GitHub repository. Be sure to include detailed information about the problem you're experiencing, including steps to reproduce it and any relevant error messages.

Submitting Pull Requests: We welcome contributions in the form of code fixes or improvements to existing functionality. If you'd like to contribute code, please submit a pull request on GitHub. Please include documentation for any changes you propose.

License

GNU General Public Licence v3.0