RESTful API dengan Express dan Sequelize

Deskripsi Proyek

Proyek ini adalah implementasi RESTful API menggunakan Express.js sebagai framework web dan Sequelize sebagai ORM (Object-Relational Mapping) untuk database SQL Server. API ini menyediakan sistem manajemen pengguna lengkap dengan fitur autentikasi menggunakan JWT (JSON Web Token).

Fitur Utama

• 🔐 Sistem autentikasi dengan JWT (login/signup)
• 👥 Manajemen pengguna (Create, Read, Update, Delete)
• ✅ Validasi data dengan fastest-validator
• 🔒 Enkripsi password dengan bcrypt
• 🗑️ Soft delete untuk penghapusan data aman
• 🛡️ Middleware untuk proteksi endpoint
• 📝 Logging dengan morgan

Teknologi yang Digunakan

• Backend: Node.js, Express.js
• Database: MS SQL Server
• ORM: Sequelize
• Autentikasi: JWT (jsonwebtoken)
• Validasi: fastest-validator
• Password Hashing: bcrypt
• View Engine: EJS

Prasyarat

Sebelum menjalankan proyek ini, pastikan Anda telah menginstal:

• Node.js (versi terbaru)
• MS SQL Server
• NPM atau Yarn

Instalasi dan Penggunaan

1. Clone repositori

git clone https://github.com/faiz-hidayat/restful-api-sequelize.git
cd restful-api-sequelize

2. Install dependensi

npm install

3. Konfigurasi database

Buka file config/config.json dan sesuaikan konfigurasi database:

{
    "development": {
        "username": "username_anda",
        "password": "password_anda",
        "database": "nama_database_anda",
        "host": "localhost",
        "dialect": "mssql"
    }
}

4. Konfigurasi environment

Buat file .env dan isi dengan JWT secret key:

JWT_SECRET=kunci_rahasia_anda

5. Jalankan migrasi database

npx sequelize-cli db:migrate

6. Jalankan seeder (opsional)

npx sequelize-cli db:seed:all

7. Jalankan aplikasi

npm start

Server akan berjalan di http://localhost:3000

Struktur API Endpoints

Endpoint Publik (Tanpa Autentikasi)

• POST /users/signup - Registrasi pengguna baru
• POST /users/signin - Login pengguna

Endpoint Terproteksi (Memerlukan Token JWT)

• GET /users - Mendapatkan semua data pengguna
• GET /users/:id - Mendapatkan data pengguna berdasarkan ID
• PATCH /users/:id - Memperbarui data pengguna berdasarkan ID
• DELETE /users/:id - Menghapus (soft delete) pengguna berdasarkan ID

Format Permintaan dan Respons

Signup (Registrasi)

Request:

POST /users/signup
{
  "username": "contohuser",
  "email": "user@example.com",
  "password": "password123",
  "fullname": "Nama Lengkap",
  "bio": "Bio singkat"
}

Response:

{
    "success": true,
    "message": "User registered successfully",
    "data": {
        "id": 1,
        "username": "contohuser",
        "email": "user@example.com",
        "fullname": "Nama Lengkap",
        "bio": "Bio singkat"
    }
}

Signin (Login)

Request:

POST /users/signin
{
  "email": "user@example.com",
  "password": "password123"
}

Response:

{
    "success": true,
    "message": "Login successful",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
        "id": 1,
        "username": "contohuser",
        "email": "user@example.com",
        "fullname": "Nama Lengkap"
    }
}

Struktur Proyek

.
├── bin/                # Script startup aplikasi
├── config/             # Konfigurasi database
├── controllers/        # Logic aplikasi
├── middlewares/        # Middleware seperti autentikasi
├── migrations/         # Migrasi database Sequelize
├── models/             # Model Sequelize
├── public/             # File statis (CSS, JS, dll)
├── routes/             # Definisi rute API
├── seeders/            # Seeder data awal untuk database
├── views/              # Template EJS
├── .env                # Variabel lingkungan
├── .gitignore          # File yang diabaikan Git
├── app.js              # Entry point aplikasi
└── package.json        # Dependensi dan script

Lisensi

Proyek ini menggunakan lisensi MIT.