WordPress REST API: Apa Artinya dan Cara Memulai Penggunaannya

Jika Anda telah menghabiskan waktu di komunitas WordPress selama beberapa tahun terakhir, kemungkinan Anda telah mendengar referensi dibuat untuk REST API baru. Namun, kecuali jika Anda adalah pengembang yang berpengalaman, Anda mungkin tidak tahu apa itu sebenarnya API WordPress REST.


Meskipun detail teknisnya sedikit rumit, konsep dasar di balik fitur ini cukup mudah untuk dipahami. API baru membantu memperluas apa yang bisa dilakukan WordPress sebagai platform. Terlebih lagi, API REST membuatnya lebih sederhana dari sebelumnya bagi pengembang untuk menghubungkan WordPress dengan situs dan aplikasi lain.

API REST WordPress

Dalam panduan komprehensif ini, kami akan memandu Anda melalui semua dasar-dasar yang perlu Anda ketahui. Kami akan menjelaskan apa itu API secara umum, dan apa REST API (dan versi khusus WordPress) pada khususnya. Lalu, kita akan berbicara tentang bagaimana memulai menggunakan API REST WordPress sendiri. Ayo lompat masuk!

Pengantar Antarmuka Pemrograman Aplikasi (API)

Sebelum kita mempelajari REST API secara khusus, mari kita buat cadangan sedikit. Untuk memahami konsep ini, penting untuk pertama-tama memiliki gagasan dasar tentang apa API secara umum.

Pada tingkat yang paling mendasar, API – atau Antarmuka Pemrograman Aplikasi – memungkinkan dua aplikasi untuk berkomunikasi satu sama lain. Misalnya, ketika Anda mengunjungi situs web, browser Anda mengirimkan permintaan ke server tempat situs itu berada. API server itu adalah yang menerima permintaan browser Anda, mengartikannya, dan mengirim kembali semua data yang diperlukan untuk menampilkan situs Anda.

Ada banyak lagi yang harus dilakukan cara API bekerja dalam arti teknis, tentu saja. Namun, kami akan fokus pada apa yang paling penting bagi Anda – aplikasi praktis. API telah mendapatkan banyak perhatian dan visibilitas, karena banyak perusahaan telah mulai mengemasnya dan menyediakannya sebagai produk yang dapat Anda gunakan.

Dengan kata lain, pengembang di perusahaan seperti Google akan mengumpulkan beberapa bagian dari kode aplikasi mereka bersama-sama, dan membuatnya tersedia untuk umum. Dengan begitu, pengembang lain dapat menggunakan API sebagai alat untuk membantu situs mereka sendiri terhubung ke Google dan memanfaatkan fitur-fiturnya:

Perpustakaan API Google.

Misalnya, Anda dapat menggunakan Google Maps API untuk tempatkan peta yang berfungsi penuh di situs Anda yang mendapat manfaat dari semua data dan fitur Google yang relevan. Ini menghemat Anda dari keharusan membuat kode peta dan mengumpulkan semua data itu sendiri. Hal yang sama berlaku untuk berbagai situs dan aplikasi.

Karena situs web dan fungsionalitas yang mereka andalkan menjadi lebih kompleks, alat seperti API menjadi sangat penting. Mereka memungkinkan pengembang untuk membangun fungsionalitas yang ada, sehingga memungkinkan untuk hanya ‘memasukkan’ fitur baru ke situs web Anda. Pada gilirannya, situs yang memiliki manfaat API dari paparan yang meningkat dan lalu lintas.

Aturan dasar API REST (Representational State Transfer)

Ada banyak cara untuk membuat API. SEBUAH API REST (Representational State Transfer) adalah jenis tertentu yang dikembangkan mengikuti aturan khusus. Dengan kata lain, REST menyajikan serangkaian pedoman yang dapat digunakan pengembang saat membuat API. Ini memastikan bahwa API berfungsi secara efektif.

Untuk memahami cara kerja REST APIs, Anda perlu mengetahui aturan apa (atau ‘kendala’) yang berfungsi di bawahnya. Ada lima elemen dasar yang membuat API ‘RESTful’. Ingatlah bahwa ‘server’ adalah platform milik API, dan ‘klien’ adalah situs, aplikasi, atau perangkat lunak yang terhubung ke platform itu:

Tenang

  1. Arsitektur client-server. API harus dibangun sehingga klien dan server tetap terpisah satu sama lain. Dengan begitu mereka dapat terus berkembang sendiri, dan dapat digunakan secara mandiri.
  2. Kewarganegaraan. API REST harus mengikuti protokol ‘stateless’. Dengan kata lain, mereka tidak dapat menyimpan informasi apa pun tentang klien di server. Permintaan klien harus mencakup semua data yang diperlukan di muka, dan respons harus menyediakan semua yang dibutuhkan klien. Ini membuat setiap interaksi menjadi ‘satu dan selesai’, dan mengurangi kebutuhan memori dan potensi kesalahan.
  3. Cacheability. A ‘cache’ adalah penyimpanan sementara dari data tertentu, sehingga dapat diambil dan dikirim lebih cepat. RESTful APIs menggunakan data yang dapat di-cache bila memungkinkan, untuk meningkatkan kecepatan dan efisiensi. Selain itu, API perlu memberi tahu klien jika setiap bagian data dapat dan harus di-cache.
  4. Sistem berlapis. REST API yang dirancang dengan baik dibangun menggunakan lapisan, masing-masing dengan fungsi yang ditentukan sendiri. Lapisan-lapisan ini berinteraksi, tetapi tetap terpisah. Ini membuat API lebih mudah untuk dimodifikasi dan diperbarui dari waktu ke waktu, dan juga meningkatkan keamanannya.
  5. Antarmuka yang seragam. Semua bagian dari API REST perlu berfungsi melalui antarmuka yang sama, dan berkomunikasi menggunakan bahasa yang sama. Antarmuka ini harus dirancang khusus untuk API dan dapat berkembang sendiri. Seharusnya tidak tergantung pada server atau klien untuk berfungsi.

API apa pun yang mengikuti prinsip-prinsip ini dapat dianggap TENANG. Ada juga batasan keenam, disebut sebagai ‘kode sesuai permintaan’. Ketika diikuti, teknik ini memungkinkan API menginstruksikan server untuk mengirimkan kode ke klien, untuk memperluas fungsinya. Namun, kendala ini bersifat opsional, dan tidak diadopsi oleh semua API REST.

API REST WordPress

Pada titik ini, Anda mungkin bertanya-tanya bagaimana semua ini mempengaruhi Anda. API adalah alat yang sangat baik, tetapi apakah relevan dengan pekerjaan Anda sehari-hari? Jika Anda adalah pengguna WordPress, jawabannya tidak diragukan "Iya".

API REST WordPress telah dikembangkan selama beberapa tahun sekarang. Untuk beberapa saat, itu bekerja sebagai sebuah plugin independen, dimana pengembang dapat berkontribusi sepanjang waktu tersedia bagi siapa saja untuk bereksperimen.

Bahkan ada dua versi terpisah plugin REST API. Elemen-elemen API ditambahkan ke platform inti sejak pembaruan 4.4. Ini diikuti olehnya menjadi sepenuhnya terintegrasi pada WordPress 4.7 (pada 2016). Ini berarti bahwa hari ini, WordPress memiliki REST API yang berfungsi penuh.

Mengapa platform membuat langkah ini? Berdasarkan situs proyek sendiri, itu karena WordPress sedang bergerak menuju menjadi a "kerangka kerja aplikasi yang lengkap". Dengan kata lain, REST API memungkinkan platform untuk berinteraksi dengan hampir semua situs dan aplikasi web. Selain itu, dapat berkomunikasi dan bertukar data terlepas dari bahasa apa yang digunakan oleh program eksternal.

beristirahat api

Ini membuka banyak kemungkinan bagi pengembang. Itu juga menjadikan WordPress sebagai platform yang lebih fleksibel dan universal dari sebelumnya. Sebagai Katie Keith, Direktur Operasi di PT Barn2 Media katakan:

