Penjelasan REST API WordPress untuk Pemula

Ketika Anda ingin belajar WordPress lebih banyak, Anda pasti akan menemukan istilah WordPress REST API.  Telah terbukti bahwa bagian dari inti WordPress ini dapat menjadikan WordPress platform modern dan dinamis.

Nah, pada artikel ini, kita akan membahas semua hal tentang API WordPress.

Tidak hanya artinya, kami juga akan menjelaskan cara kerjanya dan memberikan panduan dasar untuk API WordPress yang mudah dipahami oleh pemula.

Tanpa menunda Iagi, mari kita mulai!

Apa itu REST API WordPress?

Sebelum Anda menjelaskan apa itu REST API, Anda harus terlebih dahulu mengetahui apa arti API.

API atau Application Programming Interface adalah antarmuka yang dapat menghubungkan dua aplikasi untuk dapat berkomunikasi dengan mudah. Ini bisa berupa situs web, aplikasi seluler, aplikasi web, atau lainnya.

Anda dapat membayangkan API ini sebagai pelayan di restoran yang menghubungkan tamu dan koki di dapur.

Nah, REST API WordPress adalah jenis API. REST (Representational State Transfer) API menggunakan perangkat lunak koneksi  melalui HTTP dalam proses pertukaran data.

Dengan API WordPress, mengembangkan situs web WordPress bisa lebih mudah karena pengembang tidak perlu membangun aplikasi dengan fitur dan tujuan yang sama dari awal.

Misalnya, Anda dapat menginstal Google Maps API di situs web Anda. Anda akan mendapatkan semua fitur dan data Google Maps tanpa harus membuat aplikasi peta Anda sendiri.

Nah, API harus memenuhi persyaratan berikut untuk dianggap RESTful:

  • Antarmuka seragam : URL yang digunakan untuk mengakses sistem harus seragam, konsisten, dan dapat diakses melalui pendekatan umum seperti GET.
  • Server dan klien terpisah : Tujuannya adalah agar keduanya berkembang secara mandiri. Juga, jika ada perubahan sisi server, aplikasi dapat diakses dengan cara yang sama.
  • Kondisi server tidak berubah : Server tetap dalam keadaan yang sama ketika ada permintaan API baru karena tidak perlu menyimpan permintaan.
  • Caching – Semua sumber daya harus dapat di-cache untuk kinerja tinggi. Baik dari sisi server maupun klien.
  • Sistem berlapis : Antara permintaan klien dan otentikasi server, ada beberapa lapisan yang memisahkannya. Baik itu lapisan keamanan, lapisan cache, atau lapisan dengan fungsi lain.

WP REST API adalah format API yang memungkinkan Anda mengintegrasikan berbagai elemen WordPress dengan aplikasi dan server dari luar menggunakan JSON.  Jadi, Anda perlu memahami dasar-dasar WordPress, JavaScript,  dan JSON terlebih dahulu.

Manfaat REST API WordPress

Berikut adalah beberapa manfaat dari WP REST API untuk WordPress secara keseluruhan:

  • Jadikan WordPress terlihat lebih modern dan lebih mudah digunakan. Contohnya adalah dengan penampilan editor Gutenberg.
  • Menjadi tautan yang lebih universal untuk berbagai bahasa pemrograman
  • Jadikan pengembangan WordPress lebih fleksibel dengan standar sistem yang lebih sederhana
  • Mengembangkan situs web WordPress lebih mudah dengan integrasi konten sederhana
  • Lebih mudah dari sebelumnya untuk mendapatkan berbagai pilihan aplikasi untuk digunakan di WordPress

Cara kerja REST API WordPress

Sebelum WordPress versi 4.4, Anda harus menggunakan plugin jika ingin mengakses API WordPress. Tapi sekarang, REST API WordPress telah menjadi bagian inti dari WordPress.

