{"id":22945313,"url":"https://github.com/sesaquecruz/go-auth-api","last_synced_at":"2026-05-17T18:02:19.137Z","repository":{"id":159016598,"uuid":"632560326","full_name":"sesaquecruz/go-auth-api","owner":"sesaquecruz","description":"An Auth API with JWT.","archived":false,"fork":false,"pushed_at":"2023-04-30T00:13:12.000Z","size":180,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2025-02-07T14:25:52.862Z","etag":null,"topics":["api","clean-architecture","go","go-chi","jwt","mysql","rest-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sesaquecruz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-04-25T16:57:21.000Z","updated_at":"2023-12-02T16:48:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"a268854c-43db-4b24-ab96-11282061739d","html_url":"https://github.com/sesaquecruz/go-auth-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sesaquecruz%2Fgo-auth-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sesaquecruz%2Fgo-auth-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sesaquecruz%2Fgo-auth-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sesaquecruz%2Fgo-auth-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sesaquecruz","download_url":"https://codeload.github.com/sesaquecruz/go-auth-api/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246717054,"owners_count":20822557,"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","clean-architecture","go","go-chi","jwt","mysql","rest-api"],"created_at":"2024-12-14T14:30:47.209Z","updated_at":"2026-05-17T18:02:19.080Z","avatar_url":"https://github.com/sesaquecruz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# An Auth API with JWT\n\nThis project is a RESTful API written in Go for user authentication and management. It uses JSON Web Tokens (JWT) for authorization and supports basic CRUD operations for user accounts. The API is designed to be easy to integrate into other projects and provides a clean and efficient way to manage user access.\n\n## Endpoints\n\n| Endpoint | Method | Protected | Description |\n| -------- | ------ | --------- | ----------- |\n| `/api/v1/login` | POST   | NO  | Authenticate user and receive JWT token |\n| `/api/v1/users` | POST   | NO  | Create a new user account               |\n| `/api/v1/users` | GET    | YES | Retrieve user data                      |\n| `/api/v1/users` | PUT    | YES | Update user data                        |\n| `/api/v1/users` | DELETE | YES | Delete user account                     |\n| `/api/v1/docs/`  | GET    | NO  | API Documentation / Swagger UI                              |\n\n## Requirements\n\nTo use this program, you will need:\n\n- Docker\n- A stable internet connection\n\n## Installation\n\n1. Clone this repository:\n\n```\ngit clone https://github.com/sesaquecruz/go-auth-api\n```\n\n2. Enter the project directory:\n\n```\ncd go-auth-api\n```\n\n3. Run the docker compose:\n\n```\ndocker compose up -d --build\n```\n\n## Usage\n\n### API Documentation\n\n1. Access the Swagger UI:\n\n```\nhttp://localhost:8080/api/v1/docs/\n```\n\nTo access protected endpoints, a JWT token is required. This token can be obtained by creating a user account and authenticating it. The user ID will be included in the token.\n\n## Troubleshooting\n\nSee [docker-compose.yml](./docker-compose.yml) to verify or change the services, port values, or environment variables values.\n\n## Contributing\n\nContributions are welcome! If you find a bug or would like to suggest an enhancement, please make a fork, create a new branch with the bugfix or feature, and submit a pull request.\n\nThis project follows the [GitFlow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) workflow and adheres to [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). It also has a simple [GitHub Action](./.github/workflows/build-and-test.yml) to verify the build and run tests before merging in some branches.\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](./LICENSE) file for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsesaquecruz%2Fgo-auth-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsesaquecruz%2Fgo-auth-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsesaquecruz%2Fgo-auth-api/lists"}