https://github.com/chrxsdev/calendar-rest-api

Collaborative Events Calendar RestAPI is a powerful tool designed to help you manage and coordinate events in a collaborative environment
https://github.com/chrxsdev/calendar-rest-api

api java mongodb rest-api spring spring-framework spring-security-jwt

Last synced: 4 months ago
JSON representation

Collaborative Events Calendar RestAPI is a powerful tool designed to help you manage and coordinate events in a collaborative environment

• Host: GitHub
• URL: https://github.com/chrxsdev/calendar-rest-api
• Owner: chrxsdev
• License: mit
• Created: 2023-11-02T23:19:12.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-12T19:00:25.000Z (over 2 years ago)
• Last Synced: 2025-05-05T11:45:03.259Z (about 1 year ago)
• Topics: api, java, mongodb, rest-api, spring, spring-framework, spring-security-jwt
• Language: Java
• Homepage: https://events-api-ch4j.onrender.com/api/swagger-ui/index.html
• Size: 109 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Calendar Events RestAPI



   

   



✨ Rest API developed to Collaborative Calendar Events.

## ⚡️ Description

The Collaborative Events Calendar RestAPI is a powerful tool designed to help you manage and coordinate events in a collaborative environment. Built using the Spring Framework, this API allows users to register, log in, and efficiently manage their events. Whether you're a developer looking to integrate this API into your application or an end user seeking to harness its capabilities, this documentation will provide you with a clear understanding of what the API does and how to use it effectively.

## 👨‍💻 Documentation OpenAPI

- [Swagger](https://events-api-ch4j.onrender.com/api/swagger-ui/index.html)

- [Postman Collections & Documentation](https://documenter.getpostman.com/view/21748987/2s9YXe6PVp)

## ✍🏻 Getting Started

Before you get started, make sure you have the following:

1. Java Development Kit (JDK): Install JDK 8 or above on your system.

2. Maven: Ensure you have Maven installed to manage dependencies and build the project.

3. Database: Configure a MongoDB and update the `application.yml` uri.

## 🚀 Setup

> This is the local version for execution.

1. Clone this project: `git clone https://github.com/chrisjosuedev/calendar-rest-api.git`

2. Go to the project folder:

   `cd calendar-rest-api`

3. Configure your MongoDB Cluster and replace `uri` in `application.yml` with your database uri.

4. Configure Env Variable: `SECRET_KEY`, with a new value.

5. Build the project using Maven `mvn clean install -DskipTests`

## 🛠 Run

1. Once the dependencies are installed, you can run via IDE or Maven.

2. Test Endpoints via Postman (or your preferred API tester) on port 9090: `http://localhost:9090/api/...`

   > Please check the documentation (Postman) above to see the available endpoints and change `Dev Env`

## 🦀 Technologies

![SpringBoot badge](https://img.shields.io/badge/springboot-java-brightgreen)

![Java badge](https://img.shields.io/badge/java-21-red)

![MongoDB badge](https://img.shields.io/badge/mongodb-db-green)

## 🧾 License

The MIT License (MIT)