Nah, untuk memanggil REST API, ada empat jenis metode HTTP yang bisa Anda gunakan, yaitu:

  • GET — Mengambil informasi dari server. Misalnya, ketika Anda mengunjungi halaman login wordPress, browser Anda akan mengirimkan permintaan GET ke server. Kemudian, server akan memprosesnya menggunakan API.
  • POST — Mengirim informasi ke server. Misalnya, setelah berhasil login ke halaman admin WordPress, Anda akan membuat permintaan untuk memasukkan data dalam bentuk posting artikel.
  • PUT — Digunakan untuk mengedit dan memperbarui data yang ada. Misalnya, ketika Anda ingin mengubah kata sandi Anda.
  • DELETE — Dapat digunakan untuk menghapus informasi. Misalnya, ketika Anda ingin menghapus akun yang ada di dalam admin WordPress.

Peta jalan untuk menggunakan REST API

Dalam panduan ini, kita akan menggunakan antarmuka baris perintah (CLI) Windows, yaitu Putty.  Jika Anda menggunakan MacOS dan Linux, Anda dapat membuka Terminal.

Sebagai langkah pertama, salin alamat IP server Anda menggunakan  perintah SSH. Namun, kami sarankan Anda menggunakan WordPress situs demo atau localhost. Jika terjadi kesalahan, agar tidak mengganggu situs web utama Anda.

  1. Pahami perintah dasar REST API

Dalam panduan ini kita akan menggunakan beberapa perintah REST API sebagai berikut:

  • Jalur dan titik akhir: Jalur adalah URL yang dapat Anda tetapkan ke berbagai metode HTTP. Sedangkan endpoint adalah koneksi antar HTTP. Contohnya adalah /wp-json/ yang berisi semua jalur dan titik akhir.
  • Permintaan: Digunakan untuk menyimpan dan mengambil informasi dari kode WP_REST_Request.
  • Respons: Perintah ini menyediakan data yang diminta, atau juga dapat memberikan lokasi pesan kesalahan. Dengan begitu, Anda tahu di mana kesalahannya.
  • Skema: Menampilkan daftar properti dan properti input yang dapat diterima dan dikembalikan oleh REST API.
  • Kelas handler: Perintah ini adalah lokasi di mana REST API dikelola.
  1. Ketahui perintah ENDPOINT menggunakan REST API WordPress

Dalam panduan REST API ini, kita akan menggunakan beberapa ENDPOINT REST API yang dapat Anda coba:

Pertama-tama, Anda perlu memanggil HTTP ke REST API dengan mengakses browser dan masukkan tautan berikut:

Situs web http://Nama_Domain_Anda.com/wp-json/

Output dari perintah sebelumnya adalah tampilan pesan HTTP sebagai berikut:

Anda kemudian dapat mengulangi perintah ini menggunakan beberapa ENDPOINTS.

Kali ini, kita akan menggunakan perintah GET curl untuk mengambil daftar file JSON dari posting WordPress Anda. Untuk menjalankan perintah GET, Anda dapat menggunakan perintah berikut:

curl -X DAPATKAN -i http://Nama_Domain_Anda.com/wp-json/wp/v2/posts

Atau, Anda juga dapat mencoba perintah ini untuk memeriksa semua halaman di situs WordPress Anda:

curl -X GET -i http://Nama_Domain_Anda.com/wp-json/wp/v2/pages

Peta jalan untuk autentikasi REST API

Data dalam REST API WordPress bersifat publik. Sementara beberapa situs WordPress mengharuskan Anda untuk masuk sebagai administrator WordPress.

Nah, untuk mengatasi masalah ini, Anda harus mengautentikasi akun WordPress Anda dengan server.

Tujuannya adalah agar Anda dapat membuat permintaan apa pun sebagai administrator. Misalnya, melihat konten yang tidak dipublikasikan atau memposting pembaruan di situs web.

Dalam tutorial ini, kita akan menggunakan plugin REST API – OAuth WordPress. Plugin ini adalah plugin khusus pengembang yang membantu Anda mempelajari REST API.  Tapi, plugin ini tidak ditujukan untuk situs web langsung atau online, ya.

