Node.js ve WordPress ile Dinamik API Nasıl Oluşturulur

Node.js ve WordPress ile dinamik API oluşturmayı öğrenin. REST API bağlantısı, gönderi yönetimi, kimlik doğrulama ve yorum işlemlerinin adımlarını keşfedin.

WordPress sitenizdeki içerikleri farklı bir uygulamadan yönetmek istediğinizde, yönetim paneline sürekli giriş yapmak pek kullanışlı olmayabilir. Özellikle birden fazla platformda çalışan projelerde yazıları güncellemek, yorumları kontrol etmek ve verileri tek ekranda toplamak zaman alır. Node.js ve WordPress birlikte kullanıldığında bu işlemlerin önemli bir bölümü otomatikleştirilebilir.

İki sistemin farklı teknolojilerle geliştirilmiş olması iletişim kurmalarını engellemez. WordPress, PHP tabanlı yapısıyla içerikleri yönetirken Node.js, JavaScript kodlarını sunucu tarafında çalıştırır. Aralarındaki veri alışverişini ise WordPress REST API sağlar. Böylece mevcut sitenizi değiştirmeden kendi uygulamanız üzerinden içerik yönetimi gerçekleştirebilirsiniz.

Node.js yalnızca web siteleri geliştirmek için kullanılmaz. Veri işleme, otomasyon ve farklı servisler arasında iletişim kurma gibi görevlerde de değerlendirilebilir. Bu kullanım alanlarını daha yakından tanımak isterseniz Node.js Uygulama Türleri: En Yaygın 10 Kullanım Alanı başlıklı içeriğe göz atabilirsiniz. Buradaki örneklerin birçoğu WordPress entegrasyonlarıyla da ilişkilidir.

Node.js ve WordPress ile Dinamik API Nasıl Çalışır?

Node.js ve WordPress ile dinamik API oluşturmak için WordPress REST API uç noktalarından yararlanılır. Node.js üzerinde geliştirilen Express sunucusu, HTTP isteklerini WordPress’e iletir ve dönen JSON verilerini işler. Bu yapı sayesinde içerik oluşturma, gönderi güncelleme, yorum yönetimi ve yetkilendirilmiş kullanıcı işlemleri ayrı bir uygulamadan gerçekleştirilebilir.

WordPress REST API, içeriklere belirli adresler üzerinden erişilmesini sağlar. Örneğin aşağıdaki adres, erişime açık gönderilerin listesini JSON biçiminde döndürür:

https://siteadresiniz.com/wp-json/wp/v2/posts

İstek sonucunda gönderilerin başlıkları, içerikleri, tarihleri ve diğer kullanılabilir alanları alınabilir. Kullanıcıya gösterilecek bilgiler daha sonra Node.js üzerinde işlenebilir.

Bu yaklaşım özellikle özel yönetim panelleri, mobil uygulamalar ve birden fazla kaynaktan bilgi toplayan sistemler için kullanışlıdır.

Node.js ve WordPress API Kurulumu

Başlamadan önce bilgisayarınızda Node.js ve npm kurulu olmalıdır. Ayrıca REST API erişimi bulunan bir WordPress sitesi ve kodları düzenleyebileceğiniz Visual Studio Code gibi bir editör gerekir.

1. Node.js Projesini Hazırlayın

Terminalde yeni bir klasör oluşturun ve içerisine geçin. Ardından aşağıdaki komutları çalıştırın:

npm init -y
npm install express axios dotenv

Burada Express sunucu oluşturmak, Axios HTTP isteklerini göndermek, dotenv ise yapılandırma bilgilerini ortam değişkenlerinden okumak için kullanılır.

2. WordPress API Bağlantısını Oluşturun

Proje klasöründe app.js isimli bir dosya hazırlayın. Basit bir bağlantı örneği şu şekildedir:

const express = require('express');
const axios = require('axios');

const app = express();
app.use(express.json());

const api = 'https://siteadresiniz.com/wp-json/wp/v2';

app.get('/posts', async (req, res) => {
  try {
    const response = await axios.get(`${api}/posts`);
    res.json(response.data);
  } catch (error) {
    res.status(502).json({ error: 'Veriler alinamadi' });
  }
});

app.listen(3000);

Dosyayı kaydettikten sonra node app.js komutunu çalıştırın. Tarayıcıda http://localhost:3000/posts adresini açarak sonuçları inceleyebilirsiniz.

Bu örnek yalnızca herkese açık gönderileri getirir. İçerik değiştiren işlemler için ayrıca kimlik doğrulaması gerekir.

3. WordPress Kimlik Doğrulamasını Ayarlayın

2026 itibarıyla WordPress, harici uygulamaların bağlanabilmesi için Uygulama Parolaları özelliğini desteklemektedir.

WordPress panelinde Kullanıcılar > Profil bölümüne gidin. Uygulama Parolaları alanından yeni bir parola oluşturun.

Bu bilgileri Node.js tarafında .env dosyasında saklayabilirsiniz:

WP_USER=kullanici_adi
WP_APP_PASSWORD=uygulama_parolasi

