JSON'dan TypeScript'e: Türler ve Arayüzler Kılavuzu

# JSON'ı TypeScript Türlerine Dönüştürmek

TypeScript kullanmanın en büyük avantajı, API'den gelen belirsiz JSON verilerine tip güvenliği (type safety) kazandırmaktır. Bu sayede kod yazarken otomatik tamamlama (autocomplete) çalışır ve hataları daha üretim aşamasında fark ederseniz.

---

Manuel Dönüştürme (Interfaces)

Tipik bir kullanıcı JSON'u için şu arayüzü tanımlayabilirsiniz:

interface Kullanici {
  id: number;
  ad: string;
  email: string;
  aktif: boolean;
}

---

Otomatik Araçlar: Quicktype

El ile yüzlerce satırlık JSON'ı TypeScript'e çevirmek yorucudur. Quicktype.io gibi araçlar JSON verinizi alıp size tüm arayüzleri saniyeler içinde verir.

---

Zod ile Çalışma Zamanı Doğrulaması

TypeScript sadece derleme zamanında (kod yazarken) sizi korur. Ama API'den gelen verinin gerçekten beklediğiniz gibi olup olmadığını "çalışma anında" anlamak için Zod kütüphanesini kullanabilirsiniz:

import { z } from 'zod';

const KullaniciSeması = z.object({
  id: z.number(),
  ad: z.string()
});

// Veriyi kontrol et
const sonuc = KullaniciSeması.parse(apiVerisi);

Sonuç

JSON verilerinizi TypeScript tiplerine dönüştürmek projenizin sürdürülebilirliğini artırır. Başlangıçta zaman alsa da, ilerleyen aşamalarda sizi onlarca "undefined" hatasından kurtaracaktır.