Apa itu API? | Definisi Cepat

Apa itu API?

Intro

Dengan beberapa klik di desktop atau perangkat, seseorang dapat membeli, menjual, atau menerbitkan apa saja, kapan saja. Persis bagaimana itu terjadi? Bagaimana informasi pergi dari sini ke sana? Pahlawan yang tidak dikenal adalah API.

Apa itu API?

API adalah singkatan dari an ANTARMUKA PEMROGRAMAN APLIKASI. API mengekspresikan komponen perangkat lunak, operasinya, input, output, dan tipe dasarnya. Tapi bagaimana Anda menjelaskan API dalam bahasa Inggris sederhana? API berfungsi sebagai pembawa pesan yang mentransfer permintaan Anda dari aplikasi dan mengirimkan respons kembali kepada Anda.

Contoh 1: Saat Anda mencari penerbangan online. Anda berinteraksi dengan situs web maskapai. Situs web merinci tempat duduk dan biaya penerbangan pada tanggal dan waktu tertentu. Anda memilih makanan atau tempat duduk, bagasi, atau permintaan hewan peliharaan.

Namun, jika Anda tidak menggunakan situs web langsung maskapai atau menggunakan agen perjalanan online yang menggabungkan data dari banyak maskapai. Untuk mendapatkan informasi, aplikasi berinteraksi dengan API maskapai. API adalah antarmuka yang mengambil data dari situs web agen perjalanan ke sistem maskapai.

 

Ini juga membutuhkan tanggapan maskapai dan mengirimkannya kembali. Ini memfasilitasi interaksi antara layanan perjalanan, dan sistem maskapai penerbangan -untuk memesan penerbangan. API memerlukan perpustakaan untuk rutinitas, struktur data, kelas objek, dan variabel. Misalnya, layanan SOAP dan REST.

 

Contoh 2: Best Buy membuat harga Deal of the Day khusus tersedia melalui situs webnya. Data yang sama ini ada di aplikasi selulernya. Aplikasi tidak mengkhawatirkan sistem penetapan harga internal – aplikasi dapat memanggil Deal of the Day API dan bertanya, apa harga spesialnya? Best Buy merespons dengan informasi yang diminta dalam format standar yang ditampilkan aplikasi kepada pengguna akhir.

 

Contoh3:  API untuk media sosial sangat penting. Pengguna dapat mengakses konten dan menjaga agar jumlah akun dan kata sandi yang mereka lacak tetap rendah, sehingga mereka dapat menjaga semuanya tetap sederhana.

  • API Twitter: Berinteraksi dengan sebagian besar fungsi Twitter
  • Facebook API: Untuk pembayaran, data pengguna, dan login 
  • API Instagram: Tandai pengguna, lihat foto yang sedang tren

Bagaimana dengan REST & SOAP API?

SOAP dan ISTIRAHAT menggunakan layanan yang menggunakan API, yang dikenal sebagai Web API. Layanan web tidak bergantung pada pengetahuan informasi sebelumnya. SOAP adalah protokol layanan web yang ringan tanpa platform. SOAP adalah protokol perpesanan berbasis XML. Tidak seperti layanan web SOAP, layanan Restful menggunakan arsitektur REST, dibangun untuk komunikasi point-to-point.

Layanan Web SOAP

Simple Object Access Protocol (SOAP) menggunakan protokol HTTP untuk memungkinkan aplikasi berkomunikasi. SOAP adalah komunikasi terarah dan tanpa kewarganegaraan antar node. Ada 3 jenis node SOAP:

  1. SOAP Sender – membuat dan mengirim pesan.

  2. Penerima SOAP - memperoleh dan memproses pesan.

  3. Perantara SOAP- menerima dan memproses blok header.

Layanan Web RESTful

Representational State Transfer (REST) ​​berkaitan dengan hubungan antara klien dan server dan bagaimana proses negara. Istirahat arsitektur, REST Server menyediakan akses sumber daya ke klien. Istirahat menangani membaca dan memodifikasi atau menulis sumber daya. Uniform Identifier (URI) mengidentifikasi sumber daya untuk memuat dokumen. Ini akan menangkap status sumber daya.

