Pembelajaran REST dengan RESTfull API


REST ( Representational State Transfer) itu arsitektur sebuah software REST adalah singkatan dari Representational State Transfer

Ini adalah gaya arsitektur yang didirikan oleh Roy Fielding pada tahun 2000 dan dinyatakan dalam disertasi PhD-nya
Dia menyatakan: "menyediakan satu set kendala arsitektur yang, ketika diterapkan secara keseluruhan, menekankan skalabilitas interaksi komponen, umum antarmuka, penyebaran komponen independen, dan komponen perantara untuk mengurangi latensi interaksi, menegakkan keamanan, dan merangkum sistem warisan.", 
Sedangkan REST API merupakan implementasi dari API (Application Programming Interface). REST (Representional State Transfer) adalah suatu arsitektur metode komunikasi yang menggunakan protokol HTTP untuk pertukaran data dan metode ini sering diterapkan dalam pengembangan aplikasi. Dimana tujuannya adalah untuk menjadikan sistem yang memiliki performa yang baik, cepat dan mudah untuk di kembangkan (scale) terutama dalam pertukaran dan komunikasi data.

RESTful API memiliki 4 komponen penting di dalamnya diantaranya adalah

URL Design
HTTP Verbs
HTTP Response Code
Format Response
URL Design
RESTful API diakses menggunakan protokol HTTP. Penamaan dan struktur URL yang konsisten akan menghasilkan API yang baik dan mudah untuk dimengerti developer. URL API biasa disebut endpoint dalam pemanggilannya. Contoh penamaan URL / endpoint yang baik adalah seperti berikut :

/users
/users/1234
/users/1234/photos
/users/1234/photos/abc

HTTP Verbs
Setiap request yang dilakukan terdapat metode yang dipakai agar server mengerti apa yang sedang di request client, diantaranya yang umum dipakai adalah :

GET
GET adalah metode HTTP Request yang paling simpel, metode ini digunakan untuk membaca atau mendapatkan data dari sumber.
Contoh :
GET /users : Mengembalikan daftar user
GET /users/1234 : Mengembalikan data user dengan ID 1234

POST
POST adalah metode HTTP Request yang digunakan untuk membuat data baru dengan menyisipkan data dalam body saat request dilakukan.
Contoh :
POST /users : Membuat data user baru

PUT
PUT adalah metode HTTP Request yang biasanya digunakan untuk melakukan update data resource.
Contoh :
PUT /users/1234 : Mengupdate data user dengan ID 1234

DELETE
DELETE adalah metode HTTP Request yang digunakan untuk menghapus suatu data pada resource.
Contoh :
DELETE /users/1234 : Menghapus data user dengan ID 1234

Selain HTTP Verbs diatas, masih ada metode HEAD dan PATCH dalam HTTP Request, tetapi jarang sekali digunakan.

HTTP Response Code
HTTP response code adalah kode standarisasi dalam menginformasikan hasil request kepada client. Secara umum terdapat 3 kelompok yang biasa kita jumpai pada RESTful API yaitu :

2XX : adalah response code yang menampilkan bahwa request berhasil.
4XX : adalah response code yang menampilkan bahwa request mengalami kesalahan pada sisi client.
5XX : adalah response code yang menampilkan bahwa request mengalami kesalahan pada sisi server.

Dan berikut ini adalah response code yang biasa digunakan pada REST :

200 OK
Response code ini menandakan bahwa request yang dilakukan berhasil.

201 Created
Response code ini menandakan bahwa request yang dilakukan berhasil dan data telah dibuat. Kode ini digunakan untuk mengkonfirmasi berhasilnya request PUT atau POST.

400 Bad Request
Response code ini menandakan bahwa request yang dibuat salah atau data yang dikirim tidak ada.

401 Unauthorized
Response code ini menandakan bahwa request yang dibuat membutuhkan authentication sebelum mengakses resource.

404 Not Found
Response Code ini menandakan bahwa resource yang di dipanggil tidak ditemukan.