Parolayı kaynak kodun içine yazmayın veya herkese açık bir depoya yüklemeyin. Bağlantının HTTPS üzerinden kurulması da önemlidir.

WordPress Gönderileri Node.js ile Nasıl Yönetilir?

Node.js ve WordPress ile dinamik API geliştirmenin temel kullanım alanlarından biri gönderilerin yönetilmesidir.

Yeni Gönderi Oluşturma

WordPress üzerinde yeni bir içerik oluşturmak için /wp/v2/posts adresine POST isteği gönderilir. İstek gövdesinde title, content ve status gibi alanlar bulunur.

Örneğin status değerinin draft olması içeriği taslak olarak kaydeder. publish ise gerekli yayınlama yetkisi bulunduğunda gönderiyi yayımlar.

Gönderi Güncelleme ve Silme

Mevcut bir içeriği düzenlemek için gönderinin benzersiz kimliği kullanılır.

Örnekteki 15 değeri gönderinin kimliğidir. Silme isteği normal koşullarda içeriği çöp kutusuna taşır. force=true parametresi ise kalıcı silme amacıyla kullanılır.

İçerik değiştiren isteklerin, uygun yetkilere sahip WordPress hesabıyla doğrulanması gerekir. Node.js uç noktalarının da yetkisiz kullanıma kapatılması önemlidir.

Node.js ile WordPress Yorumları Yönetilebilir mi?

WordPress REST API yalnızca gönderilerle sınırlı değildir. /wp/v2/comments uç noktası üzerinden yorumlar listelenebilir, oluşturulabilir veya gerekli izinlerle düzenlenebilir.

Örneğin belirli ifadeleri içeren yorumların uygulama tarafından gönderilmesini engellemek için kontrol eklenebilir:

const yasakliIfade = /follow me/i;

if (yasakliIfade.test(yorum)) {
  return res.status(400).json({
    error: 'Yorum uygun degil'
  });
}

Bu kontrol, Node.js uygulamasından geçen yorumları filtreler. WordPress’e doğrudan gönderilen yorumları denetlemek için ayrıca WordPress tarafında moderasyon kuralları uygulanmalıdır.

Kullanıcıya Özel İçerik ve Yönetim Paneli

Node.js ve WordPress entegrasyonu, ziyaretçilerin tercihlerine göre içerik sunmak için de kullanılabilir.

Örneğin uygulama, kullanıcının seçtiği dili güvenli bir çerezde saklayabilir. WordPress üzerinde ilgili dilde içerikler hazırlanmışsa uygulama uygun gönderileri isteyebilir.

Benzer şekilde özel bir yönetim panelinde kullanıcılar ve yetkiler görüntülenebilir. Ancak kullanıcı rollerini değiştirme gibi hassas işlemler yalnızca gerekli yetkiye sahip hesaplarla gerçekleştirilmelidir.

API Adreslerindeki Küçük Farklara Dikkat

Resmi WordPress REST API tanımlarını incelediğimde özellikle gönderi oluşturma ve güncelleme adreslerinin kolayca karıştırılabileceğini fark ettim. Yeni içerik oluştururken /posts kullanılırken mevcut bir gönderi düzenlenirken adresin sonuna gönderi kimliği ekleniyor. Bu ayrım, hatalı istekleri araştırırken ilk kontrol edilmesi gereken ayrıntılardan biridir.

Ayrıca HTTP yanıt kodları ve hata gövdeleri incelenmeden yalnızca sunucu konsolundaki mesajlara güvenilmemelidir.

Teknik Destek Gerektiğinde Ne Yapılabilir?

Node.js ve WordPress bağlantısı kurulurken bilgisayar yapılandırması, yazılım kurulumu veya bağlantı kaynaklı sorunlarla karşılaşılabilir. Bu tür teknik ihtiyaçlarda 11858, 2011 yılından bu yana Türkiye genelinde 7/24 destek sunmaktadır.

Bilgisayar, akıllı TV, sosyal medya ve modem kurulumu gibi alanlarda hizmet veren 11858, TeamViewer ve AnyDesk gibi lisanslı yazılımlarla uzaktan destek sağlar. Dakika bazlı şeffaf ücretlendirme uygulayan hizmet, yüzde 95 memnuniyet oranı ve 500.000’den fazla başarılı işlem deneyimiyle faaliyet göstermektedir.

API bağlantılarında kimlik doğrulamasının önemi, farklı dijital hizmetlerin hesap güvenliği süreçlerinde de kendini gösterir. Özellikle eski doğrulama sistemlerinden yeni yöntemlere geçerken doğru adımları takip etmek gerekir. Bunun farklı bir örneğini Knight Online OTP+ Geçişi: Eski OTP’den 6 Adımda Nasıl Geçilir başlıklı içerikte bulabilirsiniz.

Node.js ve WordPress ile geliştirilen bir API’nin gerçek değeri, yalnızca veri aktarabilmesinde değil, günlük yönetim işlemlerini ne kadar kontrollü gerçekleştirdiğinde ortaya çıkar. Siz WordPress sitenizde hangi işlemleri otomatikleştirmek isterdiniz? Deneyimlerinizi ve karşılaştığınız sorunları yorumlarda paylaşabilirsiniz.