Wordpress API: Tam Geliştirici Rehberi

Bir WordPress sitesiyle programlı olarak etkileşime geçmesi gereken web uygulamaları, mobil uygulamalar veya ön uç istemciler geliştiriyorsanız, **WordPress API** temel aracınızdır. Doğru şekilde yapılandırılmış bir site ve WordPress (veya WordPress.com) tarafından sağlanan REST uç noktaları ile gönderileri alabilir, yeni içerik oluşturabilir, mevcut sayfaları düzenleyebilir, kullanıcıları, yorumları yönetebilir ve daha fazlasını standart HTTP istekleri aracılığıyla yapabilirsiniz. Bu kılavuz, WordPress API'ye nasıl başlayacağınızı, URL yapısının nasıl çalıştığını, CRUD işlemlerini nasıl gerçekleştireceğinizi ve her şeyi bir **tarayıcıda** veya **Apidog** gibi bir API aracı kullanarak nasıl test edeceğinizi anlatmaktadır.

💡

Harika API Dokümantasyonu oluşturan harika bir API Test aracı mı istiyorsunuz?

Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılar ve Postman'ın yerini çok daha uygun bir fiyata alır!

button

WordPress API'sine Başlarken

a) Hesap veya Site Kurulumu

Kendi kendine barındırılan bir WordPress sitesi (WordPress.org) kullanıyorsanız, sitenizin kurulu ve çalışır durumda olduğundan emin olun.

wordpress.org'da oturum açın/hesap oluşturun

Bir WordPress.com sitesiyle çalışıyorsanız, WordPress.com'da oturum açın ve site Kontrol Panelinizi bulun.

wordpress.com'da oturum açın/hesap oluşturun

REST API erişiminin etkin olduğundan emin olun — varsayılan olarak, modern WordPress kurulumları WP REST API'sini sitenizin-url'si/wp-json/ adresinde kullanıma sunar.

Siteye erişim (ve uygun izinler) dışında ek bir hesap oluşturmaya gerek yoktur — REST API, WordPress çekirdeğine yerleşiktir ve varsayılan olarak erişilebilirdir.

b) Temel URL Yapısını Anlamak

Kendi kendine barındırılan bir WordPress sitesi için temel API URL'si şudur:

https://your-site.com/wp-json/

Örneğin, gönderileri almak için şunları hedeflemeniz gerekir:

https://your-site.com/wp-json/wp/v2/posts

Kalıcı bağlantılar devre dışı bırakılırsa, WordPress API'yi yine de bir sorgu parametresi yedeği aracılığıyla sunabilir — ancak çoğu modern kurulumda, /wp-json/ kutudan çıkar çıkmaz çalışır.

