Web Api

Web API Adalah

Pada pengenalan modul ini kita akan membahas apa itu web api ? Namun kita belum mengetahui dari mana sumber data tersebut berasal? Bagaimana cara mengaksesnya? Untuk menjawab itu semua, mari berkenalan dengan Web API.

API (Application Programming Interface) adalah interface yang di sediakan oleh penyedia data agar data yang ia miliki dapat di manfaatkan dengan mudah pada banyak aplikasi, baik itu aplikasi web, mobile, desktop ataupun lainnya.


Penyedia data yang telah membangun Web API memiliki keuntungan karena proses pengembangan aplikasi menjadi lebih efisien. Mengapa? Karena cukup dengan satu Web API, data dapat di konsumsi pada berbagai macam platform seperti yang sudah di sebutkan di atas.

api web

Pada ilustrasi di atas, Web API bekerja menggunakan salah satu pola standar yaitu REST (Representational State Transfer). Pola inilah yang saat ini banyak di gunakan karena simpel dan mudah di pelajari daripada pola yang lainnya. Jenis data yang di terima atau di kirimkan pada pola REST dapat berupa format text, JSON atau XML.


Pola REST hampir sepenuhnya menggunakan HTTP dalam transaksi datanya. Sehingga untuk berkomunikasi dengan Web API ini, client (aplikasi) harus membuat HTTP request pada endpoint (URL) yang telah di tentukkan. Biasanya penyedia data juga menetapkan HTTP Request Method yang berbeda pada setiap endpoint-nya.


Terdapat banyak tipe/method dalam melakukan HTTP Request, namun terdapat 4 (empat) method penting yang biasanya di gunakan pada Web API dalam melakukan transaksi data.

  • GET : Berguna untuk mengambil informasi dari Web API.
  • POST : Berguna untuk menambahkan data.
  • PUT : Berguna untuk mengubah data.
  • DELETE : Berguna untuk menghapus data.
Baca Juga :  Cara Mematikan Firewall Windows

Setelah client membuat HTTP request pada Web API, maka Web API akan mengembalikan HTTP response. Pada response terdapat status kode yang menunjukkan apakah request yang kita lakukan berhasil atau gagal. Berikut beberapa status kode yang dapat di hasilkan dari HTTP Response pada Web API.

  • 200 (OK) : Request berhasil terpenuhi oleh server (Web API).
  • 400 (Bad Request) : Server tidak mengerti request yang dikirimkan client.
  • 401 (Unauthorized) : Request membutuhkan authorization.
  • 403 (Forbidden) : Server mengerti request client namun menolak untuk memprosesnya karena request tersebut tidak boleh di lakukan.
  • 404 (Not Found) : Resource yang client minta, tidak di temukan.
  • 500 (Server Error) : Server mengalami kendala untuk memproses request.

Banyak penyedia data yang menyediakan Web API secara cuma-cuma atau dapat di konsumsi umum. Namun ada juga penyedia data yang membangun Web API yang hanya di gunakan untuk keperluan internal saja. Biasanya jika kita mengakses Web API yang sifatnya private, kita akan terhalangi oleh CORS (cross-origin resource sharing).

CORS

Sebelum kita mencoba langkah-langkah mengakses Web API, ada hal yang harus kita ketahui terlebih dahulu perihal keamanan. Dalam transaksi menggunakan Web API menggunakan AJAX kita dapat melihat request yang di buat dan response yang di hasilkan melalui Network tabs pada DevTools.

web api adalah

Hal tersebut di sebabkan AJAX di proses pada sisi client sehingga pengguna dapat leluasa untuk melihat dan mengontrolnya. Maka dengan alasan keamanan ketika kita melakukan AJAX baik menggunakan dengan XHR atau Fetch, kita hanya di perbolehkan melakukan request dari domain yang sama.


