HTTP 422 Unprocessable Entity

HTTP 422 Unprocessable Entity, sunucunun isteğin biçimini anladığını ancak içeriğindeki verinin anlamsal olarak işlenemediğini bildiren durum kodudur. İstek söz dizimi doğrudur, JSON geçerli biçimde yazılmıştır, başlıklar yerindedir. Sorun verinin kendisindedir. Zorunlu bir alan eksiktir, e-posta adresi geçersiz biçimdedir ya da bir değer kabul edilen aralığın dışındadır. Bu kod, özellikle form doğrulama hatalarını bildirmek için REST API'lerde yaygın biçimde kullanılır.

Unprocessable Entity Artık Unprocessable Content

422 durum kodu ile ilgili bilinmesi gereken güncel bir ayrıntı vardır. Kodun resmi adı değişmiştir. Güncel HTTP spesifikasyonu kodu "Unprocessable Content" olarak adlandırır ancak sektörde ve çoğu framework'te hala "Unprocessable Entity" ifadesi kullanılmaya devam eder. İkisi aynı kodu ifade eder; isim değişikliği yalnızca terminolojik bir güncellemedir.

422 Hatası Hangi Durumlarda Oluşur?

Zorunlu Alanların Eksik Olması

Bir kayıt formunda e-posta veya şifre alanı gönderilmediğinde 422 durum kodu döner. JSON geçerlidir; ancak iş kuralları bu alanları zorunlu kılar.

Geçersiz Format

E-posta adresi, telefon numarası, tarih veya URL alanlarının beklenen formatta olmaması en yaygın 422 durum kodu nedenidir.

Veri Tipi Uyuşmazlığı

Sayı beklenen bir alana metin gönderilmesi gibi durumlar bu kategoriye girer. "yas": "yirmi bes" ifadesi geçerli bir JSON'dur; ancak işlenemez.

Aralık ve Uzunluk İhlalleri

Şifrenin minimum karakter sayısının altında olması, yaş alanının negatif değer taşıması veya bir açıklama alanının izin verilen uzunluğu aşması 422 durum kodu ile yanıtlanır.

İş Kuralı İhlalleri

Verinin teknik olarak geçerli olduğu ancak iş mantığına uymadığı durumlar: bitiş tarihinin başlangıç tarihinden önce olması, indirim oranının %100'ü aşması, sipariş adedinin stoktan fazla olması gibi.

İlişkisel Veri Hataları

Var olmayan bir kategori kimliğine ürün eklemeye çalışmak veya geçersiz bir referans kimliği göndermek bu türden hatalardır.

Dosya Yükleme Doğrulamaları

Yüklenen dosyanın türünün kabul edilmemesi (örneğin yalnızca PDF beklenen bir alana .exe gönderilmesi) veya görsel boyutlarının sınırı aşması 422 durum kodu ile bildirilebilir.

422 Durum Kodu Hatası Nasıl Çözülür?

API Kullanıcısı / Geliştirici Olarak

1. Yanıt gövdesini okuyun. 422 durum kodunun en değerli yanı, hatanın nedenini ayrıntılı bildirmesidir. errors alanı genellikle hangi alanın neden reddedildiğini açıkça gösterir.

2. Gönderdiğiniz veriyi doğrulayın. Zorunlu alanların tamamının gönderildiğinden, format kurallarına uyulduğundan ve veri tiplerinin doğru olduğundan emin olun.

3. API dokümantasyonunu kontrol edin. Alan adları, zorunluluk durumları ve kabul edilen değer aralıkları dokümantasyonda tanımlıdır. Alan adındaki bir yazım hatası (örneğin e_mail yerine email) 422 durum koduna yol açar.

4. Content-Type başlığını kontrol edin. JSON gönderiyorsanız Content-Type: application/json başlığının mevcut olduğundan emin olun. Eksik veya hatalı başlık, sunucunun veriyi beklendiği gibi ayrıştıramamasına ve dolayısıyla alanları eksik görmesine yol açabilir.

5. Tekrar denemeyin. 422 durum kodu, beklemekle veya yeniden deneyerek çözülen bir hata değildir. Veri düzeltilmedikçe aynı sonuç alınır. Otomatik yeniden deneme mantığı kurmak gereksiz istek üretir.

API Geliştiricisi Olarak

1. Tüm hataları tek yanıtta döndürün. İlk hatada durup yanıt vermek yerine tüm doğrulama hatalarını toplayıp birlikte iletin. Aksi halde kullanıcı formu tek tek düzelterek birden fazla kez göndermek zorunda kalır.

2. Alan adlarını istekteki adlarla eşleştirin. Hata yanıtındaki alan adı, istemcinin gönderdiği alan adıyla aynı olmalıdır. Böylece arayüz hatayı doğru form alanının altına yerleştirebilir.

3. Mesajları kullanıcı dostu yazın. "Validation failed on field email" gibi teknik mesajlar yerine "Geçerli bir e-posta adresi giriniz" gibi doğrudan gösterilebilir mesajlar tercih edilmelidir.

4. Hassas bilgi sızdırmayın. Hata mesajları veritabanı yapısı, dosya yolları veya iç sistem detaylarını açığa çıkarmamalıdır.

5. Dokümantasyonda listeleyin. Hangi uç noktanın hangi doğrulama kurallarını uyguladığını ve 422 durum kodu yanıt yapısını dokümantasyonda belirtin.

422 Hatası SEO'yu Etkiler mi?

Pratikte etkilemez. 422 durum kodu yalnızca gövde içeren isteklerde (POST, PUT, PATCH) ortaya çıkar. Arama motoru botları sayfaları GET isteğiyle tarar ve bu isteklerde doğrulanacak bir veri gövdesi bulunmaz.