Web API (REST API) Temelleri ve Flask ile Basit API (1 Görüntüleyici)

# app_api.py dosyası
from flask import Flask, jsonify, request # jsonify ve request içe aktar

app = Flask(__name__)

# Geçici veri kaynağı (bir Python listesi içinde sözlükler)
# Gerçek uygulamada burası veritabanı erişimi olurdu
urunler = [
    {'id': 1, 'ad': 'Laptop', 'fiyat': 15000},
    {'id': 2, 'ad': 'Klavye', 'fiyat': 500},
    {'id': 3, 'ad': 'Fare', 'fiyat': 200}
]

# Tüm ürünleri listeleme endpoint'i (GET /urunler)
@app.route('/urunler', methods=['GET'])
def get_urunler():
    # Python listesini JSON formatına çevir ve yanıt olarak döndür
    return jsonify(urunler)

# Belirli bir ürünü ID'sine göre getirme endpoint'i (GET /urunler/<id>)
@app.route('/urunler/<int:urun_id>', methods=['GET']) # URL'den integer ID al
def get_urun(urun_id):
    # Ürün listesinde ID'ye göre ürünü ara
    for urun in urunler:
        if urun['id'] == urun_id:
            return jsonify(urun) # Bulunan ürünü JSON olarak döndür

    # Ürün bulunamazsa hata yanıtı döndür
    # Flask otomatik olarak 404 status code'unu ayarlar
    return jsonify({'mesaj': 'Ürün bulunamadı'}), 404 # Mesaj ve status kodunu döndür

# Yeni ürün ekleme endpoint'i (POST /urunler)
@app.route('/urunler', methods=['POST'])
def add_urun():
    # Gelen isteğin body'sindeki JSON veriyi al
    # İstek 'Content-Type: application/json' olmalı
    yeni_urun = request.get_json()

    # Gelen verinin geçerliliğini kontrol et (basit kontrol)
    if not yeni_urun or not 'ad' in yeni_urun or not 'fiyat' in yeni_urun:
        # Geçersiz veri formatı ise hata döndür
        return jsonify({'mesaj': 'Geçersiz veri formatı'}), 400 # 400 Bad Request

    # Yeni ürüne bir ID ata (Basit ID atama, gerçekte DB handle eder)
    yeni_id = urunler[-1]['id'] + 1 if urunler else 1 # Eğer liste boş değilse son elemanın ID'sinin 1 fazlası

    # Yeni ürünü oluştur
    urun = {'id': yeni_id, 'ad': yeni_urun['ad'], 'fiyat': yeni_urun['fiyat']}

    # Ürün listesine ekle
    urunler.append(urun)

    # Yeni oluşturulan ürünü JSON olarak başarı mesajı ile döndür
    return jsonify({'mesaj': 'Ürün başarıyla eklendi', 'urun': urun}), 201 # 201 Created status code

# Uygulamayı çalıştırma
if __name__ == '__main__':
    app.run(debug=True)