Contoh jika kita ingin mengakses API yang bersumber dari google.com/api maka kita sebagai client perlu menjadi google.com. Jika kita berasal dari domain yang berbeda, contohnya bing.com maka kita tidak dapat menggunakan AJAX pada google.com/api. Hal ini dikenal sebagai same-origin policy.

Baca Juga :  Cara Mendapatkan Uang Dari Internet Terbaru


Namun jika memang Web API tersebut diperbolehkan untuk dikonsumsi umum berarti penyedia data harus menerapkan teknologi yang dinamakan CORS (Cross-Origin Resource Sharing) pada server-nya.


Server yang menyediakan Web API menggunakan CORS dapat digunakan secara umum dan mengelakkan kebijakan same-origin guna mengakses informasi yang ada di dalamnya.

Test Web API using Postman

Apa yang perlu Anda lakukan sebelum mencoba Web API menggunakan AJAX? Untuk mempelajari atau menguji sebuah Web API, developer menggunakan tools yang bernama Postman.

Postman adalah GUI API Caller yang dapat membuat HTTP Request dengan method yang lengkap seperti GET, POST, PUT, DELETE dan lainnya.


Postman merupakan tools yang sangat cocok untuk menguji sebuah Web API karena terdapat fungsi yang relatif lengkap sebagai API caller dalam melakukan HTTP Request. Pada Postman kita dapat menetapkan parameter dan mengirimkan data pada body atau header request dengan mudah, tanpa memerlukan kode.


Postman tersedia secara gratis dan dapat berjalan pada sistem operasi Windows, Linux maupun MacOS. Untuk mendapatkan aplikasi Postman, kita bisa mengunduhnya melalui https://www.postman.com.

pengertian postman

Setelah mengunduhnya, silakan Anda pasang aplikasi postman pada komputer. Saat selesai Anda bisa langsung membukanya.

web api c#

Ketika pertama kali membuka aplikasi Postman, kita perlu login atau registrasi untuk memiliki akun. Setelah berhasil login, berikut tampilan pada halaman utamanya:

web api whatsapp

Untuk melakukan sebuah HTTP Request kita dapat memilih menu “create a request” yang tersedia pada halaman tersebut.

Kemudian untuk mengirimkan request kita tentukan dulu endpoint (request URL) mana yang akan kita tuju pada kolom yang sudah tersedia. Kita akan mencoba melakukan request pada Web API dengan endpoint berikut: https://web-server-book-dicoding.appspot.com/list

Setelah mengisikan request URLnya coba kita tekan tombol “Send”. Maka respon yang akan didapatkan adalah daftar buku dalam bentuk JSON.

Baca Juga :  Hardware Komputer : Pengertian,Fungsi,dan Contohnya

Jika penyedia data menyediakan Web API secara terbuka atau dapat terakses umum, biasanya ia akan membuat sebuah dokumentasi cara penggunaan API.

Di sana kita dapat menemukan informasi endpoint mana saja yang dapat kita akses, method apa saja yang di perlukan, ataupun format atau struktur seperti apa yang perlu di terapkan untuk mengirim data. Dokumentasi tersebut sangatlah penting karena melalui itulah seorang developer jadi tahu bagaimana ia bisa memanfaatkan Web API tersebut.


Dokumentasi dari Web API yang kita gunakan pada contoh di atas dapat kita lihat pada tautan berikut https://web-server-book-dicoding.appspot.com/

Dari dokumentasi tersebut kita menjadi tahu ternyata kita dapat menambahkan data buku baru dengan mengakses endpoint /add. Di sana juga kita bisa melihat method, headers, serta body apa yang perlu kita terapkan dalam melakukan request tersebut. Sehingga kita dapat mencobanya pada pada Postman.


Anda juga bisa mencoba fungsi lain seperti menghapus atau mengubah data buku melalui Web API tersebut.

Demikian pembahasan tentang apa itu web api dan bagaimana cara test api menggunakan postman. Semoga artikel ini membantu,silahkan baca artikel artikel lainnya yang ada di KomputerBlog ini. Terimakasih

Tinggalkan Balasan