405 Method Not Allowed
Response code ini menandakan bahwa request endpoint ada tetapi metode HTTP yang digunakan tidak diizinkan.

409 Conflict
Response code ini menandakan bahwa request yang dibuat terdapat duplikasi, biasanya informasi yang dikirim sudah ada sebelumnya.

500 Internal Server Error
Response code ini menandakan bahwa request yang dilakukan terdapat kesalahan pada sisi server atau resource.

(Sumber : https://kudo.co.id/engineering/2016/09/15/mengenal-restful-api/)

Komentar

Posting Komentar

Postingan populer dari blog ini

Tutorial melakukan request REST API(GET,POST,PUT dan DELETE) menggunakan POSTMAN

Gambar
Postman adalah suatu aplikasi atau exstensi pada browser(Chrome)yang memiliki fungsi sebagai Rest Client atau untuk melakukan uji coba pada Rest yang telah kita buat. Selain postman masih banyak aplikasi serupa seperti Rest Easy untuk yang menggunakan browser firefox. Namun kali ini yang akan saya bahas adalah postman. Fngsi utama postman ini adalah sebagai GUI API Caller namun sekarang postman juga menyadiakan fitur lain yaitu Sharing Collection API for Documentation (free), Testing API (free), Realtime Collaboration Team (paid), Monitoring API (paid), Integration (paid). Dulu awal pertama kali postman muncul sebagai add on dari Chrome namun sekarang sudah menjadi aplikasi native (y). Jika kalian sedang develop API sangat direkomendasikan untuk menggunakan Postman. Download terlebih dahulu Postmannya. Kalian bisa download di  https://www.getpostman.com/ Setelah download dan instal, buka aplikasi postman. dan akan muncul tampilan seperti ini :  Buka  https://reqres.in
Baca selengkapnya

Tutorial melakukan request REST API(GET,POST,PUT dan DELETE) menggunakan POSTMAN

Gambar
Postman  merupakan tool wajib bagi para developer yang berkutat pada pembuatan API, fungsi utama postman ini adalah sebagai GUI API Caller namun sekarang postman juga menyadiakan fitur lain yaitu Sharing Collection API for Documentation (free), Testing API (free), Realtime Collaboration Team (paid), Monitoring API (paid), Integration (paid). Dulu awal pertama kali postman muncul sebagai add on dari Chrome namun sekarang sudah menjadi aplikasi native. Jika kalian sedang develop API sangat direkomendasikan untuk menggunakan Postman. Buka aplikasi Postman  lalu kita coba  beberapa method yang di gunakan untuk mencoba Rest API :   1. Method  GET  di gunakan apabila kita akan memanggil data yang ada.Pada postman kita pilih "GET" ,sebagai contoh isikan :    http://localhost/learn_rest_api/nation_capitals/index/ Kita dapat melihat data yang di tampilkan akan muncul semua tanpa ada filter berdasarkan parameter apapun, dan data yang berhasil di tampilkan : 2. Method  
Baca selengkapnya

PHP Request Header Menggunakan Aplikasi Postman

Gambar
Pada kesempatan kali ini saya akan membuat sebuah tutorial tentang Request Header PHP menggunakan Aplikasi Postman A. Impelement header  untuk mendapatkan respons JSON atau XML berdasarkan Content-Type yang diminta  1. Pertama-tama buatlah database dengan contoh dibawah ini: buatlah  folder didalam folder htdocs dengan nama php-request-header lalu buka aplikasi sublime lalu tulis skrip dibawah ini: save file php dengan nama content-type-header.php simpan dalam folder php-request-header 2. Buka  aplikasi postman, setting sebagai berikut :       1. Pilih method GET       2. isi url dengan http://localhost/php-request-header/content-type-header.php       3. Tab Header isi key = Content-Type , Value = application/json       4. Klik Send Maka Hasilnya seperti gambar dibawah ini : Catatan:        Value = application/json --> untuk JSON        Value = application/json --> untuk XML B. Implement Autentikasi Dasar ke titik akhir yang mengubah data dalam basis d
Baca selengkapnya