API Mock & Schema Studio

1. Sözleşme Odaklı Geliştirme (Contract-First) ve Sıfır Bekleme (Zero-Blocking)

Geleneksel geliştirme akışlarında backend geliştiricilerin veritabanı modellerini ve endpoint'leri tamamlaması beklenir. Bu durum frontend, mobil ve test ekiplerinin haftalarca gecikmesine yol açar. Contract-First yaklaşımında ise ekipler önce OpenAPI (Swagger) veya JSON Schema üzerinde uzlaşır. Sözleşme kesinleştiği anda bu araç sayesinde:

• Frontend Geliştiriciler: Gerçekçi mock verilerle UI bileşenlerini, pagination ve state yönetimini eksiksiz inşa eder.
• Mobil Ekipler: iOS (Swift) ve Android (Kotlin) istemcilerini tip güvenli mock verilerle erkenden test eder.
• QA ve Test Mühendisleri: Uç durumları (edge cases), enum değişkenlerini ve hata senaryolarını canlı servise gerek duymadan doğrular.

2. Akıllı Mock Veri Türetimi Nasıl Çalışır?

Stüdyomuz, şema ağacını özyinelemeli (recursive) olarak dolaşır ve alan meta verilerine göre en uygun değerleri atar:

3. TypeScript ve Runtime Zod Doğrulamasının Birlikte Kullanımı

TypeScript arayüzleri derleme zamanında (compile-time) hata yapmanızı önler; ancak istemciye gelen verinin sözleşmeye uyup uymadığını çalışma anında (runtime) denetleyemez. Bu nedenle modern Next.js 15+ ve React 19 projelerinde hem interface hem de z.object şemaları birlikte kullanılır. Ürettiğimiz Zod şeması sayesinde API yanıtlarını şu şekilde doğrulayabilirsiniz:

import { OrderSchema } from '@/lib/schemas'

export async function fetchOrder(id: string) {
  const res = await fetch(`/api/orders/${id}`)
  const json = await res.json()
  
  // Runtime doğrulama: Şemaya uymayan eksik veya hatalı tipler hemen yakalanır
  const validated = OrderSchema.safeParse(json)
  if (!validated.success) {
    console.error('API sözleşme ihlali:', validated.error.flatten())
    throw new Error('Geçersiz API yanıtı')
  }
  
  return validated.data // Tamamen tip güvenli Order nesnesi
}

4. Next.js 15+ App Router ile Mock API Mimarisi

Stüdyonun ürettiği Next.js Route Handler sekmesindeki kodu doğrudan projenizin app/api/[kaynak]/route.ts dosyasına yerleştirebilirsiniz. Ortam değişkenleriyle (örneğin NEXT_PUBLIC_USE_MOCK_API=true) geliştirme ortamında bu mock rotasını, canlıda ise gerçek backend servisini çağırarak tek bir satır dahi kod değiştirmeden prodüksiyona geçiş sağlayabilirsiniz.

5. Güvenlik, Gizlilik ve %100 İstemci Taraflı (Client-Side) Çalışma Garantisi

Kurumsal projelerde ve tescilli ürün geliştirmede API şemaları, veri modelleri ve şirket içi terminoloji gizlilik arz eder. API Mock & Schema Studio, tüm şema ayrıştırma (parsing), veri üretimi ve tip oluşturma süreçlerini yalnızca tarayıcınızın JavaScript motorunda çalıştırır. Verileriniz hiçbir sunucuya kaydedilmez, loglanmaz veya üçüncü parti servislerle paylaşılmaz.

Blog · Konular · SSS