JSON Sana Direndiğinde: “1” Değil, Boolean Kullan

Bu yazı, LinkedIn’de paylaştığım bir gönderiden derlenmiştir.

Şöyle bir JSON gördüğümde kendimi Sudoku çözüyormuş gibi hissediyorum:

{
  "invoiceAddress": {
    "isCommercial": "1",
    "isLikeCommercial": ""
  }
}

isCommercial: "1" → Boolean diye bir şey var. isLikeCommercial → bu ne demek şimdi, “ticari değilim ama biraz öyle mi görünüyorum”? Bir de boş string — yani null‘ın sahte bir versiyonu.

Küçük şeyler ama önemliler. Temiz bir veri sözleşmesi — doğru tipler, anlamlı alan adları, gerçek boolean’lar ve gerçek null’lar — API’nizi tüketen herkese saatlerce tahmin yürütme zahmetinden kurtarır. Tip disiplini, bir sonraki geliştiriciye gösterilen bir saygı biçimidir.