intro
Kalawan sababaraha clicks dina desktop atawa alat, hiji bisa meuli, ngajual atawa nyebarkeun nanaon, iraha wae. Persis kumaha éta lumangsung? Kumaha carana inpormasi angkat ti dieu ka ditu? Pahlawan anu teu dipikanyaho nyaéta API.
Naon API?
API nangtung pikeun hiji APLIKASI PROGRAMMING panganteur. API nganyatakeun komponén parangkat lunak, operasi, input, kaluaran, sareng jinis dasarna. Tapi kumaha anjeun ngajelaskeun API dina basa Inggris polos? Fungsi API salaku utusan anu mindahkeun pamundut anjeun tina aplikasi sareng ngirimkeun réspon deui ka anjeun.
Conto 1: Nalika anjeun milarian penerbangan online. Anjeun berinteraksi sareng situs wéb maskapai. Situs wéb rinci ngeunaan tempat duduk sareng biaya penerbangan dina tanggal sareng waktos anu khusus. Anjeun milih tuang atanapi korsi, koper, atanapi pamundut piaraan.
Tapi, upami anjeun henteu nganggo situs wéb langsung maskapai atanapi sareng nganggo agén perjalanan online anu ngagabungkeun data tina seueur maskapai. Pikeun meunangkeun inpormasi, hiji aplikasi berinteraksi sareng API maskapai. API nyaéta antarbeungeut anu nyandak data tina situs wéb agén perjalanan ka sistem maskapai.
Éta ogé nyandak réspon maskapai sareng ngirimkeun langsung deui. Ieu ngagampangkeun interaksi antara jasa perjalanan, sareng sistem maskapai - pikeun mesen penerbangan. API butuh perpustakaan pikeun rutinitas, struktur data, kelas objék, sareng variabel. Contona, layanan SOAP jeung REST.
Conto 2: Best Buy ngajantenkeun harga Deal of the Day khusus sayogi ngalangkungan halaman wéb na. Data anu sami ieu aya dina aplikasi mobile na. Aplikasina henteu hariwang ngeunaan sistem harga internal - éta tiasa nyauran Deal of the Day API sareng naroskeun, naon hargana khusus? Best Buy ngabales inpormasi anu dipénta dina format standar anu dipidangkeun ku aplikasi ka pangguna akhir.
Conto3: API pikeun média sosial anu krusial. Pamaké tiasa ngaksés eusi sareng ngajaga jumlah akun sareng kecap akses anu aranjeunna ngalacak sakedik, supados aranjeunna tetep saderhana.
- API Twitter: Interaksi sareng seueur fungsi Twitter
- API Facebook: Kanggo pamayaran, data pangguna, sareng login
- Instagram API: Tag pamaké, tempo poto trending
Kumaha upami REST & SOAP API?
sabun jeung ngaso ngagunakeun layanan API-consuming, katelah Web API. Ladenan wéb henteu gumantung kana inpormasi sateuacanna. SOAP mangrupikeun protokol jasa wéb anu henteu mandiri platform. SOAP nyaéta protokol olahtalatah basis XML. Beda sareng jasa wéb SOAP, jasa Restful nganggo arsitektur REST, diwangun pikeun komunikasi titik-ka-titik.
Layanan wéb SOAP
Simple Object Access Protocol (SOAP) ngagunakeun protokol HTTP pikeun ngidinan aplikasi pikeun komunikasi. SOAP mangrupikeun komunikasi terarah, teu aya kaayaan di antara titik.
Aya 3 jinis titik SOAP:
- SOAP Sender - nyiptakeun sareng ngirim pesen.
- SOAP Receiver - nampi sareng ngolah pesen.
- SOAP Intermediary- narima jeung ngolah blok header.
Service Wéb RESTful
Representational State Transfer (REST) aya hubunganana sareng hubungan antara klien sareng server sareng kumaha prosés kaayaan. Arsitéktur istirahat, Server REST nyayogikeun aksés sumberdaya pikeun klien. Sésana handles maca jeung ngaropéa atawa nulis sumberdaya. Uniform Identifier (URI) ngaidentipikasi sumberdaya pikeun ngandung dokumén. Ieu bakal nangkep kaayaan sumberdaya.
REST langkung hampang tibatan arsitektur SOAP. Ieu parses JSON, basa nu bisa dibaca manusa nu nyandak babagi data tur gampang ngagunakeun data, tinimbang XML dipaké ku arsitektur SOAP.
Aya sababaraha prinsip pikeun ngarancang Restful Web Service, nyaéta:
- Addressability - Unggal sumberdaya kudu boga sahanteuna hiji URL.
- Statelessness - A jasa Restful mangrupakeun layanan stateless. Paménta henteu gumantung kana pamundut anu baheula ku jasa éta. HTTP nyaéta ku desain protokol stateless.
- Cacheable - Data ditandaan salaku toko anu tiasa disimpen dina sistem sareng dianggo deui di hareup. Salaku respon kana pamundut sarua tinimbang ngahasilkeun hasil anu sarua. Konstrain cache ngaktifkeun data respon nyirian salaku cacheable atawa non-cacheable.
- Antarbeungeut seragam - Ngidinan antarmuka umum sareng standar pikeun dianggo pikeun aksés. Pamakéan kumpulan tangtu métode HTTP. Nurut kana konsép ieu mastikeun, palaksanaan REST ringan.
Keunggulan REST
- Nganggo format anu langkung saderhana pikeun pesen
- Nawarkeun efisiensi jangka panjang anu langkung kuat
- Ieu ngarojong komunikasi stateless
- Paké standar HTTP na grammar
- Data sayogi salaku sumber
Kakurangan REST
- Gagal dina standar jasa Wéb sapertos Transaksi Kaamanan jsb.
- Paménta REST henteu tiasa skala
REST vs SABUN Babandingan
Beda antara SOAP sareng jasa wéb REST.
| Layanan wéb SOAP | Rest Web Service |
| Merlukeun payload input beurat dibandingkeun REST. | REST téh hampang sabab ngagunakeun URI pikeun formulir data. |
| Parobahan jasa SOAP mindeng ngabalukarkeun parobahan signifikan dina kode dina sisi klien. | Kode sisi klien henteu kapangaruhan ku parobahan dina jasa dina penyediaan wéb REST. |
| Jenis balik téh salawasna tipe XML. | Nyadiakeun versatility ngeunaan bentuk data balik. |
| A protokol pesen basis XML | Hiji protokol arsitéktur |
| Merlukeun perpustakaan SOAP dina tungtung klien. | Taya rojongan perpustakaan diperlukeun ilaharna dipaké leuwih HTTP. |
| Ngarojong WS-Kaamanan jeung SSL. | Ngarojong SSL na HTTPS. |
| SOAP nangtukeun kaamanan sorangan. | Ladenan wéb RESTful ngawariskeun ukuran kaamanan tina angkutan dasar. |
Jenis Kawijakan Pelepasan API
Kabijakan pelepasan pikeun API nyaéta:
Kabijakan pelepasan swasta:
API ngan sadia pikeun pamakéan internal parusahaan.
Kabijakan pelepasan mitra:
API ngan sadia pikeun mitra bisnis husus. Perusahaan tiasa ngontrol kualitas API kusabab kontrol anu tiasa ngaksés éta.
Kabijakan pelepasan umum:
API pikeun pamakéan umum. Kasadiaan kawijakan release sadia pikeun umum. Conto: Microsoft Windows API sareng Apple's Cocoa.
kacindekan
API aya di mana waé, naha anjeun mesen penerbangan atanapi ngiringan aplikasi média sosial. SOAP API dumasar kana komunikasi XML, éta béda ti REST API nu teu merlukeun sagala konfigurasi husus.
Ngarancang jasa Wéb Istirahat kedah patuh kana konsép-konsép anu tangtu, kalebet alamat, statelessness, cacheability, sareng antarmuka standar. Aturan pelepasan API tiasa dibagi kana tilu kategori: API swasta, API mitra, sareng API umum.
Hatur nuhun pikeun maca artikel ieu. Pariksa artikel kami dina Guide to Kaamanan API 2022.