REST lebih ringan dari arsitektur SOAP. Itu mem-parsing JSON, bahasa yang dapat dibaca manusia yang memungkinkan berbagi data dan lebih mudah menggunakan data, daripada XML yang digunakan oleh arsitektur SOAP.

Ada beberapa prinsip dalam mendesain Restful Web Service, yaitu:

  • Addressability – Setiap sumber daya harus memiliki setidaknya satu URL.
  • Tanpa Kewarganegaraan – Layanan tenang adalah layanan tanpa kewarganegaraan. Permintaan tidak tergantung pada permintaan sebelumnya oleh layanan. HTTP adalah dengan desain protokol tanpa kewarganegaraan.
  • Dapat di-cache – Data ditandai sebagai penyimpanan yang dapat di-cache di sistem dan digunakan kembali di masa mendatang. Sebagai tanggapan atas permintaan yang sama alih-alih menghasilkan hasil yang sama. Batasan cache mengaktifkan penandaan data respons sebagai dapat disimpan dalam cache atau tidak dapat disimpan dalam cache.
  • Antarmuka seragam – Memungkinkan antarmuka umum dan standar untuk digunakan untuk akses. Penggunaan kumpulan metode HTTP yang ditentukan. Mematuhi konsep-konsep ini memastikan, implementasi REST ringan.

Keuntungan REST

  • Menggunakan format yang lebih sederhana untuk pesan
  • Menawarkan efisiensi jangka panjang yang lebih kuat
  • Ini mendukung komunikasi tanpa kewarganegaraan
  • Gunakan standar dan tata bahasa HTTP
  • Data tersedia sebagai sumber daya

Kerugian dari REST

  • Gagal dalam standar layanan Web seperti Transaksi Keamanan dll.
  • Permintaan REST tidak dapat diskalakan

Perbandingan REST vs SOAP

Perbedaan antara layanan web SOAP dan REST.

 

Layanan Web SOAP

Istirahat Layanan Web

Memerlukan payload input yang berat dibandingkan dengan REST.

REST ringan karena menggunakan URI untuk formulir data.

Perubahan layanan SOAP sering menyebabkan perubahan kode yang signifikan di sisi klien.

Kode sisi klien tidak terpengaruh oleh perubahan layanan dalam penyediaan web REST.

Tipe pengembalian selalu tipe XML.

Memberikan keserbagunaan sehubungan dengan bentuk data yang dikembalikan.

Protokol pesan berbasis XML

Sebuah protokol arsitektur

Membutuhkan perpustakaan SOAP di ujung klien.

Tidak diperlukan dukungan pustaka yang biasanya digunakan melalui HTTP.

Mendukung WS-Keamanan dan SSL.

Mendukung SSL dan HTTPS.

SOAP mendefinisikan keamanannya sendiri.

Layanan web RESTful mewarisi langkah-langkah keamanan dari transportasi yang mendasarinya.

Jenis Kebijakan Rilis API

Kebijakan rilis untuk API adalah:

 

Kebijakan rilis pribadi: 

API hanya tersedia untuk penggunaan internal perusahaan.


Kebijakan rilis mitra:

API hanya tersedia untuk mitra bisnis tertentu. Perusahaan dapat mengontrol kualitas API karena kontrol atas siapa yang dapat mengaksesnya.

 

Kebijakan rilis publik:

API ini untuk penggunaan publik. Ketersediaan kebijakan rilis tersedia untuk umum. Contoh: Microsoft Windows API dan Kakao Apple.

Kesimpulan

API ada di mana-mana, apakah Anda memesan penerbangan atau terlibat dengan aplikasi media sosial. SOAP API didasarkan pada komunikasi XML, ini berbeda dari REST API karena tidak memerlukan konfigurasi khusus.

Merancang layanan Rest Web harus mematuhi konsep-konsep tertentu, termasuk kemampuan alamat, keadaan tanpa kewarganegaraan, kemampuan cache, dan antarmuka standar. Aturan rilis API dapat dibagi menjadi tiga kategori: API pribadi, API mitra, dan API publik.

Terimakasih telah membaca artikel ini. Lihat artikel kami tentang Panduan untuk Keamanan API 2022.