Apa Itu API?

API merupakan singkatan dari Application Programming Interface. API memungkinkan suatu aplikasi untuk "berbicara" dengan aplikasi lainnya untuk melakukan transfer data atau instruksi tertentu. API bisa kita temui setiap hari, mulai dari video YouTube yang disematkan di aplikasi media sosial hingga speaker pintar yang banyak dijual bebas di pasaran. API memungkinkan software yang dikembangkan pada waktu tertentu oleh orang yang berbeda untuk berinteraksi dan dengan demikian, dapat meningkatkan fungsionalitas dan produktivitas.

Lantas, bagaimana cara kerja dan apa saja contoh dari API? Simak selengkapnya berikut ini.

Sejarah Singkat API

API sudah ada sejak awal dunia komputasi, jauh sebelum komputer pribadi diciptakan. Pada saat itu, API biasanya digunakan sebagai perpustakaan untuk sistem operasi. API hampir selalu bersifat lokal untuk sistem yang dioperasikannya, meskipun terkadang dapat mengirimkan pesan antar-mainframe. Setelah hampir 30 tahun, API keluar dari lingkungan lokal mereka. Pada awal 2000-an, API menjadi teknologi penting untuk melakukan integrasi data jarak jauh.

Baca Juga: Apa Itu REST?

Memahami Cara Kerja API

Pada contoh berikut, kita akan menggunakan JavaScript (jQuery diaktifkan) dengan The One API (API bertema cerita fiksi Lord of the Rings). Lihat dokumentasi API untuk mengetahui instruksi khusus tentang penggunaan software tersebut. Saat ini, banyak API yang memerlukan token id autentikasi untuk dapat mengaksesnya. Instruksi untuk memperoleh token itu juga ditemukan dalam dokumentasi API.

Untuk memanggil API, "the caller" harus mengirim informasi pengenal sebagai tanda pengenal ke penyedia layanan API. Pengidentifikasi ini disebut API key.

Sekarang perhatikan kode berikut ini:

String URL di bawah ini adalah jalur API Anda dan dapat ditemukan di dokumentasi API.

const lotrQuote = "https://the-one-api.dev/v2/quote/";

$.ajax({

    url: lotrQuote,

    method: "GET"

    }).then(function(response){

        console.log(response);

    })

Pada contoh diatas, variabel lotrQuote didefinisikan sebagai string yang berisi rute API. Saat dipanggil menggunakan metode jQuery .ajax di baris 2, API akan ditanyakan dan mengembalikan data JSON atau XML. Data itu kemudian diteruskan ke fungsi panggilan balik .then dan dirender ke konsol dalam bentuk mentahnya. Setelah ini, mari kita lihat apa saja jenis-jenis API.

Apa Saja Jenis-Jenis API?

1. Private API

Software interface aplikasi ini dirancang untuk meningkatkan solusi dan layanan dalam suatu organisasi. Developer atau kontraktor internal dapat menggunakan API ini untuk mengintegrasikan sistem atau aplikasi TI perusahaan, atau membangun sistem baru dengan memanfaatkan sistem yang ada. Meskipun aplikasi ini tersedia untuk umum, interface itu sendiri tetap tersedia hanya untuk mereka yang bekerja secara langsung dengan penerbit API. Strategi private ini memungkinkan perusahaan untuk sepenuhnya mengontrol penggunaan API.

2. Partner API

Partner API dipromosikan secara terbuka, tetapi dibagikan dengan mitra bisnis yang telah menandatangani perjanjian dengan penerbit. Contoh kasus penggunaan partner API untuk umum adalah integrasi software antara dua pihak. Perusahaan yang memberikan akses ke data atau kemampuan kepada mitra mendapat manfaat dari aliran pendapatan tambahan. Pada saat yang sama, ia dapat memantau bagaimana aset digital yang tereksposur digunakan, memastikan apakah solusi pihak ketiga yang menggunakan API mereka memberikan pengalaman pengguna yang layak, dan mempertahankan identitas perusahaan di aplikasi mereka.