API Latihan TOEFL

REST API sederhana yang menyediakan soal-soal latihan TOEFL dari berbagai kategori. Proyek ini dibuat untuk tujuan edukasi, menunjukkan cara membangun API dari nol menggunakan Node.js dan Express.js, serta cara menyajikan data dari file JSON statis.

Dokumentasi Live bisa diakses di: https://toefl-api.vercel.app/document

✨ Fitur Utama

• Data Soal Lengkap: Menyediakan ratusan soal yang terbagi dalam 3 kategori utama (Structure, Reading, Listening).
• Endpoint Fleksibel:
  • GET soal berdasarkan kategori.
  • GET soal acak dari setiap kategori untuk latihan cepat.
• Perhitungan Skor Otomatis: Endpoint POST untuk mengirim jawaban dan mendapatkan skor secara langsung.
• Dokumentasi API: Halaman dokumentasi interaktif yang dibuat dengan HTML & Tailwind CSS untuk mempermudah penggunaan API.
• Siap Deploy: Dikonfigurasi untuk deployment mudah di platform seperti Vercel atau Render.

💻 Teknologi yang Digunakan

• Backend: Node.js, Express.js
• Data: JSON statis
• Deployment: Vercel

📂 Struktur Proyek

/
├── public/
│   └── index.html      # Halaman Dokumentasi API
├── data/
│   └── soal.json       # Bank Soal Lengkap
├── index.js            # Server Utama Express
├── vercel.json         # Konfigurasi untuk Deployment Vercel
└── package.json

Untuk detail lengkap, parameter, dan contoh, silakan kunjungi halaman dokumentasi.

🛠️ Cara Menjalankan Secara Lokal

1. Clone repository ini:

   git clone https://github.com/Roti18/toefl-api
   cd toefl-api

2. Install semua dependency:

   npm install

3. Jalankan server development:

   npm run dev

4. API akan berjalan di http://localhost:3000. Buka alamat tersebut di browser untuk melihat halaman dokumentasi.

🤝 Kontribusi

Merasa ada yang bisa diperbaiki atau ingin menambahkan soal baru? Silakan buat Pull Request! Semua kontribusi diterima dengan senang hati.