Kahve İçmeden Önce Bir Arka Uç Kurmaya Çalıştığım Gün
Pazartesi sabahı bir arka uç kurmaya çalışıp da API ağ geçidinizin 403 Forbidden hatasıyla tatile çıktığını ve veritabanınızın bağlanma sorunları olduğunu fark ettiniz mi? Bir zamanlar ben de öyleydim. Ufacık bir uç nokta istiyordum—sadece sevimli bir /hello—ve bir şekilde kendimi VPC'leri bir Hogwarts evi seçer gibi tartışırken buldum.
İşte iyi haber: Lovable Cloud, "bir arka uç kurma" kısmını... şey... sevimli hale getirmeye çalışıyor. Ya da en azından öfke nöbeti geçirmemeye. Eğer 30 dakikanız, bir Wi-Fi bağlantınız ve birkaç metafora tahammülünüz varsa, Lovable Cloud ile adım adım bir arka ucu nasıl kuracağınızı, nelere dikkat etmeniz gerektiğini ve uç noktaların spagetti yığınına dönüşmesini nasıl engelleyeceğinizi anlatacağım.
Uyarı: Bu pratik, uygulamalı bir rehberdir. Daha az satıcı şiiri, daha çok "buraya tıklayın, bunu yazın, şunu yapmayın." Ve evet, gerçek bir şey yayınlayacağız: kimlik doğrulama, veritabanı, ortam sırları, dağıtım, izleme ve ölçeklendirme için hızlı bir yol içeren çalışan bir API. Bir şeyler atıştırın. Bir şeyler yayınlıyoruz.
Lovable Cloud Nedir ve Arka Ucunuz Neden Umursamalı?
Lovable Cloud'u modern bir arka uç İsviçre Çakısı gibi düşünün: sunucusuz fonksiyonlar, API yönlendirme, veritabanı bağlantıları, ortam sırları ve CI/CD—hepsi sizi tozlu bir YAML dosyaları hayvanat bahçesini yönetmekten kurtarmak için.
- Kod yazarsınız (Node/TypeScript, Python—şu anda popüler olanlar için belgelere bakın).
- Rotalar tanımlarsınız (REST). Eğer havalıysanız, GraphQL katmanlayabilir veya JSON ile kalabilirsiniz.
- Yönetilen bir veritabanına bağlanırsınız (PostgreSQL burada tipik lise aşkıdır).
- Dağıtırsınız. Ölçeklenir. Saat 3'te uyanıp daha fazla sunucu eklemek için endişelenmeyi bırakırsınız.
Eğer "arka uç" zihinsel modeliniz şuyysa: uç noktalar + kimlik doğrulama + veri + dağıtım + günlükler, Lovable Cloud daha az bip sesi ve daha fazla fişle hızlı şerit olmaya çalışır.
Lovable Cloud ile Bir Arka Uç Kurmak İçin Oyun Planı
- Bir Lovable Cloud projesi ve deposu oluşturun.
- Bir genel ve bir korumalı rotaya sahip bir API iskeleti oluşturun.
- Bir PostgreSQL veritabanı ekleyin ve bir taşıma işlemi çalıştırın.
- Ortam değişkenlerini ve basit bir ORM'yi bağlayın.
- Kimlik doğrulama ekleyin (JWT, oturum belirteçleri veya OAuth—seçim sizin).
- Bir hazırlık ortamına dağıtın.
- İzleme/günlük kaydı ve bir otomatik test ekleyin.
- Gelecekteki benliğinizin kalbini kırmadan üretime geçirin.
Evet, kulağa çok şey gibi geliyor. Hayır, tüm hafta sürmeyecek.
Adım 1: Lovable Cloud Projenizi Çalıştırın (A.K.A. Yeni Proje Kokusu)
- Bir hesap oluşturun ve yeni bir proje başlatın. Daha sonra tanıyacağınız bir şey adlandırın—"not_final_backend_v7" bir tuzaktır.
- Çalışma zamanınızı seçin (Node/TypeScript genellikle API'ler için kalabalığı memnun eder).
- Mevcutsa bir şablon seçin: "REST API" veya "Sunucusuz Fonksiyonlar" sizi boş sayfa korkusundan daha hızlı yeşile götürür.
Bir Git deposu (sizinki veya onlarınki) ve bir geliştirme ortamı elde edersiniz. Hemen bir dal oluşturursanız bonus puan ("feature/hello-api") böylece ana dalınız yaşayan bir hatalar müzesi olmaz.
Adım 2: İlk Uç Noktanızı İskeleleyin (Çünkü Hello World Hala Çok İyi)
Temel bir rota oluşturun: /api/hello. Aptal ve mutlu tutun.
- Rota dosyası:
routes/hello.ts
- Fonksiyon:
{ message: "Hello, world" } gibi JSON döndürür
- Yerel olarak test edin: cURL veya favori HTTP istemciniz. Eğer 200 alamazsanız, adımlarınızı tekrar gözden geçirin ve günlükleri kontrol edin.
Profesyonel ipucu: Rota işleyicilerinizi zayıf tutun—uç noktanın içinde iş mantığı yok. Mantığı hizmetlere koyun. Gelecekteki yeniden düzenlemeleriniz size teşekkür edecek.
Adım 3: Kadim DevOps Ruhlarını Çağırmadan Bir Veritabanı Ekleyin
PostgreSQL'i seçin. Güvenilir, ilişkiseldir ve birleştirmelere alerjisi yoktur.
- Lovable Cloud'da yönetilen bir Postgres örneği oluşturun.
- Kimlik bilgilerini ortam değişkenleri olarak saklayın:
DATABASE_URL, DB_USER, DB_PASS, DB_HOST, DB_NAME.
- Bir ORM veya sorgu oluşturucu seçin (Prisma, Drizzle, Knex). Hız ve şema sağlığı için Prisma'ya meyilliyim.
Çalıştığını kanıtlamak için küçük bir users tablosu oluşturun:
- Şema:
id (uuid), email (unique), created_at (timestamp).
- Geliştirme ortamınızdan geçişi çalıştırın.
- Bir liste döndüren bir
GET /api/users uç noktası yazın. Yeni bir tane eklemek için bir POST /api/users ekleyin. Kimlik doğrulama ile koruyun (bir sonraki adım), ancak şimdilik bir test eklemesiyle doğrulayın.
Zaman aşımları veya bağlantı sıfırlamaları görüyorsanız, şunları kontrol edin: doğru port, SSL modu ve geliştirme ortamınızın DB ile konuşmasına izin verilip verilmediği (VPC kuralları ve IP izin listeleri dramayı sever).
Adım 4: Kullanıcıları Ağlatmayan Kimlik Doğrulama Ekleyin
Seçenekleriniz var:
- Durumsuz API'ler için JWT tabanlı kimlik doğrulama
- Güvenli çerezlerle oturum belirteçleri (web uygulamaları için harika)
- Google, GitHub vb. ile OAuth (şifre arafından kaçınmak için harika)
Hızlı bir zafer için JWT ile başlayın:
- Giriş yaparken belirteçler oluşturun (
POST /api/auth/login).
- Lovable Cloud'un sır yöneticisinde imzalama sırrını saklayın.
Authorization: Bearer <token> başlığını okuyan bir ara yazılım oluşturun.
POST /api/users gibi rotaları ve verileri değiştiren her şeyi koruyun.
Unutmayın: kısa belirteç ömürleri + yenileme belirteçleri = cihazlar kaybolduğunda veya geliştiriciler bir belirteci bir YouTube yorumunda bıraktıklarını unuttuklarında daha az baş ağrısı (sormayın).
Adım 5: Ortam Değişkenleri: Sırlar, Hediyelik Eşyalar Değil
Lovable Cloud'un ortam yöneticisini kullanarak sırları merkezileştirin:
- Üçüncü taraf API anahtarları (e-posta sağlayıcısı, ödemeler)
Ortam başına ayarlayın (geliştirme, hazırlık, üretim). Hiçbir şeyi sabit kodlamayın. Yapmayın. "Sadece şimdilik" bile. Korku hikayeleri böyle başlar.
Adım 6: Gelecekteki Terapistinize Açıklamadan Hazırlık Ortamına Dağıtın
Dağıt'ı tıklayın. Günlükleri izleyin. Nefes alın.
- Sağlık kontrollerini doğrulayın: Kökünüz veya
/api/health ok döndürüyor mu?
- Bir duman testi çalıştırın:
GET /api/hello, GET /api/users.
- Bir test belirteciyle korunan bir rotayı deneyin—onun olmadan 401'i, onunla 200'ü onaylayın.
Soğuk başlatmalar yavaşsa, küçük fonksiyonları mantıklı olan tek bir hizmette birleştirin. Sunucusuz harika, ancak 400 küçük fonksiyon, şefsiz bir orkestra olabilir.
Adım 7: İzleme Ekleyin, Böylece Saat 2'de Tahminde Bulunmayın
- İstek günlüğünü etkinleştirin (yapılandırılmış günlükler, lütfen).
- Hata yakalamayı ayarlayın (istek kimliği ile yığın izleri).
- Gecikme panoları ekleyin. Sadece p50'yi değil, p95'i izleyin. Kullanıcılarınız ortalamaları deneyimlemez.
- 5xx ani yükselişleri ve DB bağlantı çalkantısı için uyarılar oluşturun.
Her katmanda istek kimliği içeren tek bir günlük satırı, "Bunu gören var mı?" ile başlayan 10.000 Slack mesajına bedeldir.
Adım 8: Bir Test Yazın. Sonra İki. Sonra Otomatikleştirin.
Küçük başlayın:
- Birim testi: e-postaları doğrulayan veya toplamları hesaplayan bir hizmet fonksiyonu.
- Entegrasyon testi: bir test DB'si ile
/api/users'i çağırın.
Çekme isteklerinde testleri çalıştırmak için CI'ı bağlayın. Kırmızı testlerle PR birleştirmesi yok. Bugün bin teste ihtiyacınız yok—sadece kritik yollara. Emniyet kemerleri gibi.
Adım 9: Üretime Geçirin (Evet, Dikkatlice)
- Ana hattı bir saat dondurun. Düzeltmeleri önce hazırlık ortamına gönderin.
- Yapıyı yükseltin. Dağıtım sonrası bir duman testi çalıştırın.
- Genel uç noktalarda hız sınırlaması etkinleştirin.
- Önbelleğe alırsanız, makul TTL'ler ayarlayın. Önbelleğe almazsanız, DB'nizin size yorgun gözlerle bakmasına hazırlanın.
Bir geri alma planı ekleyin: Bir tane sahip olarak onu nazarlamıyorsunuz. Yetişkin oluyorsunuz.
Bir Öğleden Sonra Yayınlayabileceğiniz Basit, Gerçek Bir Arka Uç
Küçük ama gerçek bir özellik kümesini bağlayalım:
- Herkese açık
GET /api/hello (sağlık ve akıl sağlığı).
- Korumalı
POST /api/users (kullanıcı oluştur) ve GET /api/me (kimliği doğrulanmış kullanıcıyı döndürür).
- Doğrudan aramalar için
GET /api/users/:id.
- Yumuşak silme:
DELETE /api/users/:id deleted_at'i değiştirir.
Botların arka ucunuzu kardiyo olarak kullanmaması için /api/auth/login'e hız sınırlaması ekleyin.
Ardından e-posta sağlayıcınız aracılığıyla bir hoş geldiniz e-postası serpiştirin. Mesajı işlemsel ve arkadaşça tutun—pazarlamayı gerçek pazarlama rotalarına saklayın.
Lovable Cloud ile Bir Arka Uç Kurarken Ortak Tuzaklar
- Sunucusuzda paylaşılan durum: Çağrılar arasında bellek içi önbelleklere güvenmeyin. Redis (yönetilen) veya DB'nizi kullanın.
- Eksik CORS yapılandırması: İzin verilen kaynakları ayarlayın. Uygulamanızın alan ad(lar)ıyla sınırlayın. Üretimde tam joker karaktere gitmeyin.
- Uzun soğuk başlatmalar: Bağımlılıkları akıllıca paketleyin, fonksiyon başına şişkinliği azaltın veya sıcak yolları birleştirin.
- Dizinlenmemiş sorgular: Eğer
GET /api/users yavaşsa, email ve created_at üzerinde bir dizin ekleyin. Gelecekteki benliğiniz teşekkürlerini sunar.
- Sessiz arızalar: Her zaman hataları bağlamıyla birlikte günlüğe kaydedin. "Bir şeyler bozuldu" bir DevOps şiiri değildir.
Daha Sonra Ağlamamak İçin Kod Nasıl Yapılandırılır
- İş mantığı için
services/
- Veri erişimi için
repositories/ veya db/
- Kimlik doğrulama, hız sınırı, girdi doğrulama için
middlewares/
- Yardımcılar için
lib/ (e-posta, şifreleme, üçüncü taraf API'leri)
Mümkün olduğunda fonksiyonları saf tutun. Yan etkileri kenarlara koyun. Test etmeyi kolaylaştırır ve hata ayıklamayı bir suç şovuna benzetmez.
Gerçekten Önemli Olan Performans İyileştirmeleri
- Herhangi bir liste uç noktasında sayfalama kullanın. Büyük veri kümeleriniz varsa imleç tabanlı.
- Her istekte dünyayı yeniden göndermekten kaçınmak için ETag'ler veya son değiştirilme başlıkları ekleyin.
- Pahalı sorgular için hesaplanmış yanıtları önbelleğe alın.
- Yapabildiğinizde yazmaları toplu olarak yapın. N+1 sorguları, arka uç hatalarının parıltısıdır—her yere yayılırlar.
Görmezden Gelemeyeceğiniz Güvenlik Temelleri (İsteseniz Bile)
- Her rotada girdiyi doğrulayın. JSON şeması veya bir doğrulama kitaplığı sürpriz saldırıları önler.
- Parolaları Argon2 veya bcrypt ile karma hale getirin. Asla kendi şifrelemenizi yapmayın. Asla. Lütfen.
- Anahtarları ve sırları düzenli olarak döndürün. Takvim hatırlatıcıları ihlallerden daha ucuzdur.
- En az ayrıcalıklı veritabanı rollerini kullanın. API'nizin süper kullanıcı güçlerine ihtiyacı yok—hiç kimsenin yok.
Fiyatlandırma Gerçeklik Kontrolü: Kalp Yanığı Değil, Büyüme İçin Plan Yapın
Sunucusuz, olana kadar bedava gibi gelir. İzleyin:
- Trafik ani olduğunda soğuk başlatma cezaları.
- Geveze API'ler için çıkış maliyetleri.
- Arka plan işleri olması gereken uzun süren fonksiyonlar.
Bütçeler ve uyarılar ayarlayın. Eğer CFO'nuz size bir yangın emojisi gönderirse, çoktan geç kalmışsınızdır.
Belgelere, Örneklere ve Bir Akıl Sağlığı Kontrolüne İhtiyacınız Olduğunda
İki gerçekliğe göre yaşıyorum: bir şeyi nasıl yapılandırdığınızı unutacaksınız ve saat 23:00'de tekrar kurmanız gerekecek. Deponuzda bir README bulundurun:
- Ortak komutlar (geçişler, testler, dağıtım)
- Örnek isteklerle uç nokta listesi
Üç ay sonraki Yeni Siz veya gelecek hafta Gerçek Yeni Takım Arkadaşı için arkadaşça hale getirin.
Belirtmeye Değer: Araştırma ve Kod İncelemeleri İçin Bir Kısayol
Belirtmeye değer: Mimari seçimler konusunda ikinci bir görüş almak veya en iyi uygulamaları hızlı bir şekilde karşılaştırmak istiyorsanız, Sider.AI planınızı inceleyen, garip köşe durumlarına işaret eden ve göndermeden önce size bir kontrol listesi veren o saçma sapan takım arkadaşı gibi davranabilir. Sizin için Dağıt'ı tıklamayacak—ancak "eyvah" Slack dizisinden kaçınmanıza yardımcı olacaktır. Hızlı Referans: Lovable Cloud Arka Uç Kontrol Listeniz
- Proje oluşturuldu, Git ayarlandı, dal stratejisi
- JSON döndüren Hello uç noktası
- Veritabanı sağlandı, geçiş çalıştırıldı, ORM bağlandı
- Kimlik doğrulama yerinde, sırlar ortam yöneticisinde
- Hazırlık ortamı dağıtıldı, günlükler temiz, korumalı rotalar çalışıyor
- İzleme, uyarılar, temel panolar
- Testler CI'a bağlandı, kırmızı PR yok
- Hız sınırlaması ve geri alma planı ile üretim sürümü
Bunu monitörünüze yapıştırın. Veya dövme yaptırın. (Lütfen dövme yaptırmayın.)
Sonuç: Sıkıcı Hale Getirerek (İyi Anlamda) Sevimli Hale Getirin
Sevimli bir arka uç, siz uyurken sessizce işini yapandır. Sıkıcı, kanıtlanmış parçalarla oluşturun: HTTP uç noktaları, temiz kimlik doğrulama, sağlam bir veritabanı ve mantıklı dağıtım. Lovable Cloud, iskele dramasını ortadan kaldırarak önemli olan kısımlara—ürününüze, kullanıcılarınıza ve hatta atladığınız o kahveye—odaklanmanıza yardımcı olur.
/hello'yu gönderin. /users'ı ekleyin. Vidaları sıkın. Ardından arka ucunuz vızıldarken kelimenin tam anlamıyla başka bir şey yapmaya gidin. Bu sadece sevimli değil—bu yaşamak.
Mini Soru-Cevap: Gerçek Dünya Senaryoları
Aynı projede herkese açık ve özel API'leri karıştırabilir miyim?
Evet. Özel rotaları geçit yapmak için ara yazılım kullanın ve makineler arası trafik için ayrı belirteçler/anahtarlar kullanın. Kapsamları dar tutun.
Arka plan işlerine ihtiyacım olursa ne olur?
Uzun süren işler (e-postalar, raporlar, senkronizasyonlar) için zamanlanmış veya kuyruk odaklı fonksiyonlar döndürün. Bülten göndermek için kullanıcı isteklerini engellemeyin.
Hazırlık ve üretimin sırları gençler gibi değiştirmesini nasıl engellerim?
Ayrı ortamlar. Ayrı sırlar. CI'da güvenlik önlemleri, böylece hazırlık kimlik bilgileri asla üretim yapılarına sızmaz.
Basit başlayıp daha sonra tam mikro hizmetlere gidebilir miyim?
Kesinlikle. Hız için monolitik benzeri başlayın. Metrikleriniz "şimdi" dediğinde sıcak noktaları çıkarın, bir podcast "mikro hizmetler havalı" dediğinde değil.
Sonraki Adımlar: 30 Dakikalık Planınız
- 5 dakika: Proje oluştur, şablon seç
- 10 dakika:
/api/hello'yu oluştur, veritabanını bağla, geçişi çalıştır
- 10 dakika: JWT kimlik doğrulaması ekle,
POST /api/users'ı koru
- 5 dakika: Hazırlık ortamına dağıt, duman testi çalıştır
İşte bu kadar. Az önce Lovable Cloud ile bir arka uç kurdunuz. Çalışıyor. Ölçekleniyor. Ve hala kahvenizi ısıtmak için zamanınız var.
SSS
S1:Lovable Cloud, arka uç kuran yeni başlayanlar için iyi mi?
Evet—şablonları, sunucusuz fonksiyonları ve ortam yöneticisi ilk arka ucu çok daha az korkutucu hale getiriyor. Basit bir REST API ile başlayın, bir veritabanı ekleyin, ardından kimlik doğrulamayı katmanlayın. Bir veri merkeziyle güreşmeden gerçek kalıplar öğreneceksiniz.
S2:Lovable Cloud arka ucumu üretim için nasıl güvenceye alırım?
JWT veya OAuth kullanın, CORS'u kilitleyin ve sırları ortam yöneticisinde saklayın. Hız sınırları ekleyin, her rotada girdiyi doğrulayın ve kullanıcılar yapmadan sorunları yakalamak için p95 gecikmesini izleyin.
S3:REST API'leri için Lovable Cloud ile en iyi hangi veritabanı çalışır?
PostgreSQL çoğu uygulama için güvenilir bir seçimdir, özellikle Prisma veya Drizzle gibi bir ORM ile. İlişkisel verileri, işlemleri ve indekslemeyi drama olmadan işler ve trafik arttıkça ölçeklenir.
S4:Sunucusuz arka uçlarda soğuk başlatmaları ve performansı nasıl ele alırım?
Bağımlılıkları akıllıca paketleyin, kritik yolları ısıtın ve bir hizmetin yapacağı zaman yüz küçük fonksiyondan kaçının. Önbelleğe alma ve sayfalama ekleyin ve gerçekten önemli olanı ayarlamak için p95 gecikmesini izleyin.
S5:Ayrı sırlar ve URL'lerle hazırlık ve üretimi dağıtabilir miyim?
Kesinlikle. Ayrı ortamlar oluşturun, farklı DATABASE_URL, JWT_SECRET ve alan adları ayarlayın ve yapıları ileriye doğru yükseltin. Testi güvenli tutar ve geri almaları acısız hale getirir.
