Flask untuk Pemula: Membangun API Sederhana dengan Mudah

Flask adalah framework web Python yang ringan namun sangat powerful. Cocok bagi pemula yang ingin mulai belajar membuat aplikasi web atau API tanpa kompleksitas berlebihan. Dalam artikel ini, kita akan membahas cara membangun API sederhana menggunakan Flask, dari nol hingga berjalan di browser Anda.

Apa Itu Flask?

Flask adalah micro-framework untuk Python yang dirancang untuk memudahkan pembuatan aplikasi web dengan struktur minimalis. Framework ini sangat cocok digunakan untuk membangun API RESTful karena sintaksnya bersih dan dokumentasinya lengkap.

Langkah 1: Persiapan Awal

Sebelum menulis kode, pastikan Python telah terinstal. Jika belum, kunjungi python.org untuk mengunduh dan menginstalnya.

1. Buat folder proyek:

   mkdir flask-api-pemula
   cd flask-api-pemula

2. Buat virtual environment:

   python -m venv venv

3. Aktifkan virtual environment:
   Windows:

   .\venv\Scripts\activate

   macOS/Linux:

   source venv/bin/activate

4. Instal Flask:

   pip install flask

Langkah 2: Membuat API Sederhana

Buat file bernama app.py dan tuliskan kode berikut untuk membuat API dasar:

from flask import Flask, jsonify, request

app = Flask(__name__)

# Data sementara
todos = [
    {'id': 1, 'task': 'Belajar Flask'},
    {'id': 2, 'task': 'Membuat API'}
]

@app.route('/api/todos', methods=['GET'])
def get_todos():
    return jsonify(todos)

@app.route('/api/todos/', methods=['GET'])
def get_todo(todo_id):
    todo = next((item for item in todos if item['id'] == todo_id), None)
    if todo:
        return jsonify(todo)
    return jsonify({'error': 'Data tidak ditemukan'}), 404

@app.route('/api/todos', methods=['POST'])
def add_todo():
    new_todo = request.get_json()
    todos.append(new_todo)
    return jsonify(new_todo), 201

if __name__ == '__main__':
    app.run(debug=True)

Langkah 3: Menjalankan Aplikasi

Jalankan API Anda dengan perintah berikut:

python app.py

Jika berhasil, buka browser dan akses:

• http://127.0.0.1:5000/api/todos – Menampilkan semua data
• http://127.0.0.1:5000/api/todos/1 – Menampilkan data berdasarkan ID

Langkah 4: Uji POST Request dengan Postman

Buka Postman dan kirim request POST ke:

http://127.0.0.1:5000/api/todos

Isi body dengan format JSON:

{
  "id": 3,
  "task": "Belajar REST API"
}

Langkah 5: Tips Pengembangan Lanjutan

• Validasi data: Pastikan setiap input sesuai format yang diharapkan.
• Gunakan database: Untuk data dinamis, sambungkan dengan SQLite, MySQL, atau PostgreSQL.
• Error handling: Tambahkan penanganan error yang konsisten.
• Dokumentasi: Gunakan Swagger atau Postman untuk mendokumentasikan API Anda.

Kesimpulan

Dengan Flask, membangun API sederhana bisa dilakukan dengan cepat dan mudah. Anda sudah melihat bagaimana menyiapkan lingkungan, membuat rute API, hingga menguji request dengan Postman. Ini adalah fondasi penting untuk membangun aplikasi web modern yang lebih kompleks di masa depan.

Teruslah bereksperimen dan belajar. Selamat mencoba membangun API dengan Flask!