Bagaimanakah API berfungsi? Bagaimana untuk mengintegrasikan API ke dalam aplikasi

Antara muka pengaturcaraan aplikasi (API) adalah salah satu keperluan terakhir untuk membina aplikasi pintar. Ia adalah saluran komunikasi antara dua aplikasi. Sama ada secara sedar atau tidak, anda telah menggunakan API pada satu ketika semasa menyemak imbas Internet atau menggunakan program dalam kehidupan harian anda.

API sering menghantar data kompleks sebagai respons, jadi bagaimana anda boleh memahami dan menggunakan maklumat ini untuk memberi perkhidmatan kepada pengguna anda? API menjadikan kehidupan mudah untuk pembangun berpengalaman dan mereka yang baru bermula. Jadi anda perlu tahu cara menggunakannya dengan aplikasi anda.

Dengan beberapa kes penggunaan dan contoh, mari lihat cara anda boleh menggunakan API untuk menyediakan program anda sebagai pembangun.

Apakah API?

API menyediakan cara untuk program berasingan berinteraksi antara satu sama lain

API menyediakan cara untuk program berasingan berinteraksi antara satu sama lain. API mentakrifkan permintaan yang boleh dibuat, cara permintaan dibuat dan membolehkan pertukaran data antara aplikasi perisian yang berbeza.

API terdapat dalam 3 jenis: Awam, peribadi dan rakan kongsi. API Awam (atau API terbuka) boleh diakses secara terbuka kepada mana-mana pembangun. Menggunakan API awam disertakan dengan beberapa pengehadan, dan ia boleh menjadi percuma atau komersial. API persendirian digunakan secara eksklusif dalam syarikat atau organisasi. API Rakan Kongsi hanya tersedia untuk rakan kongsi perniagaan tertentu, yang paling kerap digunakan untuk memudahkan penyepaduan perisian antara dua perniagaan berbeza.

Bagaimanakah API berfungsi?

Pembangun mencipta API sebagai produk yang boleh memberi perkhidmatan kepada pembangun lain. Matlamatnya adalah untuk menjadikan proses pembangunan web yang kompleks lebih mudah, cekap dan lebih pantas untuk pembangun atau perniagaan pengguna.

Kebanyakan perniagaan kini bergantung pada API pihak ketiga untuk menyelesaikan masalah dan melayani pelanggan mereka dengan lebih baik. Walau bagaimanapun, menggunakan API tidaklah begitu rumit seperti yang difikirkan oleh ramai orang. Anda boleh menganggapnya sebagai penyelesaian pihak ketiga, yang memberi anda respons khusus dalam bentuk data, apabila anda membuat permintaan HTTP tertentu.

Menggunakan API adalah seperti memesan di restoran piza. Anda tidak boleh pergi ke dapur untuk memberitahu mereka apa yang anda mahu. Anda memerlukan pelayan untuk mengambil pesanan anda dan menghantarnya ke dapur, kemudian kembali dengan pizza yang anda inginkan.

Anda boleh menganggap API sebagai penghubung antara anda dan dapur. Dalam kes ini, anda adalah pelanggan yang melawat restoran yang menyediakan pelayan (API). Pelayan kemudian akan membalas dengan pemilihan piza anda (data). Dalam API sebenar, aplikasi web ialah pelanggan yang meminta untuk menggunakan kandungan penyedia melalui API, dengan membuat permintaan titik akhir HTTP.

Bagaimanakah API digunakan?

API digunakan dalam banyak kes

API digunakan dalam banyak senario termasuk kategori seperti API Pangkalan Data, API Jauh dan API Web. Anda berkemungkinan besar berinteraksi dengan API web beberapa kali sehari semasa menyemak imbas pada telefon pintar atau komputer anda. Web API bertukar-tukar permintaan dan data menggunakan protokol HTTP.

Tapak tempahan perjalanan, seperti Skyscanner dan Booking.com, menggunakan API web untuk mengagregat data penerbangan dan destinasi untuk pelanggan. Kemudahan API web membolehkan anda mengesahkan ketersediaan bilik hotel dan tempoh penginapan anda dalam masa nyata dengan menukar permintaan dan data anda daripada hotel serta-merta.

Apakah titik akhir API?

Menyambung ke API memerlukan anda memasangkan program anda ke titik akhir API. Anda boleh menganggap ini sebagai sambungan dua hala. Titik akhir yang disambungkan ke program anda menghantar permintaan, manakala titik akhir yang disambungkan ke API menghantar anda kembali respons khusus.

Titik akhir ialah URL permintaan dan menyediakan pelanggan akses terus kepada sumber API.

