WordPress REST API adalah antarmuka yang memungkinkan aplikasi di luar WordPress membaca dan menulis konten situs Anda dengan mengirim permintaan HTTP dan menerima data dalam format JSON. Bagi publisher, ini bukan sekadar alat pengembang: REST API adalah fondasi editor blok yang Anda pakai setiap hari, sekaligus pintu untuk otomasi yang masuk akal — mengambil daftar artikel, membuat draf dari sistem lain, mengunggah media, atau membangun dasbor editorial sendiri. Artikel ini menjelaskan cara kerjanya dari nol, cara autentikasi yang benar dengan Application Password, contoh permintaan pertama yang bisa Anda coba, serta batasan keamanan dan kualitas konten yang wajib dijaga agar otomasi membantu, bukan merusak situs Anda.
- Poin Kunci
- Daftar Isi
- Apa Itu WordPress REST API dan Mengapa Publisher Perlu Memahaminya
- REST API bukan XML-RPC dan bukan sekadar “fitur pengembang”
- Bagaimana REST API berhubungan dengan pendapatan dan SEO publisher
- Cara Kerja REST API: Route, Endpoint, Namespace, dan Metode HTTP
- Route dan endpoint
- Namespace
- JSON dan respons API
- Permalink dan alamat alternatif
- Endpoint Inti yang Paling Berguna untuk Publisher
- Parameter global yang perlu Anda kenal
- Konteks: view, embed, dan edit
- Apa yang Bisa Dilakukan Publisher dengan REST API
- Membaca dan menampilkan konten di tempat lain
- Membuat draf dari alat lain
- Mengunggah dan mengelola media secara massal
- Sinkronisasi dan pelaporan editorial
- Moderasi komentar dan manajemen pengguna
- Membangun pengalaman front-end khusus
- Autentikasi: Cookie, Application Password, dan Metode Lainnya
- Cookie authentication dengan nonce
- Application Password: metode yang direkomendasikan untuk aplikasi eksternal
- OAuth dan JWT: kapan dibutuhkan
- Plugin Basic Authentication: hanya untuk pengembangan
- Cara Membuat Application Password Langkah demi Langkah
- Langkah 1: Pastikan situs memakai HTTPS dan akun Anda memiliki peran yang tepat
- Langkah 2: Buka Pengguna, lalu Profil
- Langkah 3: Beri nama dan buat kata sandi baru
- Langkah 4: Salin dan simpan kata sandi di tempat yang aman
- Langkah 5: Uji dengan satu permintaan baca yang aman
- Langkah 6: Cabut bila tidak lagi dipakai
- Permintaan Pertama Anda: Membaca, Membuat Draf, dan Mengunggah Media
- Membaca sepuluh artikel terbaru
- Membuat draf artikel baru
- Memperbarui draf dan mengubah status
- Mengunggah gambar
- Contoh skrip Python singkat
- Otomasi Konten yang Aman untuk Publisher
- Prinsip pertama: otomasi menyiapkan, manusia memutuskan
- Prinsip kedua: validasi sebelum mengirim
- Prinsip ketiga: catat setiap tindakan otomatis
- Prinsip keempat: hormati batas server dan jangan membanjiri API
- Contoh alur otomasi yang sehat
- Keamanan REST API: Praktik yang Wajib Dijaga
- Selalu memakai HTTPS
- Terapkan prinsip hak akses seminimal mungkin
- Jangan menyimpan kredensial di tempat yang bisa dibaca publik
- Batasi apa yang bisa diakses bila memungkinkan
- Jangan menonaktifkan REST API
- Pantau pemakaian dan cabut kredensial yang tidak aktif
- Pisahkan kredensial antar alat dan antar lingkungan
- Troubleshooting: Error yang Paling Sering Muncul dan Cara Mengatasinya
- Kapan REST API Bukan Jawaban yang Tepat
- Checklist Sebelum Memakai REST API di Situs Produksi
- FAQ
- Apakah WordPress REST API gratis?
- Apakah saya harus bisa pemrograman untuk memakai REST API?
- Apakah REST API membuat situs saya tidak aman?
- Mengapa editor blok saya gagal menyimpan dan apa hubungannya dengan REST API?
- Bisakah saya memakai REST API untuk memindahkan artikel antar situs?
- Apa bedanya Application Password dengan kata sandi akun WordPress saya?
- Kesimpulan
- Sumber resmi yang dirujuk
Poin Kunci
- WordPress REST API masuk ke inti WordPress pada versi 4.7 (Desember 2016) dan menjadi fondasi editor blok (Gutenberg); setiap penyimpanan di editor pada dasarnya adalah panggilan REST API.
- API tersedia di alamat
/wp-json/pada situs Anda, dengan endpoint inti di namespacewp/v2, misalnya/wp-json/wp/v2/postsuntuk artikel. - Membaca artikel yang sudah terbit umumnya bisa dilakukan tanpa login, sedangkan menulis, mengubah, atau menghapus konten wajib autentikasi dan hak akses yang sesuai.
- Cara autentikasi yang direkomendasikan untuk aplikasi dan skrip eksternal adalah Application Password — kredensial terpisah per aplikasi yang diperkenalkan di WordPress 5.6, hanya bekerja lewat HTTPS, dan bisa dicabut kapan saja tanpa mengubah kata sandi utama.
- Parameter
per_pagedibatasi 1 sampai 100 per permintaan; total data tersedia di header responsX-WP-TotaldanX-WP-TotalPages. - Jangan menonaktifkan REST API: editor blok dan banyak plugin bergantung padanya, sehingga mematikannya justru merusak alur kerja redaksi.
- Otomasi yang sehat adalah otomasi yang tetap melewati pemeriksaan manusia: buat draf lewat API, lalu tinjau dan terbitkan secara manual, bukan menerbitkan konten massal tanpa pengawasan.
Daftar Isi
- Apa Itu WordPress REST API dan Mengapa Publisher Perlu Memahaminya
- Cara Kerja REST API: Route, Endpoint, Namespace, dan Metode HTTP
- Endpoint Inti yang Paling Berguna untuk Publisher
- Apa yang Bisa Dilakukan Publisher dengan REST API
- Autentikasi: Cookie, Application Password, dan Metode Lainnya
- Cara Membuat Application Password Langkah demi Langkah
- Permintaan Pertama Anda: Membaca, Membuat Draf, dan Mengunggah Media
- Otomasi Konten yang Aman untuk Publisher
- Keamanan REST API: Praktik yang Wajib Dijaga
- Troubleshooting: Error yang Paling Sering Muncul dan Cara Mengatasinya
- Kapan REST API Bukan Jawaban yang Tepat
- Checklist Sebelum Memakai REST API di Situs Produksi
- FAQ
- Kesimpulan
Apa Itu WordPress REST API dan Mengapa Publisher Perlu Memahaminya
REST API adalah singkatan dari Representational State Transfer Application Programming Interface. Dalam bahasa yang lebih sederhana, ini adalah cara standar bagi dua perangkat lunak untuk berbicara melalui web: satu pihak mengirim permintaan HTTP ke sebuah alamat (URL), pihak lain menjawab dengan data terstruktur, biasanya dalam format JSON (JavaScript Object Notation) yang ringan dan mudah dibaca mesin maupun manusia.
Sebelum REST API masuk ke inti WordPress pada versi 4.7 tahun 2016, WordPress pada dasarnya hanya bisa diakses lewat dasbor wp-admin atau lewat XML-RPC yang lebih tua. REST API mengubahnya: konten WordPress — artikel, halaman, kategori, tag, media, komentar, pengguna — menjadi sumber daya yang bisa diakses program lain secara terstruktur. Dokumentasi resmi WordPress menggambarkannya sebagai antarmuka bagi aplikasi untuk berinteraksi dengan situs WordPress dengan mengirim dan menerima data sebagai objek JSON, dan menyebutnya sebagai fondasi editor blok WordPress.
Bagi publisher, ada tiga alasan praktis untuk memahami REST API meskipun Anda bukan pengembang. Pertama, editor blok yang Anda gunakan setiap hari bekerja di atas REST API. Setiap kali Anda menyimpan draf, mengunggah gambar, atau mengubah kategori di editor, editor mengirim permintaan REST API di balik layar. Memahami hal ini menjelaskan mengapa masalah pada REST API — misalnya karena plugin keamanan yang terlalu agresif — bisa membuat editor gagal menyimpan.
Kedua, REST API membuka jalan otomasi editorial yang sebelumnya membutuhkan pekerjaan manual berulang. Contoh yang realistis: menarik daftar artikel terbaru ke aplikasi seluler internal, menyinkronkan judul dan status artikel ke spreadsheet redaksi, membuat draf dari dokumen yang ditulis di alat lain, atau membangun halaman arsip khusus yang menampilkan artikel berdasarkan kategori dan tanggal tanpa harus menulis kueri database sendiri.
Ketiga, REST API adalah fondasi arsitektur headless WordPress, yaitu pola di mana WordPress hanya menjadi penyimpan dan pengelola konten, sementara tampilan depan dibangun dengan framework JavaScript seperti React atau Next.js. Anda tidak wajib memakai pola headless — sebagian besar publisher tetap memakai tema WordPress biasa — tetapi memahami konsepnya membantu Anda menilai tawaran pengembang dan memahami arah perkembangan platform.
REST API bukan XML-RPC dan bukan sekadar “fitur pengembang”
Banyak publisher lama mengenal XML-RPC melalui file xmlrpc.php, antarmuka lama yang dipakai aplikasi seluler WordPress dan alat penerbitan jarak jauh. REST API adalah penggantinya yang modern: lebih terstruktur, lebih mudah diamankan per endpoint, dan terintegrasi dengan sistem peran dan kapabilitas WordPress. Keduanya masih ada di WordPress modern, tetapi untuk integrasi baru, REST API adalah jalur yang didokumentasikan dan direkomendasikan.
Satu hal yang perlu diluruskan sejak awal: REST API sudah aktif secara default di semua instalasi WordPress modern sejak versi 4.7. Anda tidak perlu memasang plugin untuk mengaktifkannya, dan Anda tidak perlu membayar apa pun. Yang perlu Anda lakukan hanyalah mengetahui alamatnya, memahami autentikasinya, dan memakai hak akses yang tepat.
Bagaimana REST API berhubungan dengan pendapatan dan SEO publisher
REST API sendiri tidak menaikkan CPC atau RPM AdSense, dan artikel ini tidak akan menjanjikan hal itu. Hubungannya dengan pendapatan bersifat tidak langsung tetapi nyata. Alur editorial yang efisien berarti artikel lebih cepat terbit dengan kualitas yang terjaga; data artikel yang mudah diambil berarti Anda bisa membangun laporan kinerja sendiri; dan integrasi yang rapi berarti lebih sedikit kesalahan manual seperti artikel ganda atau kategori yang salah. Sebaliknya, otomasi yang ceroboh — misalnya menerbitkan ratusan artikel otomatis tanpa pemeriksaan — justru berisiko melanggar kebijakan spam Google tentang scaled content abuse, yang sudah dibahas pada artikel sebelumnya di situs ini. Karena itu, separuh artikel ini membahas batasan dan keamanan, bukan hanya kemampuannya.
Cara Kerja REST API: Route, Endpoint, Namespace, dan Metode HTTP
Untuk memakai REST API, Anda hanya perlu memahami empat konsep yang saling berkaitan: route, endpoint, namespace, dan metode HTTP. Dokumentasi resmi WordPress (REST API Handbook) menjelaskan keempatnya dengan contoh yang konsisten, dan bagian ini merangkumnya dalam bahasa yang lebih dekat dengan kebutuhan publisher.
Route dan endpoint
Route adalah alamat URI tempat sebuah sumber daya berada. Contohnya, /wp-json/ adalah route indeks API, dan /wp-json/wp/v2/posts adalah route untuk koleksi artikel. Endpoint adalah pemetaan antara satu metode HTTP dan satu route: metode yang sama pada route yang sama bisa melakukan hal yang berbeda. Dokumentasi resmi memberi contoh route /wp-json/wp/v2/posts/123, yaitu artikel dengan ID 123: permintaan GET memanggil metode get_item dan mengembalikan data artikel; PUT memanggil update_item dan memperbarui artikel; DELETE memanggil delete_item dan menghapusnya.
Perbedaan ini penting karena banyak kebingungan pemula berasal dari mengira URL saja yang menentukan hasil. Yang menentukan adalah kombinasi URL dan metode HTTP. Membaca memakai GET, membuat memakai POST, memperbarui memakai PUT (atau PATCH pada beberapa endpoint), dan menghapus memakai DELETE. Dokumentasi resmi merangkumnya sebagai berikut: GET untuk mengambil data, POST untuk membuat sumber daya baru, PUT untuk memperbarui, DELETE untuk menghapus, dan OPTIONS untuk meminta konteks tentang suatu sumber daya.
Namespace
Namespace adalah bagian pertama dari route setelah /wp-json/ yang mengelompokkan endpoint berdasarkan pemiliknya. Endpoint inti WordPress memakai namespace wp/v2. Artinya, hampir semua operasi konten standar — artikel, halaman, media, kategori, tag, komentar, pengguna — berada di bawah /wp-json/wp/v2/. Plugin dan tema yang menambahkan endpoint sendiri wajib memakai namespace mereka sendiri, misalnya nama-plugin/v1, agar tidak bertabrakan dengan endpoint inti atau plugin lain. Dokumentasi resmi menegaskan untuk tidak menaruh endpoint kustom di namespace wp kecuali memang dimaksudkan untuk digabungkan ke inti WordPress.
Praktik penamaan namespace ini juga berguna bagi publisher saat menilai plugin: plugin yang menambahkan endpoint dengan namespace yang jelas dan terdokumentasi umumnya lebih mudah diaudit daripada plugin yang menyuntikkan endpoint tanpa pola yang jelas. Anda tidak perlu menghafal semua namespace, cukup tahu bahwa wp/v2 adalah wilayah inti yang stabil dan terdokumentasi.
JSON dan respons API
Setiap respons REST API berupa JSON: teks terstruktur berisi pasangan kunci dan nilai. Sebuah artikel yang diambil lewat API, misalnya, berisi field seperti id, date, slug, status, title (dengan sub-field rendered), content (dengan sub-field rendered dan raw pada konteks edit), excerpt, author, categories, tags, dan featured_media. Anda tidak perlu menghafal semua field; skema setiap endpoint terdokumentasi dan bisa dibaca lewat route indeks API itu sendiri.
Bagi publisher non-teknis, cara paling mudah memahami JSON adalah membukanya di browser. Buka alamat https://situsanda.com/wp-json/ di browser, dan Anda akan melihat daftar route yang tersedia dalam format JSON. Browser modern menampilkannya dengan format yang rapi dan bisa dilipat. Dari sana, buka https://situsanda.com/wp-json/wp/v2/posts dan Anda akan melihat sepuluh artikel terbaru situs Anda dalam format JSON. Itu adalah REST API yang sedang bekerja — tanpa satu baris kode pun.
Permalink dan alamat alternatif
Agar REST API bekerja dengan alamat yang rapi seperti /wp-json/wp/v2/posts, situs Anda harus memakai pretty permalink (struktur permalink selain “Plain”). Jika situs memakai permalink “Plain”, route REST API tetap tersedia, tetapi harus dikirim sebagai parameter query rest_route, misalnya https://situsanda.com/?rest_route=/wp/v2/posts. Karena sebagian besar situs publisher sudah memakai permalink berbasis nama artikel, hal ini jarang menjadi masalah, tetapi penting diketahui saat Anda menguji API di situs lama yang belum mengubah struktur permalinknya.
Endpoint Inti yang Paling Berguna untuk Publisher
Tabel berikut merangkum endpoint inti yang paling relevan untuk pekerjaan redaksi sehari-hari. Semua endpoint ini berada di namespace wp/v2 dan bisa diakses di alamat https://situsanda.com/wp-json/wp/v2/.... Kolom “Butuh login” merujuk pada operasi baca terhadap konten yang sudah terbit; konten draf, privat, dan operasi tulis selalu membutuhkan autentikasi dan hak akses.
| Endpoint | Kegunaan untuk publisher | Butuh login untuk membaca yang terbit |
|---|---|---|
/wp/v2/posts |
Membaca, membuat, memperbarui, dan menghapus artikel | Tidak |
/wp/v2/pages |
Mengelola halaman statis seperti Tentang, Kontak, Kebijakan Privasi | Tidak |
/wp/v2/media |
Mengunggah dan mengelola gambar serta file media | Tidak untuk membaca; ya untuk mengunggah |
/wp/v2/categories |
Membaca dan mengelola kategori artikel | Tidak |
/wp/v2/tags |
Membaca dan mengelola tag artikel | Tidak |
/wp/v2/comments |
Membaca dan memoderasi komentar | Tidak untuk komentar yang disetujui |
/wp/v2/users |
Membaca data pengguna dan memeriksa peran | Ya, untuk data di luar profil publik |
/wp/v2/search |
Mencari konten di berbagai jenis post | Tidak |
/wp/v2/types |
Melihat jenis post yang terdaftar, termasuk custom post type | Tidak |
/wp/v2/settings |
Membaca dan mengubah pengaturan situs | Ya, dan butuh peran administrator |
Perhatikan bahwa membaca artikel yang sudah terbit bersifat publik secara default. Artinya, siapa pun yang mengetahui alamat endpoint bisa mengambil daftar artikel Anda. Ini bukan kebocoran keamanan — itu memang sifat API publik, sama seperti halaman arsip situs Anda yang bisa dibaca siapa saja. Yang bersifat privat adalah draf, artikel terjadwal, data pengguna, dan pengaturan situs; semua itu membutuhkan autentikasi dan kapabilitas yang sesuai.
Parameter global yang perlu Anda kenal
Dokumentasi resmi REST API Handbook menjelaskan sejumlah parameter global yang berlaku di hampir semua endpoint koleksi. Tiga yang paling sering dipakai publisher adalah sebagai berikut.
Pertama, per_page menentukan berapa banyak item yang dikembalikan dalam satu permintaan, dengan nilai 1 sampai 100. Nilai default-nya 10, sama seperti jumlah artikel per halaman arsip pada umumnya. Jika Anda meminta per_page=101, API tidak diam-diam membatasinya ke 100 — permintaan itu ditolak dengan error validasi. Batas ini sengaja dibuat agar satu permintaan tidak membebani server, dan dokumentasi resmi menyatakan bahwa untuk mengambil lebih dari 100 item Anda harus membuat beberapa permintaan dan menggabungkan hasilnya di aplikasi Anda.
Kedua, page menentukan halaman hasil yang dikembalikan, dan offset menentukan titik awal pengambilan secara bebas. Keduanya tidak boleh dipakai bersamaan pada endpoint yang sama; pilih salah satu. Untuk kebutuhan arsip dan laporan, page bersama per_page adalah kombinasi yang paling mudah dipahami.
Ketiga, _fields memungkinkan Anda meminta hanya field tertentu saja, misalnya ?_fields=id,date,title,link. Ini sangat berguna untuk mempercepat respons: mengambil sepuluh artikel lengkap beserta isi penuhnya jauh lebih berat daripada mengambil hanya ID, tanggal, judul, dan tautannya. Praktik ini penting ketika Anda membangun dasbor atau menarik data secara berkala.
Dua header respons yang patut dikenal adalah X-WP-Total, yaitu jumlah total item dalam koleksi, dan X-WP-TotalPages, yaitu jumlah total halaman. Dengan dua header ini, aplikasi Anda tahu kapan harus berhenti mengambil halaman berikutnya tanpa harus menebak dari respons yang kosong. Perlu dicatat bahwa meminta halaman di luar jumlah total halaman pada koleksi yang memiliki hasil akan mengembalikan error HTTP 400, bukan array kosong — jadi logika aplikasi Anda harus membaca header ini, bukan mengandalkan respons kosong sebagai tanda selesai.
Konteks: view, embed, dan edit
Setiap endpoint mendukung parameter context dengan tiga nilai: view (default, data yang layak tampil publik), embed (versi ringkas untuk penyematan), dan edit (data lengkap termasuk konten mentah, tetapi hanya untuk pengguna terautentikasi yang berhak mengedit). Perbedaan ini menjelaskan mengapa permintaan yang sama bisa mengembalikan field yang berbeda: dalam konteks view, field content hanya berisi rendered (HTML hasil render), sedangkan dalam konteks edit ada tambahan raw (konten mentah beserta markup blok) dan protected (apakah artikel dilindungi kata sandi). Saat Anda membangun alat editorial, hampir selalu Anda membutuhkan konteks edit.
Apa yang Bisa Dilakukan Publisher dengan REST API
Setelah memahami konsep dasarnya, pertanyaan berikutnya adalah: apa saja pekerjaan redaksi yang benar-benar bisa dibantu REST API? Berikut ini adalah pola penggunaan yang realistis, diurutkan dari yang paling mudah sampai yang membutuhkan bantuan pengembang.
Membaca dan menampilkan konten di tempat lain
Penggunaan paling sederhana adalah membaca konten WordPress dari luar WordPress. Contohnya: aplikasi seluler internal redaksi yang menampilkan artikel terbaru, widget di situs lain yang menampilkan lima artikel terbaru berdasarkan kategori, atau halaman arsip khusus yang memfilter artikel berdasarkan tag dan tanggal. Karena membaca artikel terbit tidak membutuhkan autentikasi, pola ini bisa dicoba siapa saja tanpa risiko mengubah konten.
Membuat draf dari alat lain
Pola kedua adalah membuat draf secara terprogram. Misalnya, tim redaksi menulis di Google Docs atau Notion, lalu sebuah skrip mengubah dokumen yang sudah disetujui menjadi draf WordPress lengkap dengan kategori dan tag. Atau, sistem lain — misalnya formulir pengiriman naskah kontributor — membuat draf otomatis begitu formulir dikirim. Kuncinya: yang dibuat adalah draf, bukan artikel terbit. Editor manusia tetap membuka draf itu, memeriksa isinya, lalu menerbitkannya dari dasbor seperti biasa. Pola ini menghemat waktu penyalinan manual tanpa mengorbankan pemeriksaan kualitas.
Mengunggah dan mengelola media secara massal
Endpoint media (/wp/v2/media) memungkinkan pengunggahan gambar beserta judul, teks alt, dan deskripsinya. Ini berguna saat Anda memigrasi ratusan gambar, memperbarui teks alt untuk aksesibilitas dan SEO, atau mengunggah gambar hasil desain yang dibuat di alat lain. Perlu diingat bahwa pengunggahan media selalu membutuhkan autentikasi dan hak mengunggah file; jangan pernah membagikan kredensial pengunggah ke pihak yang tidak dipercaya.
Sinkronisasi dan pelaporan editorial
Dengan REST API, Anda bisa menarik data artikel — tanggal terbit, kategori, tag, penulis, status — ke spreadsheet atau alat pelaporan, lalu menghitung hal-hal seperti jumlah artikel per kategori per bulan, artikel yang belum memiliki gambar unggulan, atau artikel lama yang belum diperbarui. Ini adalah bentuk otomasi yang paling aman karena hanya membaca data dan tidak mengubah apa pun di situs. Banyak publisher kecil memulai otomasi REST API dari pelaporan seperti ini sebelum menyentuh operasi tulis.
Moderasi komentar dan manajemen pengguna
Endpoint komentar memungkinkan tim redaksi membaca, menyetujui, atau membalas komentar dari alat di luar dasbor. Endpoint pengguna memungkinkan pemeriksaan peran dan kapabilitas. Untuk situs berita dan media dengan volume komentar tinggi, alat moderasi kustom di atas REST API bisa lebih cepat daripada membuka dasbor untuk setiap komentar. Namun, untuk sebagian besar publisher kecil, dasbor bawaan WordPress sudah cukup; REST API baru terasa manfaatnya ketika volume atau kebutuhan integrasi sudah di luar kemampuan dasbor.
Membangun pengalaman front-end khusus
Pada ujung yang paling ambisius, REST API memungkinkan situs headless: tampilan depan dibangun dengan framework JavaScript modern, sementara WordPress tetap menjadi tempat menulis dan mengelola konten. Pendekatan ini memberikan kebebasan desain dan performa, tetapi menambah kompleksitas besar: Anda membutuhkan pengembang yang merawat front-end, menangani caching, SEO teknis, dan rendering sisi server agar Google tetap bisa mengindeks konten dengan baik. Untuk sebagian besar publisher Indonesia yang mengandalkan tema WordPress dan iklan display, headless adalah investasi yang baru masuk akal ketika tim sudah besar dan kebutuhan tampilannya tidak lagi bisa dipenuhi tema biasa. Jangan mengadopsi headless hanya karena terdengar modern.
| Pola penggunaan | Tingkat kesulitan | Risiko bila salah | Cocok untuk |
|---|---|---|---|
| Membaca artikel untuk ditampilkan di tempat lain | Rendah | Kecil; hanya baca data publik | Semua publisher |
| Pelaporan dan sinkronisasi data editorial | Rendah | Kecil; hanya baca data | Publisher dengan 50+ artikel |
| Membuat draf dari alat lain | Menengah | Sedang; draf salah masih bisa diperbaiki sebelum terbit | Tim redaksi 2+ orang |
| Mengunggah media massal | Menengah | Sedang; file salah bisa membebani media library | Migrasi dan pembaruan massal |
| Moderasi komentar via alat kustom | Menengah | Sedang; komentar bisa salah disetujui | Situs dengan komentar tinggi |
| Situs headless penuh | Tinggi | Tinggi; SEO dan performa bisa rusak bila salah | Tim besar dengan pengembang khusus |
Autentikasi: Cookie, Application Password, dan Metode Lainnya
Membaca artikel terbit memang terbuka, tetapi begitu Anda ingin menulis, mengubah, atau mengakses konten privat, WordPress harus tahu siapa Anda dan apakah Anda berhak melakukannya. Di sinilah autentikasi berperan. Dokumentasi resmi REST API Handbook menjelaskan beberapa metode, dan bagian ini membahas yang paling relevan untuk publisher.
Cookie authentication dengan nonce
Saat Anda sudah login di dasbor WordPress, JavaScript di dalam dasbor memakai cookie login Anda ditambah sebuah nonce (nomor sekali pakai) yang dikirim lewat header X-WP-Nonce. Inilah cara editor blok menyimpan artikel Anda: ia sudah terautentikasi karena Anda sudah login. Metode ini hanya berlaku untuk permintaan yang dibuat dari dalam dasbor oleh pengguna yang sedang login, dan tidak bisa dipakai oleh skrip atau aplikasi eksternal. Untuk kebutuhan publisher sehari-hari, Anda tidak perlu mengurus metode ini secara manual — editor sudah menanganinya.
Application Password: metode yang direkomendasikan untuk aplikasi eksternal
Application Password adalah fitur inti WordPress sejak versi 5.6 (Desember 2020) yang memungkinkan Anda membuat kredensial terpisah dan bisa dicabut untuk setiap aplikasi atau skrip yang membutuhkan akses API. Dokumentasi resmi Advanced Administration Handbook menjelaskannya sebagai kredensial per aplikasi yang bisa dicabut, dirancang agar Anda tidak perlu membagikan kata sandi utama kepada alat pihak ketiga.
Karakteristik penting Application Password, semuanya bersumber dari dokumentasi resmi WordPress, adalah sebagai berikut:
- Satu kata sandi per aplikasi. Setiap Application Password diberi nama, misalnya “Skrip Laporan Redaksi” atau “Aplikasi Mobile Internal”, sehingga Anda tahu persis alat mana yang memakai kredensial mana. Mencabut satu kredensial tidak memengaruhi kredensial lain dan tidak mengubah kata sandi utama Anda.
- Hanya untuk akses programatik. Application Password dimaksudkan untuk autentikasi API — REST API dan XML-RPC bila diaktifkan — bukan untuk login interaktif di browser. Application Password tidak bisa dipakai untuk masuk ke wp-admin lewat
wp-login.php. Jika seseorang mencuri sebuah Application Password, ia tetap tidak bisa membuka dasbor Anda dengan kata sandi itu. - Ditampilkan hanya sekali. WordPress menyimpan hash-nya, bukan teks aslinya, dan menampilkan kata sandi lengkap hanya sekali saat pembuatan. Jika Anda kehilangan salinannya, Anda tidak bisa melihatnya lagi; Anda harus mencabutnya dan membuat yang baru.
- Hanya lewat HTTPS. Secara default, Application Password hanya tersedia bila permintaan dilayani lewat HTTPS. Ini disengaja: kredensial Basic Auth bisa disadap bila dikirim tanpa enkripsi. Karena situs publisher modern sudah memakai HTTPS, syarat ini umumnya sudah terpenuhi.
- Hak akses sama dengan pemiliknya. Application Password bertindak dengan seluruh peran dan kapabilitas pengguna yang membuatnya. Kata sandi yang dibuat oleh akun administrator bisa melakukan apa saja yang bisa dilakukan administrator, termasuk menghapus konten dan mengubah pengaturan. Karena itu, buatlah Application Password dari akun dengan peran seminimal mungkin untuk tugas tersebut — misalnya akun Editor untuk skrip yang hanya membuat draf, bukan akun Administrator.
Cara kerjanya secara teknis sederhana: klien mengirim kredensial sebagai HTTP Basic Authentication, yaitu header Authorization: Basic ... yang berisi username dan Application Password yang dikodekan Base64. Dokumentasi resmi menegaskan untuk selalu memakai HTTPS saat mengirim header ini, karena kredensial Basic Auth dapat disadap di jaringan bila dikirim tanpa enkripsi.
OAuth dan JWT: kapan dibutuhkan
Selain Application Password, ada metode autentikasi lain seperti OAuth 1.0a (melalui plugin) dan JWT (JSON Web Token, juga melalui plugin). Keduanya lebih cocok untuk aplikasi pihak ketiga yang melayani banyak pengguna berbeda — misalnya plugin yang menghubungkan ribuan situs WordPress ke satu layanan. Untuk kebutuhan internal satu situs — skrip laporan, integrasi alat redaksi, aplikasi internal — Application Password hampir selalu cukup dan jauh lebih sederhana. Jangan menambah plugin autentikasi yang tidak Anda butuhkan hanya karena namanya terdengar lebih canggih.
Plugin Basic Authentication: hanya untuk pengembangan
Dokumentasi resmi juga membahas plugin Basic Authentication yang memakai username dan kata sandi utama pada setiap permintaan. Plugin ini direkomendasikan hanya untuk pengembangan dan pengujian, bukan untuk situs produksi. Alasannya jelas: kata sandi utama Anda akan dikirim pada setiap permintaan dan, bila bocor, penyerang mendapatkan akses penuh ke akun Anda. Di situs produksi, selalu pakai Application Password yang bisa dicabut per aplikasi, bukan kata sandi utama.
| Metode autentikasi | Dipakai untuk | Cocok untuk situs produksi | Catatan keamanan |
|---|---|---|---|
| Cookie + nonce | Editor blok dan dasbor | Ya, bawaan WordPress | Hanya di dalam dasbor yang sudah login |
| Application Password | Skrip dan aplikasi eksternal | Ya, direkomendasikan | Per aplikasi, bisa dicabut, HTTPS wajib |
| OAuth 1.0a (plugin) | Aplikasi pihak ketiga multi-pengguna | Ya, bila dibutuhkan | Lebih kompleks; untuk integrasi publik |
| JWT (plugin) | Aplikasi dan layanan kustom | Ya, bila dibutuhkan | Memerlukan plugin dan manajemen token |
| Basic Auth dengan kata sandi utama (plugin) | Pengembangan dan pengujian | Tidak | Kata sandi utama terpapar di setiap permintaan |
Cara Membuat Application Password Langkah demi Langkah
Bagian ini adalah panduan praktis yang bisa diikuti langsung di dasbor WordPress Anda. Langkah-langkah ini merujuk pada dokumentasi resmi dan telah menjadi prosedur standar sejak WordPress 5.6.
Langkah 1: Pastikan situs memakai HTTPS dan akun Anda memiliki peran yang tepat
Application Password hanya muncul bila situs dilayani lewat HTTPS (atau bila tipe lingkungan situs adalah local untuk pengembangan). Jika bagian Application Password tidak muncul di profil Anda, periksa dulu apakah situs sudah memakai HTTPS dan apakah ada plugin keamanan — beberapa plugin keamanan menonaktifkan fitur ini — yang mematikannya. Selain itu, putuskan akun mana yang akan dipakai. Untuk skrip yang hanya membuat draf dan membaca data, akun Editor sudah cukup. Gunakan akun Administrator hanya bila skrip benar-benar membutuhkan kemampuan administrator, misalnya mengubah pengaturan situs.
Langkah 2: Buka Pengguna, lalu Profil
Masuk ke dasbor wp-admin, buka menu Pengguna, lalu Profil (atau Semua Pengguna, lalu Edit pada akun yang akan dipakai, bila Anda administrator dan membuat kata sandi untuk akun lain). Gulir ke bawah sampai menemukan bagian Application Passwords atau Kata Sandi Aplikasi.
Langkah 3: Beri nama dan buat kata sandi baru
Pada kolom Nama Kata Sandi Aplikasi Baru, ketikkan nama yang menjelaskan tujuannya, misalnya “Laporan Redaksi Bulanan” atau “Sinkronisasi Draf Notion”. Nama yang jelas sangat membantu saat Anda perlu mencabut satu kredensial di kemudian hari tanpa mengganggu yang lain. Klik Tambah Kata Sandi Aplikasi (Add Application Password). WordPress akan menampilkan kata sandi baru yang terdiri dari 24 karakter huruf dan angka, ditampilkan dalam kelompok empat karakter agar mudah disalin.
Langkah 4: Salin dan simpan kata sandi di tempat yang aman
Salin kata sandi itu segera dan simpan di pengelola kata sandi atau brankas kredensial tim Anda. Ingat: WordPress hanya menampilkannya sekali. Setelah Anda meninggalkan halaman itu, kata sandi tidak bisa ditampilkan lagi. Jangan pernah menempel kata sandi ini di dokumen yang dibagikan, di repositori kode publik, atau di kode JavaScript sisi klien yang bisa dibaca siapa saja dari browser.
Langkah 5: Uji dengan satu permintaan baca yang aman
Sebelum memakai kredensial untuk operasi tulis, uji dulu dengan permintaan baca yang aman: GET /wp-json/wp/v2/users/me dengan autentikasi Basic Auth memakai username dan Application Password. Jika berhasil, respons akan menampilkan data akun Anda. Uji ini memastikan kredensial bekerja tanpa mengubah apa pun di situs. Bila gagal, periksa kembali tiga hal: apakah HTTPS aktif, apakah spasi pada kata sandi sudah benar (WordPress mengabaikan spasi saat memeriksa, tetapi salinan yang salah tetap bisa gagal), dan apakah akun yang dipakai memiliki peran yang sesuai.
Langkah 6: Cabut bila tidak lagi dipakai
Setiap Application Password memiliki tanggal pembuatan dan informasi terakhir dipakai (termasuk alamat IP terakhir, dengan akurasi sekitar satu hari). Tinjau daftar ini secara berkala. Jika sebuah integrasi sudah tidak dipakai, atau jika Anda mencurigai kredensial bocor, klik Cabut (Revoke) pada kata sandi tersebut. Pencabutan bersifat langsung: semua permintaan yang memakai kredensial itu akan langsung ditolak. Anda tidak perlu mengubah kata sandi utama dan kredensial lain tetap berfungsi.
Permintaan Pertama Anda: Membaca, Membuat Draf, dan Mengunggah Media
Bagian ini memberikan contoh konkret yang bisa Anda coba dengan alat baris perintah curl atau dengan skrip Python sederhana. Gantilah situsanda.com dengan domain Anda sendiri, dan jangan pernah menjalankan contoh yang mengubah konten di situs produksi sebelum Anda mengujinya di situs staging.
Membaca sepuluh artikel terbaru
Permintaan paling sederhana tidak membutuhkan autentikasi sama sekali:
curl "https://situsanda.com/wp-json/wp/v2/posts?per_page=10&_fields=id,date,title,link"
Responsnya adalah array JSON berisi sepuluh artikel terbaru, masing-masing hanya dengan ID, tanggal, judul, dan tautan. Tambahkan &page=2 untuk halaman berikutnya, atau &search=kata-kunci untuk mencari artikel yang mengandung kata tertentu di judul atau isi. Parameter search ini berguna untuk alat editorial yang perlu menemukan artikel lama berdasarkan kata kunci tanpa membuka dasbor.
Untuk melihat total artikel yang cocok dengan suatu filter tanpa mengunduh isinya, Anda bisa memakai permintaan HEAD dan membaca header X-WP-Total. Cara ini jauh lebih ringan daripada mengambil semua halaman hanya untuk menghitung jumlah artikel.
Membuat draf artikel baru
Membuat draf membutuhkan autentikasi dan hak menerbitkan atau menulis artikel. Contoh dengan curl:
curl -X POST "https://situsanda.com/wp-json/wp/v2/posts" \
--user "nama-pengguna:abcd efgh ijkl mnop qrst uvwx" \
-H "Content-Type: application/json" \
-d '{"title":"Judul Draf dari API","content":"Isi draf percobaan.","status":"draft","categories":[3]}'
Perhatikan tiga hal pada contoh ini. Pertama, --user memakai username dan Application Password, bukan kata sandi utama. Kedua, status diisi draft, bukan publish — ini adalah kebiasaan yang harus selalu Anda pegang saat mengotomasi pembuatan konten. Ketiga, categories memakai ID kategori berupa angka, bukan nama kategori; Anda bisa mendapatkan ID kategori lewat GET /wp-json/wp/v2/categories.
Jika permintaan berhasil, respons berisi data artikel yang baru dibuat, termasuk ID-nya. Simpan ID itu: Anda membutuhkannya untuk memperbarui draf yang sama di kemudian hari dengan permintaan PUT atau POST ke /wp-json/wp/v2/posts/<id>.
Memperbarui draf dan mengubah status
Untuk memperbarui draf yang sudah dibuat lewat API, kirim permintaan ke route artikel spesifik tersebut:
curl -X POST "https://situsanda.com/wp-json/wp/v2/posts/123" \
--user "nama-pengguna:abcd efgh ijkl mnop qrst uvwx" \
-H "Content-Type: application/json" \
-d '{"content":"Isi draf yang sudah diperbarui."}'
Untuk menerbitkan draf yang sudah ditinjau manusia, ubah status menjadi publish. Tetapi ingat prinsip yang ditekankan di seluruh artikel ini: penerbitan sebaiknya tetap menjadi keputusan manusia setelah membaca draf. Skrip boleh menyiapkan, manusia yang menerbitkan.
Mengunggah gambar
Mengunggah media memakai endpoint /wp-json/wp/v2/media dengan metode POST dan header Content-Disposition yang menyebutkan nama file, serta header Content-Type yang sesuai (misalnya image/jpeg). Responsnya berisi ID media yang bisa dipakai sebagai featured_media pada artikel. Setelah mengunggah, Anda tetap perlu mengatur teks alt yang deskriptif — baik untuk aksesibilitas maupun SEO — karena teks alt yang kosong atau berisi nama file mentah adalah peluang optimasi yang terbuang.
Contoh skrip Python singkat
Bagi publisher yang nyaman dengan Python, contoh berikut mengambil sepuluh artikel terbaru dan mencetak judul beserta tautannya. Contoh ini hanya membaca data, sehingga aman dicoba tanpa risiko mengubah situs:
import requests
situs = "https://situsanda.com"
respons = requests.get(
f"{situs}/wp-json/wp/v2/posts",
params={"per_page": 10, "_fields": "id,date,title,link"},
timeout=30,
)
respons.raise_for_status()
for artikel in respons.json():
print(artikel["date"], "-", artikel["title"]["rendered"], "-", artikel["link"])
Untuk operasi tulis, tambahkan parameter auth=(username, application_password) pada pemanggilan requests.post. Simpan kredensial di variabel lingkungan atau file konfigurasi yang tidak dibagikan, bukan di dalam kode yang disalin ke mana-mana.
Otomasi Konten yang Aman untuk Publisher
Bagian ini adalah inti dari sudut pandang redaksi: otomasi REST API yang sehat bukan tentang seberapa banyak yang bisa diotomasi, melainkan tentang bagian mana yang layak diotomasi dan bagian mana yang harus tetap dipegang manusia.
Prinsip pertama: otomasi menyiapkan, manusia memutuskan
Alur yang direkomendasikan adalah sebagai berikut: skrip atau integrasi membuat draf lengkap dengan kategori, tag, dan gambar unggulan; editor manusia membuka draf itu, membaca isinya, memeriksa fakta dan tautannya, lalu menerbitkannya. Alur ini menghemat waktu pada pekerjaan mekanis — penyalinan, pemformatan, pengunggahan — tetapi mempertahankan penilaian editorial pada keputusan yang paling penting: apakah artikel ini layak terbit.
Sebaliknya, alur yang berisiko adalah skrip yang membuat dan langsung menerbitkan artikel tanpa pemeriksaan manusia, apalagi dalam jumlah besar. Selain risiko kesalahan faktual dan kualitas tulisan, pola ini bersinggungan langsung dengan kebijakan spam Google tentang scaled content abuse: konten yang diproduksi massal terutama untuk memanipulasi peringkat, tanpa nilai tambah yang nyata, dapat dikenai tindakan spam. Kebijakan itu tidak melarang penggunaan alat bantu atau otomasi — yang dilarang adalah produksi konten skala besar tanpa pengawasan dan tanpa nilai bagi pembaca. Menjaga manusia di dalam alur penerbitan adalah cara paling sederhana untuk tetap berada di sisi yang aman.
Prinsip kedua: validasi sebelum mengirim
Skrip yang baik memvalidasi data sebelum mengirimnya ke API. Periksa bahwa judul tidak kosong, isi memenuhi panjang minimum yang Anda tetapkan, kategori memakai ID yang benar, dan tag tidak duplikatif. Periksa juga bahwa slug yang dihasilkan tidak bertabrakan dengan artikel yang sudah ada. Validasi sederhana seperti ini mencegah sebagian besar kesalahan yang kemudian harus diperbaiki manual di dasbor.
Prinsip ketiga: catat setiap tindakan otomatis
Setiap kali skrip membuat, memperbarui, atau menghapus konten, ia harus mencatat apa yang dilakukannya: waktu, endpoint yang dipakai, ID artikel yang terpengaruh, dan status responsnya. Log ini adalah jejak audit Anda. Bila suatu hari sebuah artikel hilang atau berubah tanpa penjelasan, log inilah yang pertama kali diperiksa. Untuk skrip sederhana, mencatat ke file teks saja sudah cukup; untuk integrasi yang lebih besar, gunakan sistem logging yang sudah Anda pakai untuk operasional lain.
Prinsip keempat: hormati batas server dan jangan membanjiri API
REST API tidak memiliki batas laju (rate limit) bawaan di inti WordPress, tetapi itu bukan berarti Anda bebas mengirim ribuan permintaan per menit. Setiap permintaan adalah beban bagi server Anda, dan permintaan tulis yang berat — terutama pengunggahan media — bisa memperlambat situs untuk pengunjung. Praktik yang wajar: ambil data dalam halaman-halaman kecil dengan per_page yang masuk akal (10 sampai 50 untuk sebagian besar kebutuhan), beri jeda antar permintaan pada pekerjaan massal, dan jadwalkan pekerjaan berat di luar jam sibuk. Jika hosting Anda menerapkan batas laju di tingkat server, hormati batas itu dan tangani respons 429 (Too Many Requests) dengan menunggu lalu mencoba lagi.
Contoh alur otomasi yang sehat
Berikut ini adalah tiga alur yang sudah terbukti masuk akal untuk publisher kecil dan menengah:
- Laporan mingguan otomatis. Setiap Senin pagi, skrip menarik daftar artikel yang terbit minggu lalu beserta kategori dan penulisnya, lalu mengirim ringkasannya ke email atau grup redaksi. Tidak ada konten yang diubah, tetapi tim selalu tahu apa yang sudah terbit.
- Draf dari dokumen yang disetujui. Penulis menulis di alat kolaborasi, editor menyetujui, lalu skrip mengubah dokumen itu menjadi draf WordPress dengan kategori dan tag yang sudah ditentukan. Editor membuka draf, memeriksa, lalu menerbitkan.
- Pemeriksaan kesehatan konten. Skrip berkala memeriksa artikel yang sudah terbit: mana yang belum punya gambar unggulan, mana yang excerpt-nya kosong, mana yang belum diperbarui lebih dari satu tahun. Hasilnya menjadi daftar tugas editorial, bukan perubahan otomatis.
Ketiga alur ini memiliki kesamaan: yang diotomasi adalah pekerjaan pengumpulan dan penyiapan, sedangkan keputusan editorial tetap di tangan manusia.
Keamanan REST API: Praktik yang Wajib Dijaga
REST API yang terbuka tanpa pengamanan yang tepat bisa menjadi pintu masuk bagi penyalahgunaan. Bagian ini merangkum praktik keamanan yang paling penting untuk publisher, sebagian besar bersumber dari dokumentasi resmi WordPress dan praktik keamanan umum yang sudah dibahas pada artikel keamanan WordPress di situs ini.
Selalu memakai HTTPS
Ini bukan anjuran, melainkan syarat. Application Password hanya bekerja lewat HTTPS, dan kredensial Basic Auth yang dikirim lewat HTTP biasa dapat dibaca oleh siapa saja yang berada di jalur jaringan. Jika situs Anda belum memakai HTTPS pada 2026, itu adalah prioritas yang harus diselesaikan sebelum integrasi API apa pun.
Terapkan prinsip hak akses seminimal mungkin
Buatlah Application Password dari akun dengan peran seminimal mungkin untuk tugas tersebut. Skrip laporan yang hanya membaca data tidak membutuhkan akun Administrator; akun dengan peran yang lebih rendah sudah cukup untuk membaca konten publik, dan akun Editor cukup untuk membuat draf. Bila skrip hanya perlu membuat draf, jangan memberinya kemampuan menghapus artikel atau mengubah pengaturan situs. Prinsip ini — least privilege — adalah pertahanan paling efektif bila suatu kredensial bocor: kerusakan yang bisa ditimbulkan terbatas pada apa yang memang diizinkan untuk akun itu.
Jangan menyimpan kredensial di tempat yang bisa dibaca publik
Kredensial API tidak boleh ada di kode JavaScript yang dikirim ke browser pengunjung, di repositori kode publik, di dokumen yang dibagikan, atau di tangkapan layar yang diunggah ke forum. Simpan kredensial di variabel lingkungan server, di pengelola rahasia (secret manager), atau di brankas kredensial tim. Bila kredensial pernah terekspos — misalnya tidak sengaja ditempel di forum dukungan — cabut segera dan buat yang baru; jangan berharap tidak ada yang menyalinnya.
Batasi apa yang bisa diakses bila memungkinkan
Jika integrasi Anda hanya membutuhkan endpoint tertentu, pertimbangkan pembatasan di tingkat plugin atau server: misalnya, batasi akses ke endpoint tulis hanya dari alamat IP server integrasi Anda, atau gunakan plugin yang membatasi endpoint REST API berdasarkan peran pengguna. Pembatasan seperti ini adalah lapisan tambahan, bukan pengganti autentikasi yang benar. Jangan mengandalkan pembatasan semata sambil membiarkan kredensial lemah.
Jangan menonaktifkan REST API
Godaan untuk menonaktifkan REST API sepenuhnya sering muncul dengan alasan keamanan. Dokumentasi dan berbagai panduan resmi tidak merekomendasikannya: editor blok bergantung pada REST API, begitu pula banyak plugin populer. Menonaktifkan REST API bisa membuat editor gagal menyimpan, merusak fitur plugin, dan memutus integrasi yang sah — sementara penyerang yang serius biasanya tidak mengandalkan REST API publik untuk menyerang situs. Yang benar adalah mengamankan REST API, bukan mematikannya: autentikasi yang tepat, peran yang minimal, HTTPS, dan pemantauan adalah pengamanan yang benar.
Pantau pemakaian dan cabut kredensial yang tidak aktif
Tinjau daftar Application Password secara berkala. WordPress mencatat kapan setiap kata sandi terakhir dipakai beserta alamat IP terakhirnya. Kredensial yang tidak dipakai selama berbulan-bulan sebaiknya dicabut — kredensial yang tidak aktif tetapi masih valid adalah risiko yang tidak perlu. Demikian pula, bila ada aktivitas dari alamat IP yang tidak dikenal, cabut kredensial terkait dan selidiki.
Pisahkan kredensial antar alat dan antar lingkungan
Satu Application Password untuk satu alat, dan kredensial staging berbeda dari kredensial produksi. Pemisahan ini membuat pencabutan menjadi operasi yang aman: mencabut kredensial alat yang bermasalah tidak mematikan integrasi lain, dan kesalahan di lingkungan staging tidak pernah menyentuh situs produksi.
Troubleshooting: Error yang Paling Sering Muncul dan Cara Mengatasinya
Tabel berikut merangkum error yang paling sering dihadapi publisher saat pertama kali memakai REST API, beserta penyebab dan langkah perbaikannya. Kode status HTTP adalah petunjuk pertama yang harus dibaca sebelum mencari penyebab yang lebih dalam.
| Error / kode | Artinya | Penyebab umum dan perbaikan |
|---|---|---|
401 rest_not_logged_in |
Permintaan membutuhkan login tetapi tidak ada kredensial yang valid | Kredensial tidak dikirim, salah ketik, atau sudah dicabut. Periksa header Authorization, buat ulang Application Password bila perlu, dan pastikan memakai HTTPS. |
403 rest_forbidden |
Login valid tetapi tidak punya hak untuk operasi itu | Akun tidak memiliki kapabilitas yang dibutuhkan. Periksa peran akun, dan pastikan endpoint atau konteks (edit) memang diizinkan untuk peran tersebut. |
403 rest_cannot_create |
Tidak boleh membuat konten | Akun tidak memiliki kapabilitas publish_posts atau edit_posts. Gunakan akun Editor atau Administrator, atau minta administrator menaikkan peran akun. |
404 rest_no_route |
Route tidak ditemukan | URL salah, namespace salah, atau permalink belum diatur. Periksa ejaan route dan pastikan permalink bukan “Plain” atau gunakan parameter rest_route. |
400 rest_invalid_param |
Parameter tidak valid | Nilai parameter di luar batas, misalnya per_page=101 (maksimum 100) atau page di luar total halaman. Perbaiki nilai parameter sesuai dokumentasi. |
400 rest_post_invalid_id |
ID artikel tidak ditemukan | ID yang dipakai pada route sudah dihapus atau salah ketik. Ambil ulang daftar artikel untuk memastikan ID yang benar. |
500 atau halaman kosong |
Error server | Periksa log error PHP dan hosting, nonaktifkan sementara plugin yang dicurigai, dan pastikan tidak ada kode kustom yang merusak respons JSON. |
| Editor gagal menyimpan | REST API terhalang | Plugin keamanan atau pembatasan REST API memblokir permintaan editor. Periksa pengaturan plugin keamanan dan pastikan endpoint wp/v2 tidak diblokir. |
| Respons JSON rusak | Ada output lain sebelum JSON | Plugin atau tema mencetak teks, peringatan PHP, atau spasi sebelum respons JSON. Periksa log PHP dan nonaktifkan plugin yang dicurigai satu per satu. |
Dua catatan tambahan dari praktik lapangan. Pertama, error 401 rest_not_logged_in bersifat generik: kode yang sama bisa muncul untuk banyak penyebab berbeda, mulai dari kredensial yang salah sampai fitur Application Password yang dimatikan oleh plugin keamanan. Karena itu, jangan hanya membaca kode errornya; periksa juga apakah bagian Application Password muncul di profil pengguna dan apakah situs memakai HTTPS. Kedua, saat editor blok gagal menyimpan dengan pesan yang samar, penyebabnya sering kali adalah plugin keamanan yang memblokir REST API. Sebelum menyalahkan hosting atau tema, periksa pengaturan plugin keamanan Anda — beberapa di antaranya memiliki opsi untuk membatasi REST API yang aktif secara default.
Kapan REST API Bukan Jawaban yang Tepat
REST API adalah alat yang kuat, tetapi bukan alat untuk semua pekerjaan. Mengetahui kapan tidak memakainya sama pentingnya dengan mengetahui cara memakainya.
Pertama, untuk pekerjaan satu kali yang sederhana — mengubah satu artikel, mengunggah satu gambar, memperbaiki satu kategori — dasbor WordPress selalu lebih cepat daripada menulis skrip. REST API baru menghemat waktu ketika pekerjaan itu berulang atau melibatkan banyak item.
Kedua, untuk operasi yang membutuhkan logika bisnis kompleks di dalam WordPress — misalnya aturan penerbitan yang bergantung pada banyak kondisi — plugin atau kode kustom di dalam WordPress sering kali lebih tepat daripada skrip eksternal yang memanggil API berulang kali. API adalah antarmuka; logika yang rumit sebaiknya tinggal sedekat mungkin dengan data.
Ketiga, untuk situs yang sangat kecil dengan satu penulis dan volume artikel rendah, investasi membangun integrasi API mungkin tidak sebanding dengan manfaatnya. Waktu Anda lebih baik dipakai untuk menulis artikel yang bagus daripada membangun dasbor yang tidak pernah dibuka.
Keempat, REST API bukan pengganti backup. Meskipun Anda bisa mengambil semua artikel lewat API, hasil ekspor API tidak mencakup semua hal — misalnya pengaturan tema, widget, dan sebagian data plugin — sehingga tidak bisa dipakai sebagai pengganti backup lengkap. Tetap jalankan backup otomatis seperti yang dijelaskan pada artikel backup WordPress di situs ini.
Checklist Sebelum Memakai REST API di Situs Produksi
Gunakan checklist berikut sebelum integrasi API pertama Anda menyentuh situs produksi:
- Situs sudah memakai HTTPS dan sertifikatnya valid.
- Akun yang dipakai untuk integrasi memiliki peran seminimal mungkin untuk tugasnya.
- Application Password dibuat dengan nama yang jelas dan disimpan di tempat yang aman, bukan di dokumen yang dibagikan.
- Uji pertama dilakukan di situs staging, atau setidaknya dimulai dengan permintaan baca yang aman.
- Skrip hanya membuat draf, bukan menerbitkan langsung; penerbitan tetap diputuskan manusia.
- Skrip memvalidasi data sebelum mengirim dan mencatat setiap tindakan yang dilakukannya.
- Pengambilan data memakai
per_pageyang wajar dan membaca headerX-WP-TotalsertaX-WP-TotalPagesuntuk paginasi. - Kredensial tidak ada di kode sisi klien, repositori publik, atau tangkapan layar.
- Daftar Application Password ditinjau berkala dan kredensial yang tidak dipakai dicabut.
- Editor blok dan plugin utama sudah diuji tetap berfungsi setelah integrasi dipasang.
FAQ
Apakah WordPress REST API gratis?
Ya. REST API adalah bagian dari inti WordPress sejak versi 4.7 dan tidak memerlukan plugin berbayar atau langganan apa pun. Yang Anda butuhkan hanyalah situs WordPress dengan HTTPS dan akun dengan peran yang sesuai. Biaya yang mungkin timbul hanyalah biaya pengembang bila Anda menyewa orang untuk membangun integrasi kustom.
Apakah saya harus bisa pemrograman untuk memakai REST API?
Untuk sekadar melihat data, tidak. Anda bisa membuka alamat /wp-json/wp/v2/posts di browser dan melihat artikel Anda dalam format JSON tanpa menulis kode. Untuk otomasi — membuat draf, sinkronisasi, pelaporan — Anda membutuhkan seseorang yang bisa menulis skrip, atau alat no-code yang sudah mendukung konektor WordPress. Sebagai publisher, yang perlu Anda kuasai adalah konsepnya dan keputusan keamanannya; implementasi teknisnya bisa didelegasikan.
Apakah REST API membuat situs saya tidak aman?
Tidak dengan sendirinya. Membaca artikel terbit lewat API sama terbukanya dengan membaca halaman arsip situs Anda — itu memang data publik. Yang harus diamankan adalah operasi tulis dan data privat, dan itu sudah dilindungi oleh autentikasi dan sistem peran WordPress. Risiko muncul bila kredensial dibagikan sembarangan, memakai akun administrator untuk tugas sepele, atau memakai HTTP tanpa enkripsi. Ikuti praktik keamanan pada artikel ini dan risiko tersebut bisa ditekan.
Mengapa editor blok saya gagal menyimpan dan apa hubungannya dengan REST API?
Editor blok menyimpan artikel melalui REST API. Jika plugin keamanan memblokir endpoint REST API, atau ada kode yang merusak respons JSON, editor tidak bisa menyimpan dan biasanya menampilkan pesan error yang samar. Periksa pengaturan plugin keamanan Anda, pastikan endpoint wp/v2 tidak diblokir, dan periksa log error PHP bila masalah berlanjut. Jangan menonaktifkan REST API sebagai “solusi”, karena itu justru mematikan editor.
Bisakah saya memakai REST API untuk memindahkan artikel antar situs?
Bisa, dengan batasan. Anda dapat mengambil artikel dari situs lama lewat GET dan membuatnya di situs baru lewat POST, termasuk kategori, tag, dan gambar unggulan bila ID medianya dipetakan dengan benar. Namun, untuk migrasi situs secara menyeluruh — termasuk pengaturan, pengguna, dan riwayat — alat migrasi khusus atau ekspor-impor WordPress bawaan biasanya lebih lengkap dan lebih aman. REST API paling cocok untuk sinkronisasi sebagian atau migrasi konten yang selektif.
Apa bedanya Application Password dengan kata sandi akun WordPress saya?
Kata sandi akun dipakai untuk login interaktif ke dasbor wp-admin. Application Password adalah kredensial terpisah yang hanya berlaku untuk akses programatik lewat API, tidak bisa dipakai untuk login ke wp-admin, hanya ditampilkan sekali saat dibuat, dan bisa dicabut satu per satu tanpa mengubah kata sandi utama. Memakai Application Password berarti alat pihak ketiga tidak pernah memegang kata sandi utama Anda.
Kesimpulan
WordPress REST API adalah salah satu bagian WordPress yang paling sering dipakai tanpa disadari: setiap penyimpanan di editor blok adalah panggilan REST API, dan setiap integrasi modern — dari aplikasi seluler sampai alat redaksi — berdiri di atasnya. Memahami cara kerjanya memberi Anda tiga keuntungan praktis: Anda bisa mendiagnosis masalah editor dengan lebih cepat, Anda bisa menilai tawaran pengembang dan plugin dengan lebih kritis, dan Anda bisa membangun otomasi editorial yang benar-benar menghemat waktu.
Kuncinya adalah memakai REST API dengan disiplin yang sama seperti disiplin editorial lainnya. Gunakan Application Password, bukan kata sandi utama; beri setiap alat kredensialnya sendiri dengan peran seminimal mungkin; selalu lewat HTTPS; biarkan otomasi menyiapkan draf dan biarkan manusia yang memutuskan penerbitan; dan jangan pernah mematikan REST API demi alasan keamanan semu. Mulailah dari yang paling aman — membaca data untuk laporan — lalu naik satu tingkat ke pembuatan draf, dan hanya setelah alur itu terbukti stabil, pertimbangkan integrasi yang lebih dalam.
Untuk langkah berikutnya yang konkret: buka https://situsanda.com/wp-json/ di browser hari ini dan lihat sendiri struktur API situs Anda. Kemudian buat satu Application Password untuk satu keperluan kecil, misalnya skrip laporan mingguan, dan uji dengan permintaan baca yang aman. Dari sana, Anda akan tahu persis seberapa jauh REST API bisa membantu redaksi Anda — tanpa mengambil risiko yang tidak perlu.
Sumber resmi yang dirujuk
- WordPress Developer Resources — REST API Handbook: Key Concepts (route, endpoint, namespace, dan konsep dasar REST API). https://developer.wordpress.org/rest-api/key-concepts/
- WordPress Developer Resources — REST API Handbook: Routes and Endpoints (contoh metode GET, PUT, dan DELETE pada route artikel). https://developer.wordpress.org/rest-api/extending-the-rest-api/routes-and-endpoints/
- WordPress Developer Resources — REST API Handbook: Pagination (parameter
per_page1 sampai 100, headerX-WP-TotaldanX-WP-TotalPages). https://developer.wordpress.org/rest-api/using-the-rest-api/pagination/ - WordPress Developer Resources — Advanced Administration Handbook: Application Passwords (diperkenalkan di WordPress 5.6, hanya untuk akses programatik, tidak bisa dipakai login wp-admin, HTTPS wajib, ditampilkan hanya sekali). https://developer.wordpress.org/advanced-administration/security/application-passwords/
- WordPress Learn — The WordPress REST API (pengantar REST API, REST API sebagai fondasi editor blok, dan contoh route serta endpoint). https://learn.wordpress.org/lesson/the-wordpress-rest-api/
- WordPress Developer Resources — REST API Handbook: Adding Custom Endpoints (pendaftaran route kustom dengan
register_rest_route()dan namespacevendor/v1). https://developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/