WordPress REST API Kullanım Rehberi: Özel Endpoint Oluşturma

Günümüz web ekosisteminde, farklı platformlar ve uygulamalar arasında kesintisiz veri iletişimi sağlamak modern yazılım geliştirmenin temel taşlarından biridir. İşte tam bu noktada, modern web dünyasının en güçlü araçlarından biri olan WordPress REST API devreye girmektedir. Geleneksel olarak WordPress, dinamik sayfalar oluşturmak için PHP tabanlı şablonlar kullanan monolitik bir yapıya sahipti. Ancak REST API entegrasyonu ile birlikte, bu popüler içerik yönetim sistemi artık sadece basit bir web sitesi altyapısı olmaktan çıkıp, her türlü harici platformla konuşabilen esnek bir veri merkezine dönüşmüştür. Bu rehberimizde, WordPress REST API sisteminin derinliklerine inecek, temel kavramları öğrenecek ve sitenize özel rotalar tanımlayarak projelerinizi nasıl bir üst seviyeye taşıyacağınızı detaylıca ele alacağız.

WordPress REST API Nedir?

WordPress REST API, sitenizin veritabanında yer alan gönderiler, sayfalar, kullanıcılar, kategoriler ve özel veri türleri (custom post types) gibi tüm bileşenlere HTTP protokolü üzerinden erişmenizi sağlayan bir uygulama programlama arayüzüdür. REST (Representational State Transfer) mimarisini kullanan bu sistem, verileri evrensel bir format olan JSON (JavaScript Object Notation) biçiminde döndürür. Bu sayede, sitenizin arka yüzünü WordPress ile yönetirken; ön yüzünü React, Vue, Angular gibi modern JavaScript kütüphaneleriyle veya Flutter, Swift ve Kotlin gibi mobil uygulama dilleriyle tamamen bağımsız olarak inşa edebilirsiniz.

WordPress, dünya genelindeki tüm web sitelerinin yaklaşık %43'üne güç vermektedir. Bu devasa ekosistemin REST API ile modern dünyaya entegre olması, geliştiricilere sınırsız bir özgürlük alanı sunar. API sayesinde, mevcut WordPress altyapınızı bozmadan sitenize mobil uygulamalar ekleyebilir, harici CRM sistemleriyle veri senkronizasyonu sağlayabilir veya tamamen özelleştirilmiş yönetim panelleri tasarlayabilirsiniz.

WordPress REST API Temel Kavramları

API ile çalışırken sıkça karşılaşacağınız ve sistemin temel mantığını kavramanıza yardımcı olacak bazı teknik terimler şunlardır:

• Routes (Rotalar): API üzerinden erişmek istediğiniz veri kümelerine giden benzersiz URL yollarıdır. Örneğin, /wp-json/wp/v2/posts ifadesi sitenizdeki yazılara erişmek için kullanılan standart bir rotadır.
• Endpoints (Uç Noktalar): Belirli bir rotaya yapılan ve belirli bir HTTP metodunu (GET, POST, PUT, DELETE) kullanan işlemlerdir. Örneğin, /wp-json/wp/v2/posts rotasına GET isteği gönderdiğinizde yazıları listelersiniz; aynı rotaya POST isteği gönderdiğinizde ise yeni bir yazı oluşturursunuz.
• Requests (İstekler): İstemci tarafından sunucuya gönderilen, parametreler, başlıklar (headers) ve gövde (body) verilerini içeren nesnelerdir.
• Responses (Yanıtlar): Sunucunun istemciye gönderdiği, genellikle JSON formatında olan ve işlem sonucunu içeren veri paketleridir.
• Schema (Şema): API yanıtlarının yapısını ve hangi alanların hangi veri tipinde döneceğini tanımlayan kurallar bütünüdür.

Tarayıcı Üzerinden İlk API İsteğini Gerçekleştirmek

WordPress REST API'yi test etmek son derece kolaydır. Herhangi bir kod yazmadan, sadece web tarayıcınızı kullanarak ilk API isteğinizi gerçekleştirebilirsiniz. Her WordPress sitesinin API arayüzü, site adresinin sonuna /wp-json/ eklenerek erişilebilir hale gelir.

Örneğin, resmi WordPress haber sitesinin API verilerine erişmek için tarayıcınızın adres çubuğuna şu URL'yi yazabilirsiniz:

https://wordpress.org/news/wp-json/wp/v2/posts

Bu adresi ziyaret ettiğinizde, sitede yayınlanan son yazıları içeren detaylı bir JSON çıktısı ile karşılaşırsınız. Bu çıktıyı daha okunaklı hale getirmek için tarayıcınıza bir JSON Viewer eklentisi kurabilir veya isteklerinizi test etmek için Postman gibi profesyonel araçları tercih edebilirsiniz.

Adım Adım Özel (Custom) Endpoint Oluşturma

Varsayılan olarak sunulan WordPress rotaları çoğu proje için yeterli olsa da, özel entegrasyonlarda sadece ihtiyacınız olan verileri içeren daha hızlı ve optimize edilmiş özel rotalara ihtiyaç duyabilirsiniz. WordPress geliştiricileri, bu gereksinimi karşılamak için register_rest_route fonksiyonunu kullanırlar.

Kendi özel rotanızı oluşturmak için aktif temanızın functions.php dosyasına veya geliştirmekte olduğunuz özel bir eklentiye şu PHP kodlarını ekleyebilirsiniz:

add_action( 'rest_api_init', function () {
    register_rest_route( 'webteknoloji/v1', '/son-yazilar/', array(
        'methods'             => 'GET',
        'callback'            => 'webteknoloji_son_yazilari_getir',
        'permission_callback' => '__return_true',
    ) );
} );

function webteknoloji_son_yazilari_getir( $request ) {
    $args = array(
        'post_type'      => 'post',
        'posts_per_page' => 5,
        'post_status'    => 'publish',
    );

    $posts = get_posts( $args );

    if ( empty( $posts ) ) {
        return new WP_Error( 'no_posts', 'Yazı bulunamadı', array( 'status' => 404 ) );
    }

    $data = array();
    foreach ( $posts as $post ) {
        $data[] = array(
            'id'     => $post->ID,
            'baslik' => $post->post_title,
            'link'   => get_permalink( $post->ID ),
        );
    }

    return new WP_REST_Response( $data, 200 );
}

Yukarıdaki kod bloğunu ekledikten sonra, tarayıcınızdan https://siteniz.com/wp-json/webteknoloji/v1/son-yazilar/ adresine gittiğinizde, sitenizdeki son 5 yazının sadece ID, başlık ve kalıcı bağlantı bilgilerini içeren son derece hafif ve hızlı bir JSON çıktısı alırsınız. permission_callback parametresini __return_true yaparak bu rotayı herkese açık hale getirdik; ancak hassas veriler için burada yetkilendirme kontrolleri yapılması şarttır.

WordPress REST API Güvenliği ve Kimlik Doğrulama

API üzerinden veri okumak genellikle herkese açık bir işlem olsa da, veri ekleme, düzenleme veya silme gibi kritik işlemler kesinlikle yetkilendirme gerektirir. WordPress REST API, güvenliği sağlamak için çeşitli kimlik doğrulama yöntemleri sunmaktadır:

1. Cookie (Çerez) Kimlik Doğrulaması

Eğer API isteklerini WordPress'in kendi ön yüzünde gerçekleştiriyorsanız, en pratik yöntem yerleşik çerez kimlik doğrulamasıdır. Bu yöntemde, CSRF (Cross-Site Request Forgery) saldırılarını engellemek için istek başlığına X-WP-Nonce parametresi eklenmelidir. WordPress, bu nonce değerini doğrulayarak isteğin güvenli bir oturumdan geldiğinden emin olur.

2. Uygulama Şifreleri (Application Passwords)

WordPress 5.6 sürümüyle birlikte çekirdeğe dahil edilen Uygulama Şifreleri, harici sistemlerin sitenize güvenli bir şekilde bağlanmasını sağlar. WordPress yönetim panelinizden her harici uygulama için özel, rastgele üretilmiş bir şifre tanımlayabilir ve bu şifreyi HTTP Basic Auth protokolüyle API isteklerinizde güvenle kullanabilirsiniz.

3. JWT (JSON Web Tokens) Entegrasyonu

Mobil uygulamalar ve modern tek sayfa uygulamaları (SPA) için en güvenli ve standart yöntem JWT kullanmaktır. İstek yapan kullanıcı, kullanıcı adı ve şifresiyle bir kez giriş yaptıktan sonra sunucudan şifrelenmiş bir token alır. Sonraki tüm API isteklerinde bu token başlıkta gönderilir. WordPress çekirdeğinde varsayılan olarak bulunmayan bu özelliği, popüler eklentiler vasıtasıyla sitenize hızlıca entegre edebilirsiniz.

REST API Performansını Optimize Etme Yolları

Her API isteği, WordPress çekirdeğinin, veritabanının ve aktif eklentilerin baştan yüklenmesine neden olur. Bu durum, yoğun trafik alan sitelerde sunucu kaynaklarının aşırı tüketilmesine yol açabilir. API performansınızı en üst düzeye çıkarmak için şu optimizasyon tekniklerini uygulamalısınız:

• API Yanıtlarını Önbelleğe Alın (Caching): API sorgularının her seferinde veritabanına gitmesini engellemek için Redis veya özel WP REST Cache eklentileri kullanarak yanıtları önbelleğe alabilirsiniz.
• Sadece İhtiyaç Duyulan Alanları Filtreleyin: API yanıtları varsayılan olarak çok fazla veri içerir. İsteklerinize _fields parametresini ekleyerek sadece ihtiyacınız olan alanları çekebilirsiniz. Örneğin, /wp-json/wp/v2/posts?_fields=id,title sorgusu sunucu yükünü ciddi oranda azaltır.
• Gereksiz Rotaları Kapatın: Kullanmadığınız veya dış dünyaya açmak istemediğiniz API rotalarını devre dışı bırakarak hem sunucu yükünü hafifletebilir hem de potansiyel güvenlik açıklarının önüne geçebilirsiniz.

Sonuç

WordPress REST API, geleneksel bir web sitesini modern, esnek ve ölçeklenebilir bir uygulama geliştirme platformuna dönüştürmektedir. API entegrasyonu sayesinde WordPress, sadece içerik girmek için kullanılan bir panel haline gelirken, kullanıcı deneyimini en son teknolojilerle şekillendirmenize olanak tanır. Güvenlik önlemlerini elden bırakmadan ve performans optimizasyonlarını doğru uygulayarak, WordPress altyapınızla geleceğin dijital projelerini bugünden inşa etmeye başlayabilirsiniz.