REST API

Penulis: Nurlaila Fitriani

20 Oktober 2022 6 minutes read

Editor: M. Zakaria, S.Kom

Apa itu REST API?

REST API adalah singkatan dari Representational State Transfer Application Programming Interface. REST sendiri merupakan standar arsitektur bebbasis web yang menggunakan protokol HTTP ketika ingin berkomunikasi data. Sementara, API adalah protokol yang bisa digunakan antar aplikasi untuk saling berkomunikasi satu dengan yang lainnya. Fungsinya ini bertukar data antar aplikasi meski tidak terhubung secara lansgung.

REST API ini bisa juga dikatakan sebagai seperangkat pedoman yang bisa digunakan oleh software untuk berkomunikasi melalui internet untuk membuat proses integrasi menjadi sederhana. REST API juga bisa disebut resful API.

Dengan kata lain, jika Anda ingin berinteraksi dengan komputer atau sistem untuk mengambil informasi atau menjalankan suatu fungsi, API akan membantu Anda mengomunikasikan apa yang Anda inginkan ke sistem tersebut sehingga sistem dapat memenuhi dan memahami permintaan Anda.

API juga bisa dianggap sebagai mediator antara penggunanya dan sumber daya atau layanan web ayng ingin mereja dapatkan. Ini juga merupakan cara bagi organisasi untuk berbagi sumber daya dan informasi namun tetap mempertahankan keamanan, kontrol, dan autentikasi untuk menentukan siapa yang mendapatkan akses ke apa.

Salah satu keuntungan yang bisa Anda dpaatkan dari API yakni ANda tidak perlu mengetahui secara spesifik caching atau bagaimana sumber daya Anda diambil atau dari mana asalnya. Untuk Anda yang ingin mengetahui lebih lanjut mengenai REST API, simak penjelasannya di bawah ini.

Cara Kerja REST API

Untuk Anda yang sudah mengetahui pengertian REST API, Anda juga perlu mengetahui bagaimana cara kerja dari REST API. Cara kerjanya dimulai dari client yang menggunakan perangkat baik mobile ataupun desktop dengan membuat web.

Setelah itu, client memasukkan data/instruksi kepada REST API. Biasanya client menggunakan HTTP request pada server dengan URLs atau Global ID. Setelah itu, server akan memberikan respon lalu mengirimkannya kembali HTTP yang sebelumnya dimasukkan oleh client. Data ini akan berubah format menjadi text, XML, dan JSON oleh server.

Komponen REST API

RST API memiliki beberapa komponen yang tergabung di dalamnya :

1. URL Design

Komponen pertama dari REST API ialah URL Design. Pasalnya, REST API ini diakses menggunakan protokol HTTP. Penamaan serta struktur URL yang kondisiten akan menghasilkan API yang baik serta mudah dimengerti oleh developer. URL API ini biasanya disebut dengan endpoint dalam sebutannya.

2. HTTP Verbs

Biasanya ada beebrapa HTTP Verbs yang digunakan oleh client untuk membuat request. Berikut ini daftar request yang diminta client :

• GET : Metode HTTP request yang digunakan untuk membaca atau mendapatkan data dari sumber. Metode yang satu ini merupakan request yang paling mudah.
• POST : Metode POST adalah metode request yang digunakan untuk membuat data baru dengan menyisipkan data di dalam body saat request dilakukan oleh client.
• PUT : Metode HTTP request yang digunakan untuk melakukan update data resource.
• DELETE : Metode HTTP request yang digunakan untuk menghapud data pada resource.

3. HTTP Response Code

HTTP Response Code merupakan kode standarisasi dalam menginformasikan hasil request kepada client. Biasanya ada tiga kelompok dalam REST API, diantaranya :

• 2XX : response code yang menampilkan bahwa request client berhasil.
• 4XX : response code yang menampilkan bahwa request client mengalami kesalahan dari client.
• 5XX : response code yang menampilkan bahwa request mengalami kesalahan dari server.

4. Format Response

Setiap request yang dilakukan oleh client ini akan menerima data response dari server. Nah, response ini biasanya berupa XML atau JSON. Setelah mendapatkan data ini, client bisa menggunakannya dengan cara memparsing data ini sesuai dengan kebutuhannya.

Contoh Membuat REST API Sederhana