Dengan memahami REST API, pengembang WordPress dapat memilih cara yang paling efektif untuk mengimplementasikan setiap tugas, tanpa terbatas pada teknologi atau platform tertentu seperti PHP atau WordPress. Digunakan secara efektif, REST API membuat integrasi pihak ketiga menjadi lebih mudah … Bahkan membuka peluang baru, misalnya untuk membuat aplikasi seluler berbasis WordPress Anda sendiri, atau menjelajahi cara-cara baru dan unik untuk berkomunikasi dengan WordPress.

Penting juga untuk dicatat bahwa Anda mungkin mendengar fitur ini kadang-kadang disebut sebagai WordPress JSON REST API. Bagian ‘JSON’, yang merupakan singkatan dari JavaScript Object Notation, menjelaskan format yang digunakan API ini untuk bertukar data. Format itu didasarkan pada JavaScript, dan merupakan cara populer untuk mengembangkan API berkat seberapa baik antarmuka dengan banyak bahasa pemrograman umum. Dengan kata lain, API JSON dapat lebih mudah memfasilitasi komunikasi antara aplikasi yang menggunakan berbagai bahasa.

Anatomi permintaan API REST WordPress

Anda sekarang harus memahami tujuan dan arah keseluruhan API REST WordPress. Karenanya, mari kita bahas beberapa hal spesifik tentang cara kerjanya. Ada beberapa konsep dasar yang perlu Anda pahami jika Anda ingin langsung dan mulai bereksperimen dengan API sendiri.

Seperti yang kami jelaskan, setiap API memproses permintaan dan mengembalikan respons. Dengan kata lain, klien memintanya untuk melakukan tindakan tertentu, dan API melakukan tindakan itu. Bagaimana tepatnya API melakukan ini dapat bervariasi. API REST dirancang khusus untuk menerima dan menanggapi jenis permintaan tertentu, menggunakan perintah HTML sederhana (atau ‘metode’).

Sebagai ilustrasi, inilah yang paling banyak metode HTML dasar dan penting klien dapat mengirim:

Metode HTML

  • DAPATKAN: Perintah ini mengambil sumber daya dari server (seperti sepotong data tertentu).
  • POS: Dengan ini, klien menambahkan sumber daya ke server.
  • TARUH: Anda dapat menggunakan ini untuk mengedit atau memperbarui sumber daya yang sudah ada di server.
  • MENGHAPUS: Seperti namanya, ini menghapus sumber daya dari server.

Seiring dengan perintah ini, klien akan mengirim satu atau lebih baris yang mengkomunikasikan dengan tepat sumber daya apa yang diinginkan dan apa yang harus dilakukan dengannya. Misalnya, permintaan untuk mengunggah file PHP ke folder tertentu di server mungkin terlihat seperti ini:

POST /foldername/my_file.php

Bagian /foldername/my_file.php adalah disebut ‘rute’, karena memberi tahu API ke mana harus pergi dan data untuk berinteraksi dengan apa. Ketika Anda menggabungkannya dengan metode HTTP (POST dalam kasus ini), seluruh fungsi disebut sebagai ‘titik akhir’.

Sebagian besar REST API dan klien yang berinteraksi dengannya jauh lebih rumit dari ini – termasuk versi WordPress. Namun, elemen-elemen dasar ini membentuk dasar untuk cara kerja REST API WordPress.

Cara mulai menggunakan WordPress REST API

Selama Anda sudah menyiapkan situs WordPress, Anda dapat langsung mulai bereksperimen dengan API REST. Anda dapat melakukan berbagai permintaan GET untuk mengambil data secara langsung, hanya dengan menggunakan browser Anda.

Untuk mengakses API REST WordPress, Anda harus mulai dengan rute berikut:

yoursite.com/wp-json/wp/v2

Kemudian, Anda dapat menambahkan ke URL ini untuk mengakses berbagai jenis data. Misalnya, Anda dapat mencari profil pengguna tertentu melalui rute seperti ini:

yoursite.com/wp-json/wp/v2/users/4567

Dalam skenario ini, "4567" adalah ID pengguna unik untuk profil yang ingin Anda lihat. Jika Anda meninggalkan ID itu, Anda akan melihat daftar semua pengguna di situs Anda:

Daftar pengguna di API REST WordPress.

Anda dapat menggunakan rute dasar yang sama untuk melihat tipe data lainnya, seperti posting atau halaman Anda. Anda bahkan dapat mencari himpunan bagian dari data yang memenuhi kriteria tertentu. Misalnya, Anda dapat mengambil semua pos yang menyertakan istilah tertentu menggunakan URL ini:

