Namespace dan versi

Teks ini diterjemahkan menggunakan AI. Jika Anda ingin melihat teks asli dalam bahasa Inggris, klik di sini.

REST API WordPress.com disusun ke dalam tiga namespace berbeda, masing-masing memiliki tujuan khusus dan mengikuti skema versi yang independen. Memahami namespace ini penting untuk memilih endpoint yang tepat bagi integrasi Anda dan memastikan kompatibilitas dengan WordPress.com maupun situs WordPress yang di-hosting sendiri.

Ikhtisar Namespace API

REST API WordPress.com menyediakan tiga namespace utama, masing-masing ditujukan untuk kasus penggunaan dan tingkat kompatibilitas yang berbeda:

Namespace	Versi yang Tersedia	Tujuan Utama	Kompatibel dengan WordPress Core
/rest/	v1, v1.1, v1.2, v1.3, v1.4	Fitur manajemen dan platform WordPress.com lama	Tidak
/wp/	v2	Resource standar WordPress core yang mengikuti spesifikasi resmi REST API	Ya
/wpcom/	v2, v3, v4	Fitur dan layanan modern khusus WordPress.com	Tidak

Namespace /rest/ – API WordPress.com Lama

Namespace /rest/ mewakili REST API WordPress.com asli, yang hadir sebelum REST API WordPress core. Namespace ini menyediakan akses menyeluruh ke fitur platform WordPress.com dan kemampuan pengelolaan situs.

Versi yang Tersedia: v1, v1.1, v1.2, v1.3, v1.4 (diakses melalui opsi WP.COM API di Konsol API)

URL Dasar:

• https://public-api.wordpress.com/rest/v1/
• https://public-api.wordpress.com/rest/v1.1/
• https://public-api.wordpress.com/rest/v1.2/
• https://public-api.wordpress.com/rest/v1.3/
• https://public-api.wordpress.com/rest/v1.4/

Fitur Utama:

• Pengelolaan situs dan pengguna yang komprehensif
• Fitur khusus WordPress.com seperti Statistik, Pembaca, dan Pemberitahuan
• Konfigurasi situs lanjutan dan pengelolaan domain
• Kemampuan integrasi Jetpack

Strategi Pembuatan Versi: Setiap versi (v1.1–v1.4) memperkenalkan peningkatan bertahap, endpoint baru, dan fungsionalitas yang disempurnakan sambil tetap mempertahankan kompatibilitas mundur. Saat endpoint tersedia di beberapa versi, versi yang lebih baru biasanya menawarkan kolom tambahan, performa yang lebih baik, atau perbaikan bug.

Paling Sesuai Digunakan Untuk:

• Mengakses fitur khusus WordPress.com yang tidak tersedia di tempat lain
• Pengelolaan dan konfigurasi situs lanjutan
• Mempertahankan kompatibilitas dengan integrasi yang sudah ada
• Fitur seperti statistik terperinci, fungsionalitas Pembaca, dan pengelolaan domain

Contoh Endpoint:

• /rest/v1.4/sites/{site}/posts
• /rest/v1.4/sites/{site}/stats
• /rest/v1.4/me/sites
• /rest/v1.3/read/following

/wp/ Namespace – REST API Inti WordPress

Namespace /wp/ menerapkan spesifikasi WordPress REST API resmi, sehingga memastikan kompatibilitas penuh dengan situs WordPress.com maupun situs WordPress yang di-hosting sendiri. Namespace ini mengikuti standar yang ditetapkan oleh tim inti WordPress.

Versi yang Tersedia: v2 (diakses melalui opsi WP REST API di API Console)

URL Dasar: https://public-api.wordpress.com/wp/v2/

Fitur Utama:

• Sumber daya WordPress standar (pos, halaman, komentar, taksonomi, pengguna, media)
• Kompatibilitas penuh dengan situs WordPress yang di-host sendiri
• Struktur endpoint yang konsisten sesuai standar inti WordPress
• Dapat diperluas melalui plugin di situs yang di-host sendiri

Filosofi Desain: Namespace ini memprioritaskan standardisasi dan kompatibilitas dibanding fitur khusus WordPress.com. Namespace ini mencerminkan REST API yang tersedia di instalasi WordPress mana pun, sehingga ideal untuk aplikasi yang perlu berfungsi di berbagai lingkungan WordPress.

Paling Cocok Digunakan Untuk:

• Proyek baru yang memerlukan fungsionalitas inti WordPress
• Aplikasi yang harus berfungsi dengan WordPress.com dan situs yang di-host sendiri
• Manajemen konten standar (pos, halaman, media, pengguna)
• Integrasi dengan alat dan plugin WordPress yang sudah ada

Contoh Endpoint:

• /wp/v2/posts
• /wp/v2/pages
• /wp/v2/users
• /wp/v2/media
• /wp/v2/sites/{site}/posts

/wpcom/ Namespace – API Platform WordPress.com Modern

Namespace /wpcom/ mewakili evolusi fungsi API khusus WordPress.com, dengan pola desain modern dan fitur platform tingkat lanjut yang tidak tersedia di inti WordPress.

