AraçKutusu

Geliştirici Araçları

JSON ve XML biçimlendirme, Base64, URL kodlama, hash ve UUID araçları.

Biçimlendirme ve doğrulama

JSON Formatlama ve XML Formatlama, tek satıra sıkışmış veriyi girintili ve okunabilir hâle getirir. Asıl faydaları biçimden çok doğrulamadır: eksik virgül, kapanmamış etiket veya fazladan parantez gibi hatalar ayrıştırma sırasında yakalanır ve konumu gösterilir.

Bir API yanıtını incelerken ya da yapılandırma dosyasındaki hatayı ararken bu ilk adımdır. Veri tarayıcınızda ayrıştırılır; yapıştırdığınız içerik hiçbir sunucuya gönderilmez — üretim ortamından alınmış bir yanıtı incelerken bu fark önemlidir.

Kodlama şifreleme değildir

Base64 ve URL kodlama sık karıştırılır ama ikisi de güvenlik sağlamaz. Base64 ikili veriyi metin olarak taşınabilir hâle getirir; herkes anında geri çözebilir. URL kodlama, adres içinde anlam taşıyan karakterleri (?, &, boşluk) güvenli biçimde aktarır. İkisi de veriyi gizlemez, yalnızca taşınabilir kılar. Bir parolayı Base64'e çevirip saklamak onu korumaz.

Hash Oluşturucu tersi yönde çalışır: girdiden sabit uzunlukta bir özet üretir ve bu işlem geri döndürülemez. Dosya bütünlüğünü doğrulamak için kullanılır — indirdiğiniz dosyanın özeti, yayıncının duyurduğu özetle aynıysa dosya yolda değişmemiştir. MD5 ve SHA-1 bu amaç dışında, özellikle parola saklamada güvenli kabul edilmez.

UUID ne zaman gerekir?

UUID Oluşturucu, çakışma ihtimali pratikte yok denecek kadar düşük kimlikler üretir. Artan sayılardan farkı, merkezî bir sayaca ihtiyaç duymamasıdır: birbirinden habersiz iki sistem aynı anda kimlik üretebilir ve çakışmazlar.

Bu, dağıtık sistemlerde ve çevrimdışı çalışabilen uygulamalarda işe yarar. Bedeli okunabilirliktir — kullanıcıya gösterilecek sipariş numarası gibi yerlerde UUID kullanışsızdır; oralarda kısa ve okunur bir numara daha uygundur.

Neden tarayıcıda çalışan araçlar?

Geliştirici araçlarında sunucuya veri göndermek, göründüğünden daha ciddi bir konudur. Bir API yanıtını biçimlendirmek için yapıştırdığınız metin çoğu zaman gerçek kullanıcı verisi, oturum anahtarı veya iç sistem adresi içerir. Bu içeriği tanımadığınız bir siteye göndermek, pratikte küçük bir veri sızıntısıdır.

Buradaki araçların hepsi tarayıcınızda çalışır: yapıştırdığınız veri sayfadan çıkmaz, kaydedilmez ve sayfayı kapattığınızda kalmaz. Kurumsal ortamlarda çevrimiçi biçimlendiricilerin yasaklanmasının sebebi tam olarak budur.

Doğrulama hatalarını okumak

Biçimlendirme araçları bir hata bulduğunda genellikle satır ve sütun bilgisi verir. Bu konum hatanın fark edildiği yerdir, her zaman hatanın kaynağı değildir. Kapatılmayan bir parantez, dosyanın çok ilerisinde bir noktada hata olarak görünür; asıl sorun çok daha yukarıdadır.

Pratik yöntem, bildirilen satırdan geriye doğru yapıyı takip etmektir. Girintili görünüm burada işe yarar: beklenmedik biçimde derinleşen ya da hiç kapanmayan bir blok, gözle hemen ayırt edilir. Dosya makine tarafından üretilmişse hatanın kaynağı çoğu zaman üreten kodda kaçırılmamış bir özel karakterdir.