https://github.com/duduxs/auth-api
✨ My first authenticated api using kotlin
https://github.com/duduxs/auth-api
api jax-rs junit5 klogging mongodb morphia own project quarkus restassured swagger testcontainers
Last synced: 8 months ago
JSON representation
✨ My first authenticated api using kotlin
- Host: GitHub
- URL: https://github.com/duduxs/auth-api
- Owner: Duduxs
- License: mit
- Created: 2021-04-21T22:17:21.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-09-05T19:14:36.000Z (almost 5 years ago)
- Last Synced: 2025-06-21T23:32:46.163Z (12 months ago)
- Topics: api, jax-rs, junit5, klogging, mongodb, morphia, own, project, quarkus, restassured, swagger, testcontainers
- Language: Kotlin
- Homepage:
- Size: 306 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Auth API
This application was developed in order to train authorization/authentication concepts.
This project is based in CRUD with Architeture Authenticated with unitary and integration tests.
At time, this app accepts both basic and JWT auth.
Technologies |
How To Use |
How To Contribute |
License
## :rocket: Technologies
This project was developed with the following technologies:
- API:
- [Kotlin](https://kotlinlang.org/)
- [Quarkus](https://quarkus.io/)
- [Mongo](https://www.mongodb.com/pt-br)
- [Morphia](https://github.com/MorphiaOrg/morphia)
- [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services)
- [Hibernate Validator](http://hibernate.org/validator/)
- Utils:
- [Swagger](https://quarkus.io/guides/openapi-swaggerui)
- [Kotlin-Logging](https://github.com/MicroUtils/kotlin-logging)
- Tests:
- [JUnit5](https://junit.org/junit5/docs/current/user-guide/)
- [RestAssured](https://rest-assured.io/)
- [TestContainers](https://www.testcontainers.org/)
## :information_source: How to use
To clone and run this application, you'll need [Git](https://git-scm.com), [Maven](https://maven.apache.org/) and [Mongo](https://www.mongodb.com/pt-br) installed on your computer. From your command line:
```bash
# Clone this repository
$ git clone https://github.com/Duduxs/auth-api
# Go into the repository
$ cd auth-api
```
To run the API server:
```bash
# put at bash mvn: compile quarkus:dev
```
Now access on your browser: http://localhost:8080 [Tests -> 8084]
docs -> http://localhost:8080/q/doc
## :thumbsup: How To Contribute
- Make a fork;
- Create a branch with your feature: `git checkout -b my-feature`;
- Commit changes: `git commit -m 'feat: My new feature'`;
- Make a push to your branch: `git push origin my-feature`.
## :memo: License
This project is under the MIT license. See the [LICENSE](https://github.com/Duduxs/auth-api/blob/main/LICENSE) for more information.
---
Made by Eduardo José 😆 Contact me!