WordPress.com barındırılan siteler (veya WordPress.com REST API'sini kullanan siteler) için, URL yapısı ad alanına ve site tanımlayıcısına bağlı olarak biraz farklılık gösterebilir. Örneğin:

https://public-api.wordpress.com/{namespace}/{version}/sites/{site_id}/...

Temel URL yapısı hakkında daha ayrıntılı bir kılavuz için WordPress Geliştirici Kaynakları'ndaki resmi belgelere göz atın.

WordPress REST API'sini Kullanma: CRUD İşlemleri

WordPress API'si, uygun HTTP yöntemini (POST, GET, PUT, DELETE) kullanarak tüm standart CRUD işlemlerini — Oluşturma, Okuma, Güncelleme, Silme — destekler. Bunları, tarayıcınızda veya Apidog kullanarak test edebileceğiniz somut örneklerle inceleyelim.

1. Oku: Gönderileri veya Sayfaları Alma

Gönderi listesini almak için:

GET https://your-site.com/wp-json/wp/v2/posts

Kimliğe göre tek bir gönderi almak için:

GET https://your-site.com/wp-json/wp/v2/posts/{id}

Sonuçları filtrelemek veya sayfalandırmak için sorgu parametreleri ekleyebilirsiniz — örneğin:

GET https://your-site.com/wp-json/wp/v2/posts?per_page=5&page=2

GET https://your-site.com/wp-json/wp/v2/posts?status=draft

Yük boyutunu azaltmak ve performansı artırmak için _fields sorgu parametresini (örneğin, ? _fields=id,title,excerpt,link) kullanarak hangi alanların döndürüleceğini de kontrol edebilirsiniz.

Aynı durum, sitenizin sunduklarına bağlı olarak sayfalar (/wp-json/wp/v2/pages aracılığıyla) veya medya, yorumlar gibi diğer kaynak türleri için de geçerlidir.

2. Oluştur: Yeni Bir Gönderi Ekleme

Kimliği doğrulanmış (yönetici veya izinleri olan bir kullanıcı olarak) iseniz, yeni bir gönderi oluşturabilirsiniz:

POST https://your-site.com/wp-json/wp/v2/posts

Örneğin, bir JSON gövdesi ile:

{
  "title": "My New API Post",
  "content": "This post was created via the WordPress API.",
  "status": "publish"
}

Bu istek yeni bir gönderi oluşturacaktır. İsteğe bağlı olarak, hemen yayınlamak istemiyorsanız durumu "draft" veya diğer geçerli durumlara ayarlayabilirsiniz.

3. Güncelle: Mevcut Bir Gönderiyi Düzenleme

Kimliğe göre bir gönderiyi güncellemek için (örn. başlığını veya içeriğini güncellemek):

PUT https://your-site.com/wp-json/wp/v2/posts/{id}

Gövde örneği:

{
  "title": "Updated Title via API",
  "content": "Updated content from API."
}

Alternatif olarak, bazı uygulamalar PATCH yöntemini kabul eder. Başarılı bir isteğin ardından, API güncellenmiş gönderi nesnesiyle yanıt verir.

4. Sil: Bir Gönderiyi Kaldırma

Kimliğe göre bir gönderiyi silmek için:

DELETE https://your-site.com/wp-json/wp/v2/posts/{id}

Varsayılan olarak, bu genellikle gönderiyi Çöp Kutusu'na taşır (eğer çöp kutusu etkinse). Destekleniyorsa, kalıcı olarak silmek için parametreler ekleyebilirsiniz (site yapılandırmasına bağlı olarak).

WordPress API'sini Kullanırken Kimlik Doğrulama ve Güvenlik Hususları

Genel veriler (örn. yayınlanmış gönderiler) genellikle kimlik doğrulama olmadan alınabilir.
İçerik oluşturmak, güncellemek veya silmek için genellikle WordPress giriş çerezleri, Uygulama Şifreleri (WP 5.6'dan beri mevcut) veya OAuth / jeton tabanlı sistemler aracılığıyla kimlik doğrulama gerekir.
Kimlik bilgilerini ve iletilen verileri korumak için üretimde her zaman HTTPS kullanın.

WordPress API Uç Noktalarını Test Etme (Tarayıcı veya Apidog)

Uç noktaları bir tarayıcı veya Apidog gibi bir API test aracı kullanarak kolayca test edebilirsiniz.

Tarayıcı Kullanımı:

URL'yi (örn. .../wp-json/wp/v2/posts) tarayıcının adres çubuğuna yapıştırın.
Tarayıcı ham JSON gösterecektir — okunabilir hale getirmek için bir JSON biçimlendirici uzantısı yükleyin (örn. Chrome, Firefox için JSON Formatter).

wordpress api uç noktalarını test etmek için tarayıcıyı kullanma

Apidog Kullanımı:

Apidog'da yeni bir API uç noktası oluşturun.
URL'yi girin (örn. /wp-json/wp/v2/posts).
HTTP yöntemini seçin (GET, POST, PUT, DELETE).
Gerekirse başlıkları ekleyin (kimlik doğrulama için).

kimlik doğrulama için apidog'da özel başlıklar ekle

İsteği gönderin ve JSON yanıtını inceleyin — Apidog yapılandırılmış JSON'u, hataları, yanıt başlıklarını gösterir ve ham tarayıcı çıktılarından daha kolay hata ayıklama sağlar.

apidog ile wordpress api uç noktalarını test etme

Bu yöntem, özellikle POST/PUT/DELETE istekleri için kullanışlıdır — tarayıcı yalnızca JSON istek gövdelerini veya özel başlıkları göndermek için kolay bir yola sahip değildir.

WordPress API'sini Kullanan Geliştiriciler İçin En İyi Uygulamalar ve İpuçları

Çok fazla veri alırken yük boyutunu sınırlamak için _fields veya sayfalama parametrelerini kullanın.
Yazma işlemleri için Uygulama Şifreleri veya OAuth kullanarak güvenli bir şekilde kimlik doğrulayın.
Site kalıcı bağlantı ayarlarını kontrol edin — güzel kalıcı bağlantıların veya yedek REST rotalarının (wp-json/) çalıştığından emin olun.
İzinleri yönetin — yalnızca uygun rollere sahip kullanıcılar içerik oluşturabilir veya silebilir.
Hız sınırlama ve hata yönetimi — API hatalarını zarif bir şekilde ele alın ve sunucu kaynaklarına saygı gösterin.
Tarayıcıda test yaparken okunabilirlik veya hata ayıklama için JSON biçimlendirme araçları kullanın.

Sıkça Sorulan Sorular (SSS)

S1. WordPress API'sini kullanmak için her zaman bir API anahtarına ihtiyacım var mı?
Hayır — yayınlanmış gönderiler veya genel sayfalar gibi herkese açık veriler için kimlik doğrulama olmadan GET istekleri kullanabilirsiniz. Ancak, içerik oluşturmak, düzenlemek veya silmek için genellikle uygun kimlik bilgilerine ihtiyacınız vardır. (Bu konu hakkında daha fazla bilgi için WPZOOM'u inceleyin)

S2. wp-json/wp/v2/ ve public-api.wordpress.com uç noktaları arasındaki fark nedir?
wp-json/wp/v2/ kendi kendine barındırılan WordPress siteleri (WordPress.org) tarafından kullanılır. public-api.wordpress.com/... yapısı WordPress.com tarafından barındırılan siteler tarafından kullanılır — temel URL ve ad alanları farklılık gösterir, ancak REST API kavramı benzer kalır. (Daha fazla örnek için Noroff FEU İçerik Sistemine bakın)

S3. API'de özel uç noktalar oluşturabilir veya özel gönderi türlerini ifşa edebilir miyim?
Evet. Varsayılan olarak, çekirdek gönderi türleri (gönderiler, sayfalar, medya, yorumlar vb.) kullanıma sunulur. Özel gönderi türleri veya özel alanlar (meta veriler) için temanızda veya eklentinizde REST desteğini kaydetmeniz gerekebilir (örn. register_post_type(..., 'show_in_rest' => true) kullanarak).

S4. Kod yazmadan API uç noktalarını nasıl test edebilirim?
Bir tarayıcı kullanabilirsiniz (GET istekleri için) — sadece uç nokta URL'sine gidin. POST/PUT/DELETE (veya kimlik doğrulama gerektiren işlemler) için Apidog gibi bir API istemci aracı kullanın. JSON gövdeleri göndermenize, başlıklar ayarlamanıza ve yanıtları rahatça incelemenize olanak tanır.

S5. Kullanıcı veya yorum verilerini API aracılığıyla ifşa etmek güvenli midir?
Siteniz belirli kaynaklara (genel olarak görülebilir gönderiler veya yorumlar gibi) halka açık erişime izin veriyorsa, evet — API yalnızca izin verilenleri döndürür. Özel veriler veya kimliği doğrulanmış işlemler için, uygun kimlik doğrulama ve izinlerin olduğundan emin olun.

Sonuç

**WordPress API**, WordPress sitenizi programlanabilir bir arka uca dönüştürür — standart HTTP çağrıları aracılığıyla içerik okumanıza, oluşturmanıza, güncellemenize ve silmenize olanak tanır. İster başlıksız bir CMS ön ucu, ister bir mobil uygulama geliştiriyor olun, ister içerik iş akışlarını otomatikleştiriyor olun, REST API size sağlam, esnek bir arayüz sunar.

URL yapısını, çekirdek uç noktalarını, CRUD anlambilimini, kimlik doğrulamayı ve test metodolojisini (tarayıcı veya Apidog aracılığıyla) anlayarak, WordPress'i neredeyse herhangi bir harici sistemle entegre edebilirsiniz. İyi API uygulamaları — güvenli kimlik doğrulama, verimli sorgular ve uygun işleme — ile WordPress bir blog platformundan daha fazlası haline gelir — tam özellikli bir içerik arka ucu haline gelir.

💡

button