{"id":27162151,"url":"https://github.com/mathleite/gin-boilerplate-api","last_synced_at":"2026-04-15T10:36:03.548Z","repository":{"id":300139932,"uuid":"964244575","full_name":"mathleite/gin-boilerplate-api","owner":"mathleite","description":"My personal Gin boilerplate API","archived":false,"fork":false,"pushed_at":"2025-04-10T23:10:35.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-20T04:04:25.174Z","etag":null,"topics":["api","boilerplate","docker","docker-compose","galidator","gin","gin-framework","go","golang","gorm","jwt-authentication","postgresql","template","template-project"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mathleite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-04-10T23:05:00.000Z","updated_at":"2025-04-10T23:07:48.000Z","dependencies_parsed_at":"2025-06-20T04:04:31.054Z","dependency_job_id":null,"html_url":"https://github.com/mathleite/gin-boilerplate-api","commit_stats":null,"previous_names":["mathleite/gin-boilerplate-api"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mathleite/gin-boilerplate-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fgin-boilerplate-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fgin-boilerplate-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fgin-boilerplate-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fgin-boilerplate-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mathleite","download_url":"https://codeload.github.com/mathleite/gin-boilerplate-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fgin-boilerplate-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260878328,"owners_count":23075959,"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","boilerplate","docker","docker-compose","galidator","gin","gin-framework","go","golang","gorm","jwt-authentication","postgresql","template","template-project"],"created_at":"2025-04-09T00:59:25.133Z","updated_at":"2026-04-15T10:35:58.509Z","avatar_url":"https://github.com/mathleite.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gin Boilerplate API\n\n`gin-boilerplate-api` is a Go-based microservice designed to handle client-related operations. This API provides endpoints for managing user data and authentication.\n\n## Table of Contents\n\n- [Features](#features)\n- [Getting Started](#getting-started)\n- [API Endpoints](#api-endpoints)\n- [Examples](#examples)\n\n## Features\n\n- RESTful API for client management.\n- Built with Go for high performance and scalability.\n- Easy to integrate with other microservices.\n\n## Getting Started\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/mathleite/gin-boilerplate-api-api.git\n   ```\n2. Navigate to the project directory:\n   ```bash\n   cd gin-boilerplate-api-api\n   ```\n3. Create and fill .env:\n   ```bash\n   cp .env.example .env \u0026\u0026 \\\n   vim .env\n   ```\n4. Run the application:\n   ```bash\n   docker compose up --build --no-cache -d\n   ```\n\n## API Endpoints\n\n### Base URL\n\n```\nhttp://localhost:8000/api/v1\n```\n\n### Endpoints\n\n- **GET /health**: Application _health-check_.\n- **POST /register**: Register a user.\n- **POST /signin**: SignIn a user.\n- **GET /transactions**: Access a authenticated endpoint _(has no logic here)_.\n\n## Examples\n\n### Create a User\n\n**Request:**\n\n```bash\ncurl --request POST \\\n  --url http://localhost:8000/api/v1/register \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n\t\"name\": \"Boiler Plate\",\n\t\"email\": \"me.boilerplate@devlocal.com\",\n\t\"password\": \"123root\"\n}'\n```\n\n### SignIn\n\n**Request:**\n\n```bash\ncurl --request POST \\\n  --url http://localhost:8000/api/v1/auth/signin \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n\t\"email\": \"me.matheusleite@devlocal.com\",\n\t\"password\": \"123root\"\n}'\n```\n\n**Response:**\n\n```json\n{\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDEzMDUxMTcsImlhdCI6MTc0MTMwMzMxNywidXNlcl9pZCI6ImRiNGI5YWE4LTMwZDMtNDExMy05MjE2LTUwZTE0MTQ2OGQ1NSJ9.ZvUjK32lDg6OTFdNl-OTQDV_2ywcYLAWNWu3V23QYgo\"\n}\n```\n\n### \"Fetch transactions\"\n\n**Request:**\n\n```bash\ncurl --request GET \\\n  --url http://localhost:8000/api/v1/transactions \\\n  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDEzMDUxMTcsImlhdCI6MTc0MTMwMzMxNywidXNlcl9pZCI6ImRiNGI5YWE4LTMwZDMtNDExMy05MjE2LTUwZTE0MTQ2OGQ1NSJ9.ZvUjK32lDg6OTFdNl-OTQDV_2ywcYLAWNWu3V23QYgo'\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathleite%2Fgin-boilerplate-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathleite%2Fgin-boilerplate-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathleite%2Fgin-boilerplate-api/lists"}