İçeriğe geç

WordPress REST API için temel ayarlar nasıl yapılır?

WordPress REST API için Temel Ayarlar Nasıl Yapılır?

WordPress dünyasının belki de en heyecan verici yönlerinden biri, REST API sayesinde sitenizi sadece bir blogdan çıkarıp modern web uygulamalarına dönüştürebilmenizdir. Peki, WordPress REST API hakkında temel ayarları nasıl yapabilirsiniz? Kafa karıştıran geliştirici dökümanlarına gömülmeden, sade ve anlaşılır bir şekilde bu süreci birlikte öğrenelim.

REST API Nedir? Kısaca Tanıyalım

Önce küçük bir özet geçelim: REST API, WordPress’in dışarıya veri sunmasına ve dışarıdan veri almasına yarayan bir “köprü”dür. Modern web projelerinde WordPress’ten haberler, ürünler, sayfalar veya kullanıcılar gibi verilere harici uygulamalarla erişmek istiyorsanız, REST API tam da bunun için harika bir çözümdür.

Neden WordPress REST API Kullanmalısınız?

  • Veri Paylaşımı: Farklı platformlar arasında kolayca veri alışverişi sağlar.
  • Modern web uygulamaları: React veya Vue.js gibi JavaScript framework’leriyle güçlü, hızlı web siteleri geliştirebilirsiniz.
  • Mobil Uyumlu: Mobil uygulamalarınızda WordPress verilerini hızlıca kullanabilirsiniz.
  • Otomasyon ve Entegrasyon: Farklı servislerle entegrasyonu kolaylaştırır.

WordPress REST API’yi Etkinleştirmek İçin Gereken Temel Ayarlar

REST API, WordPress 4.7’den beri çekirdekte hazır olarak bulunuyor. Yani ekstra bir eklenti yüklemeden doğrudan kullanılabiliyor. Ancak birkaç temel ayar ve güvenlik önlemiyle verimli ve güvenli kullanım sağlayabilirsiniz.

1. Kalıcı Bağlantıları (Permalink) Aktif Edin

REST API’nin düzgün çalışabilmesi için WordPress’in kalıcı bağlantılarının (permalink) etkin olması gerekir.

  • WordPress yönetici panelinden Ayarlar > Kalıcı Bağlantılar sekmesine gidin.
  • Yazı ismi veya benzeri bir yapı seçip ayarları kaydedin.

Artık REST API son noktaları (endpoints) düzgün şekilde çalışacaktır.

2. Temel REST API Testi: Beni Duyuyor Musun?

REST API etkin mi diye merak ediyorsanız, tarayıcınıza şunu girmeniz yeterli:

  • https://siteadresiniz.com/wp-json/

Karşınıza sitenizin JSON formatında özet bilgileri geldiyse başarıyla etkinleştirdiniz!

3. Uygun Kullanıcı Rollerini ve Haklarını Ayarlayın

REST API ile veriye ister herkese açık (örn. yazılar, sayfalar), ister yetkili kullanıcıya özel (örn. özel yazılar, kullanıcı bilgileri) erişebilirsiniz.

Bazı son noktalara (örn. yazı ekleme, silme, güncelleme) erişmek için kullanıcı kimlik doğrulaması gerekir. Burada, kullanıcı rollerinin doğru ayarlandığından emin olun.

  • Hangi rol hangi verilere erişebiliyor? (Editörler, katkıcılar, aboneler…)
  • REST API ile yetkisiz kullanıcıların bilgi çekmesini veya değiştirmesini istemiyorsanız, uygun yetkilendirme ayarlarını kontrol edin.

4. REST API Güvenliğini Sağlayın

Açık bir API, kötü niyetli kişiler için de cazip olabilir. Güvenlik her zaman önceliğiniz olsun! İşte sık kullanılan bazı güvenlik yöntemleri:

  • Kısıtlama: wp-json/wp/v2/users gibi hassas noktaları limitleyin ya da engelleyin.
  • API anahtarı, JWT, OAuth gibi yöntemlerle doğrulama sağlayın.
  • İzinleri en düşük seviyede tutun.

5. Gelişmiş Özelleştirme: Kendi API Son Noktalarınızı Oluşturmak

WordPress, yalnızca dahili verileri paylaşmakla kalmaz; temanız veya eklentiniz için özel API uç noktaları (endpoint) eklemenize de izin verir. Bunun için register_rest_route() fonksiyonunu kullanabilirsiniz.

Common REST API Endpoint’ları ve Açıklamaları
Endpoint Açıklama Kullanıcı Yetkilendirmesi
/wp-json/wp/v2/posts Tüm yazıları listeler. Gerekmez
/wp-json/wp/v2/pages Sitedeki sayfaları listeler. Gerekmez
/wp-json/wp/v2/users Kullanıcı listesini döndürür. Yetki gerekir (varsayılan, sadece admin görebilir)
/wp-json/wp/v2/comments Yorumları listeler. Gerekmez
/wp-json/wp/v2/media Medya dosyalarını getirir. Gerekmez

Sık Karşılaşılan Sorular ve Çözümleri

  • API çalışmıyor, hata veriyor ne yapmalıyım?
    Önce permalink ayarlarınızı tekrar kaydedin. Bazı güvenlik eklentileri REST API’yi otomatik devre dışı bırakabilir; eklenti ayarlarını kontrol edin.
  • Kendi endpoint’imi yazdım ama erişemiyorum.
    Yol tanımlarında hata yapmış olabilirsiniz veya register_rest_route() fonksiyonunuzu doğru bağlayıp bağlamadığınızı kontrol edin.
  • Kullanıcı bilgileri herkes tarafından görülüyor, nasıl gizlerim?
    Kod veya eklentiyle /wp-json/wp/v2/users endpoint’ini tamamen veya misafirler için gizleyebilirsiniz.

Sonuç: Birkaç Adımla Modernleşen WordPress

Gördüğünüz gibi, WordPress REST API temel ayarları oldukça erişilebilir ve hızlıca uygulanabilir durumda. Artık WordPress’inizi sadece klasik bir içerik sistemi olarak değil, modern uygulamalarla güçlü şekilde entegre olan bir platform olarak kullanabilirsiniz.

Korkmanıza gerek yok! Biraz pratik ve dikkat ile REST API sizin de projelerinize yepyeni bir soluk getirecek. Sormak istedikleriniz veya yaşadığınız sıkıntılar için yorum yapabilirsiniz. Kolay gelsin!

Yazı konuları