Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danangfir/simpleexpense-tracker-api
API to track and manage your expenses, built with NestJS and MongoDB, with JWT authentication feature.
https://github.com/danangfir/simpleexpense-tracker-api
jwt mongodb nestjs typescript
Last synced: 12 days ago
JSON representation
API to track and manage your expenses, built with NestJS and MongoDB, with JWT authentication feature.
- Host: GitHub
- URL: https://github.com/danangfir/simpleexpense-tracker-api
- Owner: danangfir
- Created: 2024-06-17T07:51:41.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-06-20T08:30:24.000Z (8 months ago)
- Last Synced: 2024-11-18T22:19:27.705Z (2 months ago)
- Topics: jwt, mongodb, nestjs, typescript
- Language: TypeScript
- Homepage:
- Size: 124 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Expense Tracker API
## Deskripsi
Expense Tracker API adalah sebuah API yang dibangun menggunakan NestJS untuk melacak pengeluaran. API ini menyediakan fitur-fitur seperti mendaftar sebagai pengguna baru, otentikasi dengan JWT, menambah, memperbarui, menghapus, dan melihat pengeluaran dengan berbagai filter.
## Fitur
- **Autentikasi JWT**: Untuk melindungi endpoint dan mengidentifikasi pengguna.
- **Manajemen Pengeluaran**: Menambah, memperbarui, menghapus, dan melihat pengeluaran dengan filter.
- **Kategori Pengeluaran**: Groceries, Leisure, Electronics, Utilities, Clothing, Health, Others.
## Teknologi yang Digunakan
- **NestJS**: Framework untuk membangun server-side aplikasi.
- **MongoDB**: Database NoSQL untuk menyimpan data pengeluaran.
- **JWT**: Untuk otentikasi dan manajemen sesi pengguna.
## Instalasi
### Prasyarat
Pastikan Anda telah menginstal:
- Node.js (versi terbaru)
- MongoDB (berjalan di mesin lokal atau di server)
### Langkah-langkah
**Kloning repositori ini**
```bash
git clone https://github.com/username/expense-tracker-api.git
cd expense-tracker-api
```
**Instal dependensi**
```bash
npm install
```
**Buat file `.env`**
Buat file `.env` di root proyek dan tambahkan konfigurasi berikut:
```env
MONGO_URI=mongodb://localhost:27017/expense-tracker
JWT_SECRET=your_jwt_secret_key
```
**Jalankan aplikasi**
Untuk menjalankan aplikasi dalam mode pengembangan:
```bash
npm run start:dev
```
**Jalankan pengujian**
Untuk menjalankan pengujian E2E:
```bash
npm run test:e2e
```
## Penggunaan Api
**Mendaftar User Baru**
- Endpoint: POST /auth/signup
- Body:
```json
{
"email": "[email protected]",
"password": "password123"
}
```
**Masuk**
- Endpoint: POST /auth/login
- Body:
```json
{
"email": "[email protected]",
"password": "password123"
}
```
## Menambah Pengeluaran
- Endpoint: POST /expenses
- Header: Authorization: Bearer
- Body:
```json
{
"amount": 100,
"description": "Grocery shopping",
"category": "Groceries",
"date": "2023-10-10"
}
```
## Melihat Pengeluaran
- Endpoint: GET /expenses
- Header: Authorization: Bearer