İlk FastAPI REST API’nizi Oluşturun: Kapsamlı Bir Kılavuz
Merhaba! Ben Fatih Soysal ve bugün size Python tabanlı yüksek performanslı bir web framework’ü olan FastAPI ile kendi REST API’nizi nasıl oluşturacağınızı adım adım göstereceğim. Bu rehber, başlangıç seviyesindeki geliştiriciler için bile kolayca anlaşılabilir şekilde hazırlanmıştır. Öncelikle, gerekli paketleri kuracağız. Ardından, basit bir API oluşturacak ve daha sonra bunu genişleteceğiz.
Gerekli Kurulumlar
İlk adım, pip kullanarak FastAPI ve Uvicorn paketlerini kurmak. Uvicorn, FastAPI uygulamanızı çalıştırmak için kullanılan bir ASGI sunucusudur. Bu işlemi aşağıdaki komut ile gerçekleştiriyoruz:
pip install fastapi uvicorn
Kurulum tamamlandıktan sonra, ilk API uygulamamızı oluşturabiliriz. Öncelikle, main.py adında bir Python dosyası oluşturun. Bu dosyanın içine aşağıdaki kodu yazın:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
async def root():
return {"message": "Merhaba FastAPI!"}
Bu basit kod, kök dizinine (“/”) bir GET isteği gönderildiğinde “Merhaba FastAPI!” mesajını içeren bir JSON yanıtı döndürür. Şimdi bu API’yi çalıştıralım. Terminalde aşağıdaki komutu çalıştırın:
uvicorn main:app --reload
Bu komut, uygulamanızı başlatır ve değişiklikleri otomatik olarak yeniden yükler. Artık tarayıcınızda veya bir API istemcisinde http://127.0.0.1:8000 adresini ziyaret ederek API’nizin çalıştığını doğrulayabilirsiniz. Sonuç olarak, “Merhaba FastAPI!” mesajını içeren bir JSON objesi görmelisiniz.
Daha Gelişmiş Bir API Oluşturma
Şimdi, biraz daha karmaşık bir API oluşturalım. Örneğin, kullanıcı verilerini yönetebilen bir API tasarlayalım. Bunun için, öncelikle bir veri modeli tanımlamamız gerekiyor. Pydantic kütüphanesi, bunu kolaylaştırıyor. Pydantic’i kurmak için aşağıdaki komutu kullanın:
pip install pydantic
Ardından, main.py dosyanızı aşağıdaki gibi güncelleyin:
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class User(BaseModel):
id: int
name: str
surname: str
@app.post("/users/", response_model=User)
async def create_user(user: User):
return user
Bu kodda, User adında bir veri modeli tanımladık. @app.post("/users/") dekoratörü, /users/ yoluna POST isteği gönderildiğinde create_user fonksiyonunun çağrıldığını belirtir. response_model=User ise, fonksiyonun bir User objesi döndüreceğini belirtir. Bu API’yi test etmek için bir POST isteği göndermeniz gerekecektir. Postman veya benzeri bir araç kullanabilirsiniz.
Ek Kaynaklar ve İpuçları
Daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyebilirsiniz:
Umarım bu kılavuz, ilk FastAPI REST API’nizi oluşturmanıza yardımcı olmuştur. Herhangi bir sorunuz varsa, yorumlarda bana ulaşabilirsiniz. FastAPI ile geliştirme yolculuğunuza devam ederken, bolca kod yazmanız dileğiyle!