yoursite.com/wp-json/wp/v2/posts?=search[keyword]

Ini hanyalah ilustrasi sederhana, tentu saja. Hampir tidak ada batasan untuk apa yang dapat Anda lakukan dengan menggunakan WordPress REST API. Jika Anda ingin mempelajari lebih lanjut tentang cara kerjanya, sebaiknya mulai dengan sumber daya berikut:

  • Buku Pegangan API REST. Ini adalah sumber daya WordPress resmi yang mendokumentasikan segala macam informasi tentang REST API. Di antara hal-hal lain, Anda akan menemukan daftar titik akhir Anda dapat menggunakan, serta detail pada beberapa aspek struktural API REST yang belum kami sentuh di sini.
  • Tutorial W3Schools. Meskipun sumber daya ini bukan REST API-spesifik, ia menawarkan tutorial praktis yang dapat membantu Anda memoles konsep-konsep kunci, seperti Metode HTTP dan JSON.
  • Panduan Utama untuk API REST WordPress. E-book gratis ini dari WP Engine berisi banyak informasi dan contoh praktis. Plus, itu akan memandu Anda melalui bagaimana menyelesaikan beberapa tugas dasar (dan lebih maju).
  • Sementara kami melakukannya, periksa juga daftar 10 besar ini plugin untuk pengembang WordPress. Mereka pasti akan berguna saat Anda menjelajahi dunia REST API.

API WordPress REST tidak diragukan lagi adalah topik yang kompleks. Bahkan untuk non-pengembang, ada baiknya untuk memahami dasar-dasar bagaimana teknologi ini bekerja, dan apa yang memungkinkan. Terlebih lagi, itu bahkan memungkinkan Anda untuk mulai mencoba-coba pengembangan sendiri!

Satu lagi pendekatan dalam menggunakan WordPress REST API

WordPress REST API dapat digunakan untuk sejumlah hal dan proyek menarik. Kami telah membuktikannya dengan cukup jelas.

Namun, ada satu area di mana ia mendapatkan popularitas yang nyata:

WordPress tanpa kepala adalah ide memisahkan dua lapisan utama ekosistem WordPress – backend dan frontend.

Hal ini memungkinkan Anda untuk mengambil semua barang yang dimiliki oleh perangkat lunak WordPress dan menghubungkannya dengan produk akhir yang tidak menggunakan presentasi WordPress standar – ini bukan situs web, per.

Seluruh konsep ini sangat menarik. Kami membicarakannya lagi di pos lain, tempat kami membahas apakah WordPress tanpa kepala masuk akal, dan membandingkan solusi hosting WordPress tanpa kepala teratas di pasar.

Kesimpulan

Tidak ada waktu yang lebih baik untuk belajar tentang WordPress REST API daripada sekarang. Karena sudah sepenuhnya digabungkan ke dalam inti WordPress, itu akan memainkan peran penting di masa depan platform. Pengembang semua strip akan menggunakan API ini untuk menghubungkan WordPress ke web yang lebih luas dengan cara yang sebelumnya sulit atau tidak mungkin.

Memahami konsep ini untuk diri sendiri bisa sedikit menantang. Pada tingkat dasar, konsep-konsepnya cukup mudah untuk dipahami. REST API adalah antarmuka yang memungkinkan dua program untuk ‘berbicara’ satu sama lain, dan dibuat pedoman berikut yang memastikan itu fleksibel, dapat dikembangkan, dan aman. Jika Anda ingin mempelajari lebih dalam bagaimana semua ini bekerja dan bagaimana hal itu dapat digunakan, ada banyak sumber daya yang bermanfaat di luar sana, seperti pejabat buku pegangan.

Apakah Anda memiliki pertanyaan tentang API REST, dan apa artinya untuk WordPress? Tanyakan kepada kami di bagian komentar di bawah ini!

Jangan lupa untuk bergabung dengan kursus kilat kami tentang mempercepat situs WordPress Anda. Dengan beberapa perbaikan sederhana, Anda dapat mengurangi waktu loading hingga 50-80%:

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map