Backblaze B2’den FastAPI ile Dosya Servisi<\/p>\n
H\u0131zl\u0131, g\u00fcvenilir ve \u00f6l\u00e7eklenebilir bir dosya servis sistemine mi ihtiyac\u0131n\u0131z var? Backblaze B2’nin sundu\u011fu uygun fiyatl\u0131 ve g\u00fcvenli depolama alan\u0131 ile FastAPI’nin sa\u011flad\u0131\u011f\u0131 performansl\u0131 API geli\u015ftirme olanaklar\u0131n\u0131 birle\u015ftirerek, kendi \u00f6zel dosya sunucunuzu kolayca olu\u015fturabilirsiniz. Bu makalede, Backblaze B2’den FastAPI ile \u00f6zel dosya servisini ad\u0131m ad\u0131m nas\u0131l kuraca\u011f\u0131n\u0131z\u0131, performans optimizasyonlar\u0131n\u0131 ve g\u00fcvenlik hususlar\u0131n\u0131 ele alaca\u011f\u0131z.<\/p>\n
\u00d6ncelikle, Backblaze B2 ve FastAPI’nin temel \u00f6zelliklerini anlamak \u00f6nemlidir. Backblaze B2, bulut tabanl\u0131 bir nesne depolama hizmetidir. Uygun fiyatl\u0131 ve g\u00fcvenilir bir \u00e7\u00f6z\u00fcm sunarak, b\u00fcy\u00fck miktarda veriyi g\u00fcvenli bir \u015fekilde saklaman\u0131z\u0131 sa\u011flar. \u00d6te yandan, FastAPI, Python tabanl\u0131 y\u00fcksek performansl\u0131 bir web \u00e7er\u00e7evesidir. API geli\u015ftirmeyi kolayla\u015ft\u0131r\u0131r ve otomatik dok\u00fcmantasyon gibi bir\u00e7ok avantaj sunar. Bu iki teknolojinin birlikte kullan\u0131m\u0131, h\u0131zl\u0131, g\u00fcvenilir ve \u00f6l\u00e7eklenebilir bir dosya sunucusu olu\u015fturman\u0131za olanak tan\u0131r. \u0130\u015fte bu iki teknolojinin \u00f6nemli \u00f6zelliklerine k\u0131saca g\u00f6z atal\u0131m:<\/p>\n
Bu makalede, Backblaze B2’nin API’sini kullanarak FastAPI ile dosya y\u00fckleme, indirme ve silme i\u015flemlerini nas\u0131l ger\u00e7ekle\u015ftirece\u011finizi \u00f6\u011freneceksiniz. Ayr\u0131ca, dosya y\u00f6netimi, hata y\u00f6netimi ve g\u00fcvenlik konular\u0131na da de\u011finece\u011fiz.<\/p>\n
\u00d6ncelikle, Backblaze B2 hesab\u0131n\u0131za giri\u015f yapman\u0131z ve API anahtarlar\u0131n\u0131z\u0131 olu\u015fturman\u0131z gerekir. Bu anahtarlar, Backblaze B2 ile g\u00fcvenli bir \u015fekilde ileti\u015fim kurman\u0131z\u0131 sa\u011flayacakt\u0131r. Hesab\u0131n\u0131zda “Application Keys” b\u00f6l\u00fcm\u00fcnden yeni bir uygulama anahtar\u0131 olu\u015fturabilirsiniz. Bu anahtar\u0131, uygulaman\u0131zda Backblaze B2 ile ileti\u015fim kurmak i\u00e7in kullanacaks\u0131n\u0131z. A\u015fa\u011f\u0131daki kod blo\u011fu, Backblaze B2’ye ba\u011flanmak ve kimlik do\u011frulamas\u0131n\u0131 ger\u00e7ekle\u015ftirmek i\u00e7in kullan\u0131labilecek bir \u00f6rnektir:<\/p>\n
import backblaze_b2\n\n# Backblaze B2 API anahtarlar\u0131n\u0131z\u0131 buraya girin\naccount_id = \"YOUR_ACCOUNT_ID\"\napplication_key = \"YOUR_APPLICATION_KEY\"\n\nb2 = backblaze_b2.B2(account_id, application_key)\nb2.authorize()\nbucket_id = b2.list_buckets()[0]['bucketId'] # \u0130lk kovay\u0131 se\u00e7iyoruz. Kendi kovay\u0131 belirtin.<\/pre>\n<\/code><\/p>\n
Bu kod blo\u011fu, backblaze_b2<\/code> k\u00fct\u00fcphanesini kullanarak Backblaze B2 hesab\u0131n\u0131za ba\u011flan\u0131r. YOUR_ACCOUNT_ID<\/code> ve YOUR_APPLICATION_KEY<\/code> yerine kendi Backblaze B2 hesap bilgilerinizi girmeniz gerekmektedir. Bu b\u00f6l\u00fcmde hata ay\u0131klama i\u00e7in try-except<\/code> bloklar\u0131 eklemek ve do\u011frulama i\u015flemlerini iyile\u015ftirmek \u00e7ok \u00f6nemlidir. \u00d6rne\u011fin, yanl\u0131\u015f kimlik bilgileri girildi\u011finde uygun bir hata mesaj\u0131 g\u00f6sterilmelidir. Ayr\u0131ca, birden fazla depolama alan\u0131n\u0131z varsa, uygun depolama alan\u0131n\u0131 se\u00e7mek i\u00e7in ek mant\u0131k ekleyebilirsiniz.<\/p>\nFastAPI ile Dosya Y\u00fckleme<\/h2>\n
FastAPI kullanarak dosya y\u00fckleme i\u015flemini ger\u00e7ekle\u015ftirmek olduk\u00e7a basittir. FastAPI'nin UploadFile<\/code> nesnesi, dosya y\u00fckleme i\u015flemini kolayla\u015ft\u0131r\u0131r. A\u015fa\u011f\u0131daki kod blo\u011fu, FastAPI ile dosya y\u00fckleme i\u015flemini g\u00f6stermektedir:<\/p>\nfrom fastapi import FastAPI, UploadFile, File\nfrom fastapi.responses import JSONResponse\n\napp = FastAPI()\n\n@app.post(\"\/uploadfile\/\")\nasync def create_upload_file(file: UploadFile = File(...)):\n try:\n with open(f\".\/uploads\/{file.filename}\", \"wb\") as buffer:\n while content := await file.read(1024): # 1KB'l\u0131k par\u00e7alar halinde oku\n buffer.write(content)\n \n # Backblaze B2'ye dosyay\u0131 y\u00fckleme i\u015flemi\n upload_url = b2.get_upload_url(bucket_id)\n file_path = f\".\/uploads\/{file.filename}\"\n with open(file_path, \"rb\") as f:\n file_content = f.read()\n file_info = b2.upload_file(upload_url['uploadUrl'], upload_url['authorizationToken'], file.filename, file_content)\n \n # Dosyay\u0131 y\u00fckledikten sonra yerel dosyay\u0131 silme\n import os\n os.remove(file_path)\n \n return JSONResponse({\"filename\": file.filename, \"b2_file_id\": file_info[\"fileId\"]})\n\n except Exception as e:\n return JSONResponse({\"error\": str(e)}, status_code=500)<\/pre>\n<\/code><\/p>\n
Bu kod, \/uploadfile\/<\/code> endpoint'ine bir dosya g\u00f6nderildi\u011finde, dosyay\u0131 \u00f6nce yerel olarak kaydeder, daha sonra Backblaze B2'ye y\u00fckler ve son olarak yerel dosyay\u0131 siler. Hata y\u00f6netimi i\u00e7in try-except<\/code> blo\u011fu kullan\u0131lm\u0131\u015ft\u0131r. Bu i\u015flemde, b\u00fcy\u00fck dosyalar i\u00e7in performans optimizasyonu yapmak \u00f6nemlidir. \u00d6rne\u011fin, dosyay\u0131 par\u00e7alar halinde y\u00fcklemek, bellek t\u00fcketimini azalt\u0131r ve daha h\u0131zl\u0131 y\u00fckleme sa\u011flar. Ayr\u0131ca, dosya t\u00fcr\u00fcn\u00fc kontrol ederek g\u00fcvenli\u011fi art\u0131rabilirsiniz.<\/p>\nFastAPI ile Dosya \u0130ndirme<\/h2>\n
Dosya indirme i\u015flemi i\u00e7in, \u00f6ncelikle Backblaze B2'den dosyan\u0131n URL'sini alman\u0131z gerekir. Daha sonra, FastAPI kullanarak bu URL'yi kullanarak dosyay\u0131 kullan\u0131c\u0131lara iletebilirsiniz. A\u015fa\u011f\u0131daki kod blo\u011fu, FastAPI ile dosya indirme i\u015flemini g\u00f6stermektedir:<\/p>\n
from fastapi import FastAPI, HTTPException\nfrom fastapi.responses import StreamingResponse\nimport backblaze_b2\n\n# ... (Backblaze B2 ba\u011flant\u0131 bilgileri ve di\u011fer kodlar) ...\n\n@app.get(\"\/download\/{file_id}\")\nasync def download_file(file_id: str):\n try:\n file_info = b2.get_file_info(bucket_id, file_id)\n download_url = b2.get_download_url(file_id, file_info[\"fileName\"])\n response = requests.get(download_url[\"downloadUrl\"], stream=True)\n response.raise_for_status() # Hata kontrol\u00fc\n\n return StreamingResponse(response.iter_content(chunk_size=8192), media_type=\"application\/octet-stream\")\n except backblaze_b2.exceptions.B2NotFoundError:\n raise HTTPException(status_code=404, detail=\"Dosya bulunamad\u0131\")\n except Exception as e:\n raise HTTPException(status_code=500, detail=f\"Bir hata olu\u015ftu: {str(e)}\")<\/pre>\n<\/code><\/p>\n
Bu kod, \/download\/{file_id}<\/code> endpoint'ine bir file_id<\/code> g\u00f6nderildi\u011finde, ilgili dosyan\u0131n indirme URL'sini Backblaze B2'den al\u0131r ve StreamingResponse<\/code> kullanarak dosyay\u0131 kullan\u0131c\u0131lara ak\u0131\u015f olarak g\u00f6nderir. Bu yakla\u015f\u0131m, b\u00fcy\u00fck dosyalar\u0131n indirme i\u015flemini daha verimli hale getirir. Hata y\u00f6netimi i\u00e7in, try-except<\/code> blo\u011fu ile B2NotFoundError<\/code> gibi Backblaze B2 ile ilgili \u00f6zel hatalar ele al\u0131nm\u0131\u015ft\u0131r. Ayr\u0131ca genel istisnalar da yakalanarak 500 hatas\u0131 d\u00f6nd\u00fcr\u00fcl\u00fcr.<\/p>\nDosya Silme \u0130\u015flemi ve Hata Y\u00f6netimi<\/h2>\n
Dosya silme i\u015flemi, Backblaze B2 API'sini kullanarak ger\u00e7ekle\u015ftirilir. FastAPI ile bir endpoint olu\u015fturarak, kullan\u0131c\u0131lar\u0131n belirli bir file_id<\/code>'ye sahip dosyalar\u0131 silmelerine olanak tan\u0131yabilirsiniz. A\u015fa\u011f\u0131daki \u00f6rnekte, hata y\u00f6netimi ve g\u00fcvenlik \u00f6nlemleri de g\u00f6sterilmektedir:<\/p>\n@app.delete(\"\/delete\/{file_id}\")\nasync def delete_file(file_id: str):\n try:\n b2.delete_file_version(bucket_id, file_id)\n return {\"message\": \"Dosya ba\u015far\u0131yla silindi\"}\n except backblaze_b2.exceptions.B2NotFoundError:\n raise HTTPException(status_code=404, detail=\"Dosya bulunamad\u0131\")\n except Exception as e:\n raise HTTPException(status_code=500, detail=f\"Bir hata olu\u015ftu: {str(e)}\")<\/pre>\n<\/code><\/p>\n
Bu kod blo\u011fu, \/delete\/{file_id}<\/code> endpoint'ini tan\u0131mlar. file_id<\/code> parametresi, silinecek dosyan\u0131n ID'sini belirtir. try-except<\/code> blo\u011fu, hata y\u00f6netimi i\u00e7in kullan\u0131l\u0131r. B2NotFoundError<\/code> \u00f6zel istisnas\u0131, dosya bulunamad\u0131\u011f\u0131nda yakalan\u0131r ve 404 hatas\u0131 d\u00f6nd\u00fcr\u00fcl\u00fcr. Di\u011fer istisnalar ise genel bir 500 hatas\u0131yla y\u00f6netilir. G\u00fcvenlik a\u00e7\u0131s\u0131ndan, sadece yetkili kullan\u0131c\u0131lar\u0131n dosya silme i\u015flemini ger\u00e7ekle\u015ftirebildi\u011finden emin olmak i\u00e7in yetkilendirme mekanizmalar\u0131 eklenmelidir. \u00d6rne\u011fin, API anahtarlar\u0131n\u0131 do\u011frudan kod i\u00e7inde saklamaktan ka\u00e7\u0131n\u0131lmal\u0131 ve daha g\u00fcvenli y\u00f6ntemler tercih edilmelidir.<\/p>\nPerformans Optimizasyonu ve \u00d6l\u00e7eklenebilirlik<\/h2>\n
Uygulaman\u0131n performans\u0131n\u0131 ve \u00f6l\u00e7eklenebilirli\u011fini art\u0131rmak i\u00e7in birka\u00e7 teknik kullanabilirsiniz. Bunlardan baz\u0131lar\u0131 \u015funlard\u0131r:<\/p>\n
\n- Asenkron \u0130\u015flemler:<\/strong> FastAPI'nin asenkron yeteneklerini kullanarak, dosya y\u00fckleme ve indirme i\u015flemlerini e\u015f zamanl\u0131 olarak ger\u00e7ekle\u015ftirebilirsiniz. Bu, uygulaman\u0131z\u0131n genel performans\u0131n\u0131 iyile\u015ftirir.<\/li>\n
- Par\u00e7al\u0131 Y\u00fckleme:<\/strong> B\u00fcy\u00fck dosyalar i\u00e7in, dosyay\u0131 k\u00fc\u00e7\u00fck par\u00e7alara b\u00f6lerek y\u00fckleyebilirsiniz. Bu, bellek t\u00fcketimini azalt\u0131r ve y\u00fckleme s\u00fcresini k\u0131salt\u0131r.<\/li>\n
- Cacheleme:<\/strong> S\u0131k eri\u015filen dosyalar i\u00e7in bir \u00f6nbellek mekanizmas\u0131 kullanarak, Backblaze B2'den dosya indirme i\u015flemini h\u0131zland\u0131rabilirsiniz. Redis gibi bir \u00f6nbellek sistemi kullanabilirsiniz. <\/li>\n
- CDN kullan\u0131m\u0131:<\/strong> Backblaze B2 ile entegre \u00e7al\u0131\u015fan bir CDN (Content Delivery Network) kullanarak, dosya indirme h\u0131z\u0131n\u0131 ve eri\u015filebilirli\u011fini \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131rabilirsiniz. Bu, \u00f6zellikle co\u011frafi olarak da\u011f\u0131lm\u0131\u015f kullan\u0131c\u0131lar\u0131n\u0131z varsa \u00e7ok \u00f6nemlidir.<\/li>\n<\/ul>\n
G\u00fcvenlik Hususlar\u0131<\/h2>\n
Uygulaman\u0131z\u0131n g\u00fcvenli\u011fini sa\u011flamak i\u00e7in a\u015fa\u011f\u0131daki hususlara dikkat etmelisiniz:<\/p>\n
\nDikkat!<\/h3>\n
API anahtarlar\u0131n\u0131z\u0131 asla kodunuzun i\u00e7inde do\u011frudan saklamay\u0131n. \u00c7evre de\u011fi\u015fkenleri veya g\u00fcvenli bir s\u0131r y\u00f6netimi sistemi kullan\u0131n. <\/p>\n<\/div>\n
\n- HTTPS kullan\u0131m\u0131:<\/strong> T\u00fcm ileti\u015fimleri \u015fifrelemek i\u00e7in HTTPS kullan\u0131n.<\/li>\n
- Yetkilendirme ve Kimlik Do\u011frulama:<\/strong> Uygulaman\u0131z\u0131n sadece yetkili kullan\u0131c\u0131lar\u0131n dosyalara eri\u015febilmesini sa\u011flamak i\u00e7in g\u00fcvenli bir yetkilendirme ve kimlik do\u011frulama mekanizmas\u0131 kullan\u0131n (\u00f6rne\u011fin, JWT).<\/li>\n
- Giri\u015f Denetimleri:<\/strong> Zararl\u0131 dosya y\u00fcklemelerini \u00f6nlemek i\u00e7in dosya t\u00fcrlerini kontrol edin ve zararl\u0131 i\u00e7erikleri engellemek i\u00e7in uygun \u00f6nlemler al\u0131n.<\/li>\n
- Hata Y\u00f6netimi:<\/strong> Uygulama hatalar\u0131n\u0131 do\u011fru \u015fekilde y\u00f6netin ve hassas bilgileri if\u015fa etmeyin.<\/li>\n<\/ul>\n
\u00d6\u011frenme Yol Haritas\u0131<\/h2>\n
Bu makaledeki konuyu \u00f6\u011frenmek i\u00e7in a\u015fa\u011f\u0131daki yol haritas\u0131n\u0131 izleyebilirsiniz:<\/p>\n
[Yeni Ba\u015flayan]<\/h3>\n\n- Backblaze B2 hesab\u0131 olu\u015fturma ve API anahtarlar\u0131 alma.<\/li>\n
- Python ve FastAPI temellerini \u00f6\u011frenme.<\/li>\n
- Bu makaledeki temel dosya y\u00fckleme ve indirme \u00f6rneklerini uygulama.<\/li>\n<\/ul>\n
[Orta]<\/h3>\n\n- Hata y\u00f6netimi ve g\u00fcvenlik \u00f6nlemlerini uygulama.<\/li>\n
- Dosya t\u00fcr\u00fc kontrol\u00fc ve do\u011frulama ekleme.<\/li>\n
- Daha geli\u015fmi\u015f dosya y\u00f6netimi fonksiyonlar\u0131 ekleme (\u00f6rne\u011fin, dosya listesi alma, dosya g\u00fcncelleme).<\/li>\n<\/ul>\n
[\u0130leri D\u00fczey]<\/h3>\n