Apa Arti API?

API kependekan dari Application Programming Interface berarti sekumpulan kode fungsi yang memungkinkan aplikasi mengakses data tertentu dan berinteraksi dengan komponen aplikasi perangkat lunak eksternal, sistem operasi, atau layanan mikro.

Untuk menyederhanakannya, API mengirimkan respons pengguna ke sistem dan mengirimkan respons sistem kembali ke pengguna. Anda mengklik “tambahkan ke troli;” API memberi tahu situs bahwa Anda menambahkan produk ke keranjang; situs web memasukkan produk ke keranjang Anda, dan keranjang Anda diperbarui.

Anda mungkin mendengar istilah “layanan mikro” muncul sehubungan dengan API. Namun hal ini tidaklah sama. Layanan mikro adalah gaya atau arsitektur yang membagi fungsionalitas dalam aplikasi web. Sedangkan API adalah kerangka kerja dimana pengembang berinteraksi dengan aplikasi web. Layanan mikro sebenarnya bisa menggunakan API untuk berkomunikasi diantara satu sama lain.

API memungkinkan pengembang melakukan “panggilan” atau “permintaan” tertentu untuk mengirim atau menerima informasi. Komunikasi ini dilakukan menggunakan bahasa pemrograman yang disebut “JSON.” Ini juga dapat digunakan untuk melakukan tindakan tertentu seperti memperbarui atau menghapus data. Ada empat metode permintaan dasar yang dapat dibuat dengan API:

GET – Mengumpulkan informasi (Menarik semua Kode Kupon)

PUT – Memperbarui bagian data (Memperbarui harga Produk)

POST – Creates (Membuat Kategori Produk baru)

HAPUS – (Menghapus postingan blog)

Apa itu JSON dan Mengapa Digunakan?

JSON (JavaScript Object Notation) digunakan untuk merepresentasikan data di server. Cukup mudah dibaca oleh manusia, dan mudah dipahami oleh mesin/aplikasi. Mari kita lihat contoh JSON dari suatu produk di BigCommerce:

Hal ini mudah dipahami karena dihasilkan dalam pasangan kunci/nilai, dengan kunci di sebelah kiri, dan nilai di sebelah kanan. Kunci adalah objek tetap yang ditentukan oleh aplikasi dan akan tetap sama seperti “kategori”. Sedangkan nilainya akan unik, seperti “Kemeja”.

Apa itu Permintaan API?

Ada beberapa komponen Permintaan API agar dapat berfungsi. Mari kita bahas ini satu per satu dan bagaimana penggunaannya untuk membuat permintaan.

Apa itu Titik Akhir?

Ada dua bagian penting pada titik akhir yang digunakan saat membuat permintaan API. Salah satunya adalah URL. BigCommerce menggunakan https://api.bigcommerce.com/stores/ sebagai URL untuk semua Permintaan API. Ini mungkin terlihat seperti URL biasa tetapi jika Anda menyambungkannya ke browser web, Anda akan menerima pesan kesalahan 404.

Bagian kedua adalah jalannya. Jalannya akan bervariasi tergantung pada apa yang ingin Anda capai. Anda dapat menemukan daftar jalur yang tersedia untuk BigCommerce dengan mengunjungi dokumentasi pengembang kami: https://developer.bigcommerce.com/api-reference. Untuk contoh ini kita akan menggunakan jalur produk yaitu /v3/catalog/products.

Saat kami menggabungkan kedua bagian ini, kami mendapatkan titik akhir lengkap https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products. Sekarang Anda mungkin bertanya pada diri sendiri “Apa itu {store_hash}?” “Dari mana asalnya?” Inilah yang disebut dengan variabel. Variabel adalah komponen unik pada titik akhir dan akan bervariasi bergantung pada informasi toko Anda. Anda dapat melihat variabel dengan tanda kurung buka dan tutup “{ }”.

Apa itu Tajuk?

Header memberikan informasi kepada klien dan server. Contoh umum dari header adalah kredensial autentikasi seperti “Token Auth” atau “ID Klien”. Kredensial ini diberikan kepada Anda secara otomatis saat Anda membuat Akun API. Header umum lainnya disebut sebagai “Jenis Konten”, yang memberi tahu server tentang jenis konten apa yang akan dikirim. Misalnya, tipe konten yang umum digunakan adalah “application/json” yang memberi tahu server, kami mengirimkan data JSON.

Apa itu Metode?

Metode adalah tindakan yang diambil saat mengirim permintaan. Pikirkan kembali awal ketika kita membahas GET, PUT, POST, dan DELETE. Ini semua adalah Metode API.

Apa itu Data?

Data permintaan, juga biasa disebut sebagai “tubuh”, adalah informasi yang akan dikirim ke atau dikembalikan oleh server. Pada pembahasan JSON sebelumnya, Anda dapat melihat contoh data API. Isi permintaan terkadang memerlukan informasi spesifik sebelum dapat dikirimkan. Contohnya adalah jika Anda mengedit satu produk, ID Produk akan diperlukan sebelum perubahan apa pun dapat dilakukan.

Baca lebih lanjut di sini.