Selain mendapatkan semula data menggunakan API, anda juga boleh POST permintaan daripada pembekal kepada pelanggan, gunakan kaedah PUT untuk mendapatkan maklumat lanjut daripada pembekal, serta gunakan kaedah DELETE untuk memadam data sedia ada daripada program anda. Setiap kaedah ini biasanya tersedia dalam dokumentasi API.

Kriteria untuk menyambung ke API

Mengintegrasikan API dengan program anda bukan sekadar keputusan spontan - ia telah dirancang terlebih dahulu. Anda mesti tahu maklumat dan kuantiti yang anda mahukan. Ini membantu mengurangkan kerumitan, terutamanya jika anda memproses data JSON sebagai tatasusunan berbilang dimensi. Ia juga membolehkan anda mendapatkan maklumat khusus yang anda perlukan untuk program anda.

Terdapat beratus-ratus API di luar sana dengan peraturan yang berbeza untuk menyambung kepada mereka. Walaupun sesetengah API adalah percuma dan sumber terbuka, yang lain hanya boleh diakses berdasarkan langganan.

Walaupun sesetengah API adalah lancar dan ringkas, tidak memerlukan sebarang prasyarat, API lain mungkin memerlukan anda memenuhi syarat seperti menjana kunci API atau mendaftarkan akaun pembangun sebelum anda boleh menyambung ke titik akhir.

Walau bagaimanapun, salah satu aspek terpenting bagi mana-mana API ialah dokumentasinya. Sebaiknya baca dan ikuti dokumentasi mana-mana API yang anda rancang untuk sambungkan untuk mendapatkan arahan tentang cara mengekod dan menggunakan sumbernya. Ini kerana setiap API mempunyai kaedah dan arahan sambungannya sendiri.

Untuk menyambung ke mana-mana API, anda juga perlu mengetahui bahasa pengaturcaraan yang disokongnya.

Cara menyambung ke API: Contoh praktikal

Tiada cara khusus untuk menyambung ke API, tetapi beberapa contoh akan menunjukkan kepada anda asas cara anda boleh menggunakan data API dengan aplikasi anda.

Mari lihat beberapa contoh kod ringkas tentang cara anda boleh menyambung ke API.

Cara menggunakan Iro.Js Color Picker API

Iro.js ialah API ringkas yang membolehkan anda menambah pemilih warna percuma pada tapak web anda. Apabila anda memilih titik pada roda warna, API mengembalikan kod perenambelasan atau RGB warna tersebut. Untuk menyambung ke API iro.js, anda hanya perlu menampal titik akhir CDN (Content Delivery Network) pada permulaan DOM.

Dokumentasi penuh API ini tersedia di iro.js.org:

https://iro.js.org/guide.html

Mari lihat cara anda boleh menyambung ke API ini dengan kod sampel di bawah:

Display color picker

Dalam kes sampel API di atas, anda tidak memerlukan kunci API untuk menyambung kepadanya. Walau bagaimanapun, untuk memahami dengan lebih baik, mari kita lihat lebih dekat pada JavaScript. Untuk menyambung ke API ini, hanya panggil fungsi ColorPicker daripada kelas iro , kemudian hantar id bekas roda warna kepada kelas.

Titik akhir API iro.js mudah disambungkan, kerana pembangunnya telah melakukan kerja tambahan pengekodan lapisan untuk pengguna. Imej di bawah adalah hasil daripada contoh kod di atas.

Hasil kod contoh

Untuk melihat bagaimana peristiwa perubahan warna berlaku, anda boleh membuka fail HTML lain dan menampal kod berikut ke dalam bahagian skripnya :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Kod di atas merekodkan nilai warna heksadesimal setiap kali anda menukar kedudukan pemilih warna pada roda.

Cara menggunakan API Pertukaran Mata Wang NoCodeAPI

NoCodeAPI menyediakan banyak API termasuk API penukaran mata wang. Untuk berhubung dengan titik akhir pertukaran mata wang ini, lawati NoCodeAPI dan buat akaun:

https://app.nocodeapi.com/login

Apabila anda log masuk, terdapat bar carian di bahagian atas halaman. Dalam bar carian itu, taip pertukaran mata wang , apabila pertanyaan anda muncul, klik Aktifkan.

Pada halaman seterusnya, klik Buat API Pertukaran Mata Wang . Seterusnya, masukkan nama untuk API dan klik Buat.

Setelah anda membuat API, klik Lihat Dokumentasi. Seterusnya, pilih bahasa pilihan anda untuk melihat kod yang bersambung ke titik akhir API. Anda kemudian boleh menyalin kod sampel itu dan menampalnya ke dalam apl anda untuk penyesuaian selanjutnya.

Lihat kod contoh di bawah untuk penukaran mata wang: