Apa itu API? [Baca Cepat]

Jika Anda bukan seorang pengembang, tetapi Anda bekerja di bidang teknologi, istilah API mungkin adalah sesuatu yang Anda pahami dalam arti percakapan. Anda mungkin tahu apa artinya (antarmuka pemrograman aplikasi), dan mungkin tim Anda menggunakan API untuk melakukan pekerjaan mereka—atau mungkin bahkan produk itu sendiri (Twilio SendGrid, misalnya).

Tapi apa sebenarnya API itu dan bagaimana cara kerjanya?

Memahami prinsip yang lebih dalam di balik API akan membantu Anda memasarkan, menjual, atau menggunakan sendiri teknologi ini dengan lebih baik.

Posting ini menjelaskan cara kerja API, cara pengembang membangunnya, dan cara menggunakannya (dengan contoh dunia nyata).

Bagaimana cara kerja API?

Bagaimana browser web berinteraksi dengan server adalah prinsip dasar API. Web adalah kumpulan server jarak jauh yang tersebar di seluruh planet ini. Saat Anda membuka browser dan mengetikkan situs web, browser melakukan panggilan ke server klien (aplikasi atau server apa pun tempat situs web dihosting) untuk mengambil dan menampilkan apa pun yang ada di URL tersebut.

Meskipun API bukanlah server itu sendiri, itu adalah bagian dari server, yang dikenal sebagai titik akhir, yang mengirim dan menerima respons tertentu. API adalah cara bagi perangkat lunak yang berbeda untuk berkomunikasi (alias mengirim dan menerima) satu sama lain dengan membuka titik akhir.

Pengembang menyiapkan panggilan API untuk mengambil data spesifik yang diperlukan untuk berbagai tujuan saat mereka membangun aplikasi atau situs web. Sebagai contoh:

• Apakah Anda baru saja membuka aplikasi Instagram Anda? Itu dimungkinkan oleh panggilan API.
• Pernahkah Anda menambahkan acara ke Kalender Google Anda dari situs web atau email lain? Situs itu memanfaatkan API Google Kalender untuk mengambil informasi spesifik itu dari server Google Kalender.

Takeaway: Pengembang menyiapkan panggilan API untuk mengambil tipe data tertentu untuk menampilkan apa yang mereka butuhkan saat pengguna berada di situs web atau menjalankan aplikasi.

Bangkitnya REST

Istilah lain yang mungkin pernah Anda dengar adalah REST API. Ini tidak berbeda per-katakan dari definisi tradisional API. Masih perlu dipahami mengapa REST API menjadi sangat populer dan apa yang membedakan REST API dari yang lain.

Pada awalnya, API dibangun untuk memenuhi persyaratan SOAP (Simple Object Access Protocol). Tetapi metode ini agak membosankan dan membutuhkan banyak bandwidth untuk mentransfer kumpulan data. Itu juga menuntut banyak energi pengembang (seperti bukan jenis yang menyenangkan). SOAP menggunakan bahasa markup XML yang terkenal berat untuk menampilkan data. Berguna untuk memastikan kompatibilitas universal–tetapi hanya itu saja.

Pengembang mencari cara yang lebih ringan dan fleksibel untuk melakukan panggilan API. REST (representational state transfer) API menyediakan solusi alternatif untuk SOAP API. Mereka tidak dibatasi oleh protokol tertentu, meskipun mereka harus memenuhi gaya arsitektur tertentu (jika Anda tertarik untuk mendalaminya, kunjungi di sini).

Alih-alih ditampilkan dengan markup XML, server menggunakan bahasa JSON yang ringan (hanya file teks). REST API jauh lebih ringan dalam bandwidth daripada SOAP—biasanya hanya berupa URL—dan secara alami dioptimalkan untuk komunikasi di web.

Takeaway: Pikirkan REST API sebagai data Marie Kondo. Mereka mengambil dan menggunakan hanya *tepat* apa yang mereka butuhkan. SOAP API seperti garasi tetangga Anda yang saat ini penuh dengan kertas toilet.

Memahami berbagai jenis API

Terlepas dari protokol atau gaya apa yang diikuti API, ada beberapa jenis API termasuk:

