Site sağlığı testinde REST API hatası hostingten kaynaklanabilir mi?

WordPress Site Sağlığı ekranında görünen REST API hatası, yönetim panelinde işlem yaparken yavaşlama, blok editörünün yüklenmemesi, zamanlanmış görevlerin aksaması veya eklenti ayarlarının kaydedilememesi gibi pratik sorunlara yol açabilir. Bu hata her zaman tek bir nedene bağlı değildir; tema, eklenti, güvenlik kuralı, DNS yapılandırması veya hosting tarafındaki sunucu kısıtları aynı uyarıyı tetikleyebilir.

REST API hatası ne anlama gelir?

REST API, WordPress’in yönetim paneli, blok editörü, bazı eklentiler ve harici servislerle veri alışverişi yapmasını sağlayan önemli bir yapıdır. Site Sağlığı testi bu bağlantıyı kontrol eder ve beklenen yanıtı alamazsa hata üretir.

Örneğin /wp-json/ adresi engellenmişse, sunucu 403, 404, 500 veya zaman aşımı yanıtı veriyorsa WordPress bunu REST API problemi olarak yorumlayabilir. Hatanın metni, sorunun kaynağını anlamada önemli ipucu verir.

Bu hata hosting kaynaklı olabilir mi?

Evet, REST API hatası bazı durumlarda doğrudan hosting altyapısından kaynaklanabilir. Özellikle güvenlik duvarı, ModSecurity kuralları, kaynak limitleri, yanlış PHP yapılandırması veya sunucu tarafında yapılan sıkı istek filtrelemeleri REST API isteklerini engelleyebilir.

Ancak yalnızca Site Sağlığı ekranındaki uyarıya bakarak kesin karar vermek doğru değildir. Aynı belirtiyi bir güvenlik eklentisi, önbellek eklentisi, bozuk kalıcı bağlantı ayarı veya hatalı tema fonksiyonu da oluşturabilir.

Hosting tarafında kontrol edilmesi gereken noktalar

Güvenlik duvarı ve ModSecurity kuralları

Bazı sunucu güvenlik kuralları, WordPress’in normal REST API isteklerini şüpheli trafik olarak algılayabilir. Özellikle yönetim panelinde işlem yaparken 403 hatası görülüyorsa, ModSecurity loglarının incelenmesi gerekir. Bu noktada kuralları tamamen kapatmak yerine, sadece ilgili yanlış pozitif kuralın düzenlenmesi daha güvenli bir yaklaşımdır.

PHP sürümü ve kaynak limitleri

Eski PHP sürümleri, düşük bellek limiti veya kısa maksimum çalışma süresi REST API isteğinin tamamlanmadan kesilmesine neden olabilir. WordPress için güncel ve desteklenen PHP sürümü kullanılmalı; bellek limiti, işlem süresi ve CPU kullanımı gerçek trafik düzeyine göre değerlendirilmelidir.

Sunucu yanıt süresi

REST API testinde zaman aşımı hatası alınıyorsa, sunucu yoğunluğu veya yavaş veritabanı yanıtları araştırılmalıdır. Paylaşımlı paketlerde komşu hesapların kaynak tüketimi de performansı etkileyebilir. Bu durumda hata aralıklı görünür; bazen test başarılı, bazen başarısız olabilir.

Sorunun eklenti veya tema kaynaklı olup olmadığını nasıl anlarsınız?

Önce yakın zamanda yapılan değişiklikler gözden geçirilmelidir. Yeni kurulan güvenlik, önbellek, üyelik, SEO veya form eklentileri REST API rotalarına müdahale edebilir. Test için eklentileri toplu şekilde kapatmak yerine, mümkünse staging ortamında tek tek devre dışı bırakmak daha sağlıklıdır.

Geçici olarak varsayılan bir WordPress temasına geçmek de faydalı bir kontroldür. Hata kayboluyorsa tema içindeki özel fonksiyonlar, yanlış yönlendirmeler veya kullanıcı yetkisi kontrolleri incelenmelidir.

Pratik teşhis adımları

İlk olarak tarayıcıda siteadiniz.com/wp-json/ adresini açın. JSON benzeri bir çıktı görmeniz beklenir. 403 görüyorsanız güvenlik engeli, 404 görüyorsanız kalıcı bağlantı veya yönlendirme, 500 görüyorsanız PHP hatası ya da sunucu yapılandırması ihtimali güçlenir.

Ardından WordPress hata ayıklama kaydını, sunucu hata loglarını ve güvenlik eklentisi kayıtlarını karşılaştırın. Aynı zaman damgasında oluşan kayıtlar, hangi katmanın isteği durdurduğunu anlamayı kolaylaştırır.

Destek ekibine hangi bilgileri iletmelisiniz?

Teknik destek talebi açarken yalnızca “REST API çalışmıyor” demek yerine hata metnini, saat bilgisini, test edilen URL’yi, alınan HTTP durum kodunu ve son yapılan değişiklikleri paylaşın. Bu bilgiler, destek ekibinin loglarda doğru kaydı bulmasını hızlandırır.

Eğer sorun hosting kaynaklı görünüyorsa, REST API endpoint’lerine gelen isteklerin güvenlik duvarı, ModSecurity veya rate limit tarafından engellenip engellenmediğini özellikle sorun. Böylece gereksiz eklenti silme, tema değiştirme veya veritabanı müdahalesi gibi riskli işlemlerden kaçınabilirsiniz.

Yanlış müdahalelerden kaçınmak neden önemlidir?

REST API hatasını gidermek için tüm güvenlik önlemlerini kapatmak, dosya izinlerini genişletmek veya çekirdek WordPress dosyalarını değiştirmek kalıcı risk yaratır. Daha doğru yaklaşım, hatanın hangi katmanda oluştuğunu belirlemek ve yalnızca ilgili ayarı düzeltmektir.

Kurumsal sitelerde bu uyarı erken ele alınmalıdır; çünkü blok editörü, WooCommerce işlemleri, entegrasyonlar ve otomatik görevler REST API’ye bağlı çalışabilir. Düzenli log takibi, güncel PHP kullanımı ve kontrollü eklenti yönetimi, aynı hatanın tekrar etme ihtimalini önemli ölçüde azaltır.