Berikut langkah-langkahnya:

  1. Buka dasbor WordPress Anda dan buka   menu Plugin > Tambahkan plugin pencarian > Baru “WP REST API – OAuth“.
  2. Kemudian klik Instal dan Aktifkan.
  3. Setelah REST API WordPress diinstal, buka CLI dan autentikasi ke REST API dengan pengguna WordPress Anda. Berikut adalah contoh cara menerapkan metode otentikasi pengguna, menggunakan curl untuk melihat posting yang tidak dipublikasikan.

curl –user username_WordPress:Password_WordPress -i http://Domain_Anda.com/wp-json/wp/v2/posts?status=draft

  1. Temukan posting blog menggunakan REST API WordPress

Sekarang pahami cara membuat permintaan ke REST API menggunakan perintah curl. Jadi, Anda dapat melanjutkan dengan cara memilih posting WordPress tertentu menggunakan perintah berikut.

Pertama, lihat semua posting dalam situs WordPress Anda menggunakan perintah berikut:

curl -X DAPATKAN -i http://Domain_Anda.com/wp-json/wp/v2/posts

Kemudian, Anda akan diberikan tampilan JSON seperti pada gambar di bawah ini.  Cukup pilih salah satu ID penerbitan yang akan Anda lihat.

Kedua, setelah Anda memilih ID publikasi, masukkan perintah berikut dengan menambahkan ID terbitkan ke akhir perintah curl:

curl -X DAPATKAN -i http://Domain_Anda.com/wp-json/wp/v2/posts/ID

Anda dapat menggunakan perintah di atas untuk memilih ID posting, kategori, halaman, komentar, dan lainnya yang disediakan oleh ENDPOINT untuk REST API WordPress.

  1. Perbarui judul posting menggunakan REST API

Kemudian, kami akan memperbarui posting WordPress menggunakan REST API.

Dalam panduan ini, kami akan mencoba mengganti nama judul artikel menggunakan perintah POST. Jadi, pastikan untuk menambahkan ID publikasi artikel ke perintah POST, ya!

Anda kemudian dapat memasukkan perintah berikut pada baris perintah. Jangan lupa untuk menyesuaikan ID postingan dan judul artikel yang ingin diubah.

curl -X POST –user username_WordPress:password_WordPresss http://Nama_Domain.com/wp-json/wp/v2/posts/IDPost -d ‘{“title”:”Judul Blog Baru”}’

Setelah itu, pastikan Anda telah berhasil mengubah judul artikel menggunakan ID publikasi yang dipilih. Caranya adalah dengan memverifikasi ID posting menggunakan perintah berikut:

ikal -X GET -i http://DomainAnda.com/wp-json/wp/v2/posts/PostID

Dan… Yakin! Anda telah berhasil mempelajari panduan dasar menggunakan REST API WordPress. Jika Anda ingin mempelajari lebih lanjut, Anda bisa mendapatkannya di dokumen REST API.

Kesimpulan

Wah, ternyata REST API memiliki banyak sekali manfaat untuk website WordPress, ya?

Tidak hanya membuat WordPress lebih kaya akan fitur dan konten, WP REST API juga membuat pengembangan WordPress lebih mudah. Jadi pengembang dapat menyuntikkan berbagai fitur canggih yang membuatnya lebih mudah untuk menggunakan WordPress secara keseluruhan.

Oh ya, meskipun panduan dalam artikel ini hanyalah dasar-dasarnya, kami harap ini masih dapat membantu Anda mengenal REST API WordPress secara lebih mendalam. Terutama untuk cara kerjanya dan penggunaan perintah dasarnya di situs web Anda sendiri.

Itulah pembahasan mengenai panduan REST API WordPress untuk pemula. Semoga artikel ini bermanfaat untuk anda, ya! Jika kamu memiliki pertanyaan, jangan ragu untuk meninggalkan pertanyaan di kolom komentar yang disediakan. Selamat tinggal!

Comments

No comments yet. Why don’t you start the discussion?

Leave a Reply