• API Terbuka – Juga dikenal sebagai API publik, titik akhir ini dapat diakses oleh pengembang mana pun dan biasanya tidak memberlakukan batasan apa pun pada pengguna. Mereka biasanya menerima sumbangan.
• API Mitra – Ini adalah API yang dirancang untuk digunakan bersama dan biasanya hanya dapat diakses oleh beberapa jenis pasar.
• API Internal – Ini adalah alat internal yang digunakan perusahaan untuk membantu karyawan mereka menjadi lebih efisien atau menyediakan cara yang lebih aman bagi karyawan untuk berbagi data/informasi.
• API Komposit – API Komposit adalah cara untuk mengkonsolidasikan panggilan API yang terkait tetapi biasanya memerlukan panggilan API individual.

Contoh nyata dari API

Ada banyak API di alam liar (beberapa menghitung lebih dari 15.000) yang membantu pengguna mengakses beragam aplikasi. Di bawah ini adalah beberapa yang penting yang akan membantu Anda memahami ruang lingkup ekosistem API.

Koktail DB

Katakanlah Anda memiliki toko minuman keras lokal, dan Anda ingin menyediakan resep koktail di situs web Anda. Anda dapat mempertimbangkan untuk menggunakan Cocktail DB API di atas. Semua data itu (resep koktail) sudah ada di server orang lain dan dapat dinilai melalui API.

Ketika pengguna mengklik resep margarita (bisa dibilang koktail superior), server mereka menemukan bahwa resep tertentu mengirimkannya dalam JSON, diambil dari situs web dan diuraikan menjadi HTML dan CSS agar dapat ditampilkan di browser situs web Anda.

BukaPeta Cuaca

Menambahkan bagian cuaca ke situs web Anda adalah kasus penggunaan yang sangat umum. Pikirkan tentang resor ski, toko sepeda, atau perusahaan tur. OpenWeatherMap API menyimpan semua prakiraan cuaca dan informasi dan hanya menampilkan bagian yang Anda minta.

API ini menyediakan versi gratis dan premium tergantung pada seberapa banyak data yang ingin Anda tampilkan.

API Email SendGrid

API Email SendGrid memanfaatkan SMTP (protokol transfer surat sederhana) untuk memungkinkan pelanggan mengirim email transaksional dan terpicu dalam jumlah besar – pikirkan pengaturan ulang kata sandi, konfirmasi akun, dan pemberitahuan pengiriman.

SMS Twilio

Twilio SMS API adalah REST API lain yang menyediakan cara untuk menambahkan fitur perpesanan ke aplikasi. Pesan SMS menjadi semakin populer sebagai cara bagi merek untuk berkomunikasi dengan pelanggan karena bersifat pribadi, secara real-time, dan pesan ini dibaca dengan kecepatan yang jauh lebih tinggi.

Cara menggunakan API

Sebelum Anda atau tim Anda mulai menggunakan API, penting untuk mengetahui apakah API tersebut terbuka, digunakan bersama dengan layanan mitra, atau gabungan.

Cara memulai dengan API

Baca dokumentasi. API apa pun harus memiliki dokumentasi yang berlaku untuk Anda ikuti. Ini akan memberi tahu Anda dependensi apa yang Anda miliki, jenis API apa, dan cara menggunakannya. Dokumentasi yang buruk harus menjadi peringatan bagi Anda dan pengembang Anda. Kami cukup bangga dengan dokumentasi Twilio dan SendGrid yang luar biasa.

Buat kunci API. Anda harus membuat kunci API untuk mulai menggunakannya. Berikut adalah petunjuk dari Google Maps API:

Catatan : Jangan pernah membagikan kunci API dan pastikan kunci tersebut tidak terlihat pada kode publik apa pun yang Anda masukkan di GitHub.

Mulai membangun: kirim email gratis dengan API Email SendGrid

Sisanya terserah padamu! Peluangnya benar-benar tidak terbatas saat Anda bekerja dengan API. Untuk melihat semua peluang untuk bekerja dengan Twilio API, lihat Twilio Code Exchange.

Jika Anda tertarik menggunakan API Email SendGrid untuk mengirim email gratis, lihat di sini.