Versi yang Tersedia: v2, v3, v4 (diakses melalui opsi WP REST API di API Console)

URL Dasar:

• https://public-api.wordpress.com/wpcom/v2/
• https://public-api.wordpress.com/wpcom/v3/
• https://public-api.wordpress.com/wpcom/v4/

Fitur Utama:

• Desain API modern dengan struktur dan performa yang lebih baik
• Layanan WordPress.com tingkat lanjut (Pembaca, Statistik yang ditingkatkan, Pemberitahuan)
• Fitur keterlibatan pengguna (mengikuti, suka, rekomendasi)
• Fungsi khusus platform tidak tersedia di WordPress yang di-hosting sendiri

Strategi Pembuatan Versi: Setiap versi memperkenalkan kemampuan baru, peningkatan keamanan, dan struktur data yang disempurnakan. Berbeda dengan namespace /rest/, /wpcom/ berfokus pada fungsi yang berorientasi ke masa depan, bukan kompatibilitas lama.

Paling Cocok Digunakan Untuk:

• Fitur platform WordPress.com modern
• Keterlibatan pengguna dan fitur sosial
• Analitik dan rekomendasi tingkat lanjut
• Integrasi baru yang memerlukan kemampuan WordPress.com terbaru

Contoh Endpoint:

• /wpcom/v4/me/follows
• /wpcom/v3/notifications
• /wpcom/v2/read/tags
• /wpcom/v4/sites/{site}/stats/insights

Memilih Namespace yang Tepat

Pilihan namespace bergantung pada persyaratan spesifik dan kebutuhan kompatibilitas Anda:

Gunakan /wp/v2/ saat Anda membutuhkan Fungsionalitas WordPress Standar seperti:

• Fitur inti WordPress (pos, halaman, pengguna, media)
• Kompatibilitas dengan situs WordPress yang dihosting sendiri
• Pola dan struktur REST API standar
• Integrasi dengan alat dan plugin WordPress yang sudah ada

Gunakan /wpcom/v4/ (atau versi terbaru yang tersedia) saat Anda membutuhkan Fitur Platform WordPress.com seperti:

• Layanan WordPress.com lanjutan dan fitur sosial
• Desain API modern dan performa yang lebih baik
• Kemampuan dan integrasi platform terbaru
• Fitur yang unik untuk ekosistem WordPress.com

Gunakan /rest/v1.4/ (atau versi yang diperlukan) saat Anda membutuhkan Fitur dan Kompatibilitas Lama seperti:

• Fungsionalitas tertentu hanya tersedia di endpoint lama
• Kompatibilitas mundur dengan integrasi yang sudah ada
• Fitur manajemen situs lanjutan yang belum dimigrasikan ke namespace yang lebih baru
• Kemampuan statistik dan analitik yang komprehensif

Panduan Pemilihan Versi

Dalam setiap namespace, pemilihan versi mengikuti prinsip-prinsip berikut:

Tersedia Beberapa Versi: Jika endpoint tersedia di beberapa versi, versi yang lebih baru biasanya menyediakan:

• Kolom dan parameter respons tambahan
• Performa dan keandalan yang lebih baik
• Perbaikan bug dan peningkatan keamanan
• Fungsionalitas yang ditingkatkan dengan tetap mempertahankan kompatibilitas mundur

Pendekatan yang Disarankan: Selalu gunakan versi terbaru yang tersedia, kecuali:

• Integrasi Anda bergantung pada perilaku tertentu di versi yang lebih lama
• Anda memelihara kode lama yang memerlukan respons API tertentu
• Persyaratan kompatibilitas mengharuskan penggunaan versi tertentu

Memahami Pengelolaan API Console

WordPress.com API Console mengelompokkan namespace ke dalam dua kategori utama:

• WP.COM API: Berisi semua versi namespace /rest/ (v1–v1.4)
• WP REST API: Berisi /wp/v2/ dan semua versi namespace /wpcom/ (v2–v4)

Pengelompokan ini mencerminkan evolusi dari API khusus WordPress.com menjadi API inti WordPress yang terstandardisasi dan fitur platform modern.

Pertimbangan Migrasi

Saat merencanakan integrasi atau memperbarui integrasi yang sudah ada:

Proyek Baru: Mulailah dengan /wp/v2/ untuk fungsionalitas inti dan /wpcom/v4/ untuk fitur khusus platform.

Integrasi yang Ada: Pertimbangkan untuk bermigrasi dari endpoint /rest/ ke namespace yang lebih baru saat:

• Fungsionalitas yang setara tersedia di /wp/v2/ atau /wpcom/
• Anda membutuhkan performa yang lebih baik atau fitur tambahan
• Pemeliharaan dan dukungan jangka panjang menjadi prioritas

Ketersediaan Fitur: Beberapa fitur lanjutan tetap eksklusif untuk namespace /rest/. Evaluasi persyaratan fitur sebelum migrasi untuk memastikan semua fungsionalitas yang diperlukan tersedia di namespace tujuan.