Giriş
WordPress’te REST API üzerinden alınan JSON yanıtlarında sorunlar sık karşılaşılan sorunlardan biridir. Bu yazıda, JSON hatalarının kök nedenlerini hızlıca tespit etmek ve kalıcı çözümler uygulamak için izlenecek teknik adımları paylaşacağım.

Sorunun Nedeni (Kısa İtibarda)
– JSON yapısındaki bozulmalar veya beklenmeyen yanıtlar.
– REST API uç noktası hataları (yanıt başlıkları, yetkilendirme sorunları).
– Sunucu konfigürasyonu: PHP sürümü, güvenlik modülleri ve .htaccess/Nginx konfigürasyonları.
– Eklenti/tema uyuşmazlıkları ve özel kodlar.

Çözüm Adımları (Kodlu/Teknik)
1) Hata Kaynağını İzole Et
– Admin panelden tüm eklentileri devre dışı bırakın ve varsayılan temayı kullanarak REST API uç noktalarını test edin.
– REST API uç noktalarını manuel olarak çağırıp dönen JSON’u inceleyin.

Kod Bloğu 1: Basit bir REST API çağrısı ve JSON doğrulama (PHP/WordPress)
“`
} else {
$body = wp_remote_retrieve_body( $response );
json_decode( $body );
if ( json_last_error() !== JSON_ERROR_NONE ) {
error_log( ‘JSON Hatası: ‘ . json_last_error_msg() );
} else {
error_log( ‘REST API JSON geçerli.’ );
}
}
?>
“`

2) JSON Geçersiz Hatasını Kesin Tespit Et
– 404/403 gibi yanıtlar yerine gerçek JSON içeriğini yakalayın.
– Hatanın hangi uç noktada olduğunu izole edin ve sadece o uç noktayı test edin.

Kod Bloğu 2: Belirli uç noktaların yanıtlarını inceleme
“`
#!/bin/bash
URLS=(
“https://example.com/wp-json/wp/v2/pages/1”
“https://example.com/wp-json/wp/v2/posts”
)
for url in “${URLS[@]}”; do
echo “Testing: $url”
curl -sS “$url” | python -m json.tool 2>&1 | sed ‘s/$/ /’
done
“`

3) Sunucu Tarafı Konfigürasyonunu Kontrol Etme
– PHP hata günlüklerini inceleyin.
– ModSecurity ve diğer güvenlik modüllerinin JSON çıktısını bozmadığından emin olun.
– .htaccess veya Nginx konfigürasyonunda yanlış yönlendirme olup olmadığını kontrol edin.

Kod Bloğu 3: WordPress hata günlükleri için basit kayıt
“`

“`

4) Eklenti/Tema Uyuşmazlıklarını Temizleme
– Eklentileri tek tek etkinleştirip hangi eklentinin soruna yol açtığını bulun.
– REST API ile etkileşen güvenlik, önbellekleme veya webhook benzeri eklentilere dikkat edin.
– Tema dosyalarındaki REST API ile ilgili özel kodları geçici olarak kaldırın.

Kod Bloğu 4: Basit eklenti devre dışı bırakma kontrolü
“`
/ wp-content / plugins / (devre_disi_yap)
“`

5) Webhook ve Dış Çağrı Hatalarını İzole Etme
– Gelen webhook payload’larının doğruluğunu ve güvenlik imzalarını kontrol edin.
– Hatalı payloadlar JSON çıktısını bozabilir.

Kod Bloğu 5: Basit webhook doğrulama (örnek JSON imza kontrollü)
“`

“`

İpuçları
– Hataları tespit etmek için sunucu loglarınıza aşina olun; hata mesajlarını doğrudan koda yazmaktan kaçının.
– REST API uç noktalarını manuel test edin; hangi uç noktada sorun olduğunu netleştirin.
– Eklentileri tek tek etkinleştirip sorunun hangi eklentiden kaynaklandığını belirleyin.

Kısa Özet
REST API üzerinden dönen JSON’daki bozulmalar, sunucu konfigürasyonu ve eklenti/tema uyumsuzlukları bu tip sorunlara yol açabilir. İzolasyon ve doğrulama adımlarını uygulayarak hatanın kaynağını bulun, güvenli bir JSON çıktısı elde edin; özellikle uç noktalar, güvenlik modülleri ve webhook doğrulama mekanizmalarını test edin.

Bu yazıyı beğendiyseniz, sosyal medya hesaplarınızda paylaşarak daha fazla kişiye ulaşmasını sağlayabilirsiniz. 😊
Ayrıca bizi sosyal medyada da takip edebilirsiniz;
Instagram: @lupusoft
Facebook: @lupusoft
X: @lupusoft
LinkedIn: @lupusoft