Ada tiga cara yang bisa Anda lakukan untuk membuat REST API sederhana, diantaranya :

1. Ekstrak file codeigniter

Langkah pertama yang harus Anda lakukan jika ingin membuat REST API sederhana yakni mendownload file codeigniter. Setelah itu, Anda bisa ekstrak file codeigniter yang sudah di download untuk menghasilkan folser Codelgniter. Setelah itu rename folder tersbeut menjadi restCI.

2. Instal Library REST API Codeigniter

Setelah selesai ekstrak file codeigniter, langkah selanjutnya adalah instal library REST API codeigniter. Anda bisa menggunakan program library open source untuk proses instalasi Anda bisa tools bernama composer. Setelah itu, ketik perintah di terminal MacOS ataupun Linux atau CMD. Lalu, masuk ke folder vendor/codeigniter/restserver setelah itu copy paste beberapa file yang memang dibutuhkan ke dalam folder restCI. Berikut ini beberapa file tersebut :

• config (folder) : *Idap.php, *rest.php
• helper (folder) : *db_helper.php
• langunange (folder) : *english (folder)
• libraries (folder) : *Format.php, *REST_Controller.php
• Pindahkan file yang sudah di copy ke restCI ke localhost XAMPP

3. Testing folder restCI

Selanjutnya, munculkan folder yang tadi sudah di copy via localhost pada web browser dengan URL localhost/restCI. Setelah itu, muncul juga file library dari REST API, REST API namun Anda perlu membuat file terlebih dahulu file controllernya.

4. Membuat controller untuk testing library REST API

Untuk membuat controller, Anda hanya tinggal masuk ke folder restCI/application/controller kemudian membuat file dengan nama Test.Api.php. Setelah itu, buat skrip seperti di bawah ini :

<?php
// import library dari REST_Controller
require APPPATH . 'libraries/REST_Controller.php';
// extends class dari REST_Controller
class TestApi extends REST_Controller{
// constructor
public function __construct(){
parent::__construct();
}
public function index_get(){
// testing response
$response['status']=200;
$response['error']=false;
$response['message']='Hai from response';
// tampilkan response
$this->response($response);
}
public function user_get(){
// testing response
$response['status']=200;
$response['error']=false;
$response['user']['username']='erthru';
$response['user']['email']='ersaka96@gmail.com';
$response['user']['detail']['full_name']='Suprianto D';
$response['user']['detail']['position']='Developer';
$response['user']['detail']['specialize']='Android,IOS,WEB,Desktop';
//tampilkan response
$this->response($response);
}
}
?>

5. Mulai testing web broser

Setelah membuat skrip seperti di atas, langkah selanjutnya adalah mengetes skrip tersebut menggunakan web browser. Caranya dengan memasukkan fungsi index melalui browser dengan url sebagai berikut : localhost/restCI/index.php/testapi/user.

Kelebihan REST API

Jika dibandingkan dengan teknologi yang lain, REST API menawarkan banyak kelebihan, diantaranya :

• Cocock digunakan untuk penggunaan internet yang efisien.
• Hanya menggunakan sedikit bandwith.
• Dapat dibangun dengan bahasa pemrograman Javascrip atau Python.
• Memungkinkan terhubung dengan layanan cloud yang lebih flesibel.
• Menggabungkan teknologi web yang ada sehingga lebih mudah untuk digunakan.
• Dapat diskala di mana REST API lebih cepat menangani peningkatan jumlah varian serta varian permintaan.
• Lebih mudah dibandingkan dengan SOAP.
• Mudah untuk dipelajari.

Kekurangan REST API

Diantaranya kelebihan yang sudah Anda ketahui tentang REST API, ternyata, REST API juga memiliki beberapa kekurangan, diantaranya :

• Waktu akses data yang biasanya lebih lama dibandingkan dengan native library.
• Lebih rentang dengan serangan keamanan karen aharus melewati protokol HTTP.

Nah, itulah penjelasan singkat mengenai REST API. Dapat disimpulkan bahwa REST API ini merupakan protokol yang memungkinkan Anda membangun dan mengintegrasikan perangkat lunak aplikasi. Cara kerja REST API sangat sederhana seperti yang bisa Anda lihat penjelasannya di atas. Ada pula beberapa komponen dari REST API, serta apa saja kelebihan dan kelemahannya. Semoga bermanfaat.