Halo, teman-teman! 👋. Sebelumnya saya sempat share repo foodtrip-api untuk testing api. Ternyata banyak yang kebingunan cara installnya dan menggunakannya. pada kesempatan ini saya coba jelaskan sedikit cara install dan cara menjalankan dilocal.
Salah satu alasan kenapa saya menyarakan testing menggunakan repo local karena seluruh test kita semua yang kontrol. Jadi kita tidak akan mengalamai keterbatasan dalam testing. Contoh umum jika kita menggunakan resouce online kita akan dibatasin hanya boleh hit api sekian x. jika melebihi maka kena limit. terus kadang jika kita menggunakan method POST dan DELETE biasanya dikembalikan dengan hanya random data. ok mungkin cukup intro-nya.😜
Yuk, kita mulai! 🎯
🛠️ Persiapan Awal
Sebelum menginstall dan menjalankan repo, pastikan kamu sudah menyiapkan tools berikut:
- Node.js (wajib)
- XAMPP (atau tool lain untuk mengelola database MySQL)
- Postman (untuk testing API)
- Visual Studio Code (opsional, tapi disarankan)
- PNPM (opsional, bisa pakai NPM juga)
jika semuanya sudah siap, kita langsung lanjut ke proses instalasi! 🚀
📂 Step 1: Clone Repository
Pertama, clone repo foodtrip-api ke lokal. Pastikan kamu sudah menentukan folder tempat penyimpanan. Misalnya, saya menyimpan di D:/tutorial. Jalankan perintah berikut di terminal:
git clone https://github.com/fredysiswanto/foodtrip-api.gitjika telah berhasil clone maka tampilan seperti gambar dibawah ini:
📦 Step 2: Install Node Modules
Setelah clone selesai, pindahkan terminal ke folder repo yang baru saja di-clone, lalu install semua dependency-nya:
cd foodtrip-api
pnpm install
Jika instalasi sukses, terminal akan menampilkan pesan selesai tanpa error seperti gambar diatas.
🛠️ Step 3: Setup Environment
Selanjutnya, kita buat file .env untuk konfigurasi environment. Buat file baru dengan nama .env, lalu copy-paste isi konfigurasi dari file README.md pada repo. Ini penting agar koneksi ke database dan pengaturan lainnya berjalan dengan baik.
🗃️ Step 4: Setup Database
Lanjut ke setup database! Ikuti langkah-langkah berikut:
- Buka XAMPP (atau aplikasi lain yang kamu gunakan).
- Jalankan Apache dan MySQL.
- Buka browser, akses http://localhost/phpmyadmin.
- Buat database baru dengan nama
foodtrip. - Import file SQL dari repo untuk mengisi struktur dan data awal ke database.
Jika database sudah siap, kita bisa langsung jalankan servernya! 🔥
▶️ Step 5: Jalankan Server dan Testing API
kita masuk ke langkah menjalankan server local kita dengan cara mengetik printah pnpm dev. jika tidak ada error maka di terminal teman-teman akan muncul seperti dibawah ini. dan kita bisa lanjut melakukan testing dengan browser dengan mengakses url berikut : http://localhost:3600/api/v1/home/dishes/
Pastikan kamu masih berada di dalam folder repo, lalu ketik perintah berikut:
pnpm devJika tidak ada error, terminal akan menunjukkan pesan bahwa server berjalan, misalnya di port 3600. Kamu bisa langsung coba akses API lewat browser atau Postman:
http://localhost:3600/api/v1/home/dishes/
Untuk mempermudah pengujian, kamu bisa mengimpor collection Postman yang sudah tersedia di repo.
🎯 Kesimpulan
Dengan mengikuti langkah-langkah di atas, kamu seharusnya sudah bisa menjalankan repo foodtrip-api secara lokal dan mulai melakukan testing API. Jangan lupa selalu baca file README.md untuk informasi tambahan!
Kalau masih ada yang bingung atau menemui kendala, jangan ragu buat komentar atau DM saya ya! 🚀
Selamat mencoba dan happy coding! 💻✨
