{"id":17008931,"url":"https://github.com/barbaracalderon/the-12-barcodes-api","last_synced_at":"2025-08-24T22:10:13.924Z","repository":{"id":221759381,"uuid":"753825785","full_name":"barbaracalderon/the-12-barcodes-api","owner":"barbaracalderon","description":"The \"12 barcodes API\"  provides a simple and efficient way to generate barcodes for your applications.","archived":false,"fork":false,"pushed_at":"2024-02-16T01:29:35.000Z","size":2018,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T12:42:41.450Z","etag":null,"topics":["api","barcode","barcodes","code128","code39","ean13","ean14","ean8","flask","flask-api","gs1-128","html5up","isbn-10","isbn-13","issn","jan","pzn7","rest-api","restful-api","upc-a"],"latest_commit_sha":null,"homepage":"https://the-12-barcodes-api.onrender.com","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/barbaracalderon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-06T21:27:07.000Z","updated_at":"2024-04-26T19:38:12.000Z","dependencies_parsed_at":"2024-11-28T23:05:01.591Z","dependency_job_id":"d6220e32-6d8e-4455-9161-af949e6061d6","html_url":"https://github.com/barbaracalderon/the-12-barcodes-api","commit_stats":null,"previous_names":["barbaracalderon/the-12-barcodes-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/barbaracalderon/the-12-barcodes-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fthe-12-barcodes-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fthe-12-barcodes-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fthe-12-barcodes-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fthe-12-barcodes-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barbaracalderon","download_url":"https://codeload.github.com/barbaracalderon/the-12-barcodes-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fthe-12-barcodes-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261060131,"owners_count":23103981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","barcode","barcodes","code128","code39","ean13","ean14","ean8","flask","flask-api","gs1-128","html5up","isbn-10","isbn-13","issn","jan","pzn7","rest-api","restful-api","upc-a"],"created_at":"2024-10-14T05:42:17.467Z","updated_at":"2025-06-21T04:06:50.496Z","avatar_url":"https://github.com/barbaracalderon.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# The 12 Barcodes API\n\n[**The 12 Barcodes API**](https://the-12-barcodes-api.onrender.com/) 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**](https://the-12-barcodes-api.onrender.com/swagger-ui) documentation.\n\nThis API may be of particular interest to **developers, event organizers, manufacturers and suppliers, library technicians and archivists, students and educators**. \n\n![The 12 Barcodes API landing page](page.png)\n## Author\n\nI'm Barbara Calderon, a software developer from Brazil. \n- [Github](https://www.github.com/barbaracalderon)\n- [Linkedin](https://www.linkedin.com/in/barbaracalderondev)\n- [Twitter](https://www.x.com/bederoni)\n\n\n## Run locally\n\n### 1. Clone the repo\n\n```bash\ngit clone git@github.com:barbaracalderon/the-12-barcodes-api.git\n```\n\n### 2. Enter the project directory\n\n```bash\ncd project-name\n```\n\n### 3. Install dependencies\n\nMake sure you have Python installed.\n\n```bash\npip install -r requirements.txt\n```\n\n### 4. Run \n\n```bash\ngunicorn --bind \"0.0.0.0:80\" wsgi:app\n```\n\n## API Documentation\n\n#### HTTP\n\n| Method      | Returns                       | Object Format   |\n|-------------|-------------------------------|-----------------|\n| GET         | Retrieves barcode information | JSON           |\n| POST        | Retrieves barcode image       | PNG            |\n\n\n#### POST endpoints\n\n\n| Endpoint   | Parameter      | Type   | Description |\n|------------|----------------|--------|-------------|\n| /ean-8     | `product_data` | String | Required    |\n| /ean-14    | `product_data` | String | Required    |\n| /gs1-128   | `product_data` | String | Required    |\n| /isbn-10   | `product_data` | String | Required    |\n| /isbn-13   | `product_data` | String | Required    |\n| /issn      | `product_data` | String | Required    |\n| /jan       | `product_data` | String | Required    |\n| /code-128  | `product_data` | String | Required    |\n| /code-39   | `product_data` | String | Required    |\n| /pzn7      | `product_data` | String | Required    |\n| /upc-a     | `product_data` | String | Required    |\n\n\n## Stack used\n\n**Frontend**\n\n- HTML5UP\n- SCSS\n- Javascript\n\n**Backend**\n\n- Flask\n- Flask-Smorest\n- Marshmallow\n- BytesIO\n- GUnicorn\n\n\n## Improvements\n\nImplementing **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.\n## Contributions\n\nEncouraging contributions from the community is vital for the success and growth of any project. We could greatly improve by adopting tests.\n\n**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.\n\n**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.\n\n## License\n\n[GNU General Public Licence v3.0](https://choosealicense.com/licenses/gpl-3.0/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarbaracalderon%2Fthe-12-barcodes-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarbaracalderon%2Fthe-12-barcodes-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarbaracalderon%2Fthe-12-barcodes-api/lists"}