Isomo rigufi · Kinyarwanda

Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe

Koresha urupapuro rwiteguye rwo gushaka ububiko bwa kode, wongeremo igisubizo kimwe gifasha uri kumwe n'umufasha, ugenzure ibisubizo bisanzwe, iby'ibibuze n'ibya serivisi itaboneka.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka amakuru mashya ava mu yindi serivisi ku rubuga. Urupapuro watanzwe n'umufasha wo kwandika kode bitunganya kode ya mushakisha; ushobora kwibanda ku gisubizo.

Mbere yo gutangira

Umwitozo watanzwe, interineti no kureba kuri HTTP yo kuri mudasobwa umufasha wawe ashobora gutangiza. Uru rugero rusoma ububiko rusange bwa GitHub nta kimenyetso cy'ibanga; kuboneka kwa serivisi n'imbibi z'ubusabe biracyakurikizwa.

Igihe kigereranyijwe: 14–26 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Ibyifuzo bya GitHub bitoherejweho ibyangombwa byo kwemeza uburenganzira bisangira umubare ntarengwa ushingiye kuri IP; ibigeragezo bisubirwamo bishobora kuwugeraho.

Ibyo uziga

  • Shaka ububiko bwa kode nyabwo rusange.
  • Garagaza igisubizo cy'inyongera gifasha uri kumwe n'umufasha wo kwandika kode.
  • Tandukanya ububiko bwa kode butabonetse na serivisi itaboneka.

Dosiye z'imyitozo

Intambwe 1

Fungura uburyo bwo gushaka bwiteguye

Saba serivisi agaciro aho kwandika umubare udahinduka mu rupapuro.

Saba umufasha gutangiza ububiko public watanzwe kuri HTTP. Koresha urugero rwa octocat / Hello-World rwo mu mushinga w'ibanze ukande buto yo gushaka.

Gereranya umwirondoro w'ububiko bwa kode n'umubare byasubijwe n'igisubizo cya serivisi muri icyo gihe. Ntushyire umubare wa kera muri kode nk'aho ari uw'ubu.

Urugero rufatika

Umubare w'inyenyeri ubitswe mu nyandiko y'urupapuro ntushobora guhinduka iyo ububiko bwa kode buhindutse.

Tangiza urupapuro watanzwe rwo gushaka ububiko rusange bwa kode kuri HTTP yo kuri mudasobwa. Gumana kugaragaza inyandiko mu mutekano bisanzweho kandi ntushyire ikimenyetso cy'ibanga muri dosiye za mushakisha. Mfasha kugerageza ububiko nyabwo, ubutabaho n'ubusabe bwa serivisi bwananiranye. Hanyuma wongeremo umubare w'ibintu bifunguye wanditse mu mabwiriza umfashe kuwugereranya n'igisubizo cya API. Nkorera impinduka za kode.

GitHub: kubona ububiko

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Erekana amakuru ava ku yindi serivisi

Zana izina ry'ububiko bwa rusange, ibisobanuro n'umubare w'inyenyeri kuri GitHub.

API ni uburyo busobanuye porogaramu isaba amakuru cyangwa igikorwa. Hano urubuga rwawe rusaba GitHub ububiko bumwe rukabona JSON aho kubona urupapuro rwa HTML.

Dukoresha igikorwa cyo gusoma cya rusange kugira ngo wige kwakira no gucunga ibyifuzo utabanje ku kwemeza umwirondoro. Igisubizo gishobora guhinduka hagati y'ibyifuzo; ni icyo wabonye ubu, si umubare wo gushyira muri kode ngo ugumemo.

Urugero rusobanuye

Ku nyirabwo octocat n'ububiko Hello-World, inzira y'icyifuzo ni /repos/octocat/Hello-World kuri api.github.com. Urupapuro rwerekana full_name na stargazers_count byasubijwe.

GitHub: kubona ububiko

Extra implementation exercise

Ni irihe tandukaniro hagati yo gukoporora umubare w'inyenyeri muri HTML no kuwuzana igihe buto ikanzwe?

Erekana igisubizo gisobanuye

HTML yakoporowe igumana agaciro ka kera kugeza ihinduwe. Fetch isaba igisubizo kigezweho muri ako kanya, ariko ikeneye gucunga igihe amakuru akiri kuzanwa n'igihe byananiranye kuko serivisi cyangwa urusobe bishobora kutasubiza.

  • Hasobanurwa igihe agaciro kabonekeye.
  • Hamenyekana ko icyifuzo cyo hanze gishobora kunanirwa.

Intambwe 2

Genzura igisubizo kimwe cyatsinze

Koresha ibyo wiboneye ushobora kugereranya n'inkomoko.

Saba umufasha kwerekana igisubizo cya API rusange gihuye n'ububiko bwawe bw'igerageza, wemeze ko urupapuro rwerekana indangagaciro zigamijwe. Igerageza rigume ari rusange kandi ritarimo amakuru y'ibanga.

Ubusabe busubiza ikosa ntibugomba gufatwa nk'igisubizo gisanzwe. Ntukeneye kwandika kode y'ubusabe n'amakosa kugira ngo ucire urubanza igisubizo kigaragara.

Urugero rufatika

Indangagaciro z’igisubizo z’icyitegererezo: full_name = practice/example na stargazers_count = 12 zigomba guhinduka izina rigaragara practice/example n’inyenyeri 12. Ni indangagaciro z’impimbano zo kumva uko bihuzwa, si umubare w’ubu w’urugero rwa GitHub watanzwe.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Kora kandi ugenzure icyifuzo kimwe

Shyira ibyinjijwe n'ukoresha mu buryo bukwiye inzira kandi usuzume igisubizo mbere yo kugikoresha.

Soma public/app.js kandi ukore urupapuro watanzwe kuri HTTP. encodeURIComponent igumisha buri gaciro ka nyir'ububiko n'izina ryabwo mu gice cyako cy'inzira. Host ntihinduka; usura ntatanga endpoint iyo ari yo yose yishakiye.

fetch irarangiza ku makosa ya HTTP nka 404, bityo kuyitegereza gusa ntibihagije. Suzuma response.ok n'imimerere ikwiye, usesengure JSON, hanyuma ugenzure imyanya iki gikorwa gikeneye. textContent yerekana inyandiko zo hanze nk'inyandiko zisanzwe.

Agace gato ka kode kari hasi kerekana igenzura rusange rya HTTP. app.js yuzuye ibanza gucunga 404 n'ibisubizo bibujijwe cyangwa byarenze umubare w'ibyifuzo, hanyuma ikagenzura ibindi bisubizo bitagenze neza, igasesengura JSON kandi ikagenzura imyanya. Gumisha urwo ruhererekane iyo wongeyemo undi mwanya ugaragazwa.

Urugero rusobanuye

Ibisobanuro birimo utumenyetso tw'imfuruka bigomba kuguma ari inyandiko igaragara, aho guhinduka markup y'urupapuro. 404 igomba kwerekana ubutumwa bwo kubura cyangwa kutaboneka ku mugaragaro aho kuba ikarita y'intsinzi irimo ubusa.

if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;

Extra implementation exercise

Kuki try/catch byonyine bitabona buri gisubizo cya HTTP kitagenze neza?

Erekana igisubizo gisobanuye

Amakosa ya HTTP ashobora gutanga ikintu gisanzwe cya Response. Suzuma status/ok kandi uterure ikosa cyangwa uricunge mbere yo gufata ibirimo byacyo nk'ububiko wasabye.

  • Hamenyekana ko fetch ishobora kurangiza kuri 404/500.
  • Imimerere igenzurwa mbere yo kwerekana intsinzi.

Intambwe 3

Gerageza ibibuze na serivisi itaboneka

Kunanirwa gutandukanye gukomeze kumvikana.

Gerageza izina ry'ububiko bwa kode butabaho. Uri kumwe n'umufasha, gerageza n'ubusabe bwabujijwe cyangwa bwananiranye ku rupapuro rw'umwitozo rwo kuri mudasobwa. Gumana ibyo wanditse ushaka kugira ngo ubikosore cyangwa wongere ugerageze.

Urupapuro rugomba gutandukanya ububiko bwa kode bubuze no kunanirwa kwa serivisi kw'agateganyo. Ntushyire ikimenyetso cy'ibanga muri mushakisha kugira ngo urenge imbibi z'ubusabe.

Urugero rufatika

«Ububiko bwa kode ntibwabonetse» na «Serivisi ntiboneka; ongera ugerageze» bibwira umushyitsi ibikorwa bikurikira bitandukanye.

GitHub: umubare ntarengwa w'ibyifuzo bya REST API

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tuma imimerere yo kunanirwa itandukanywa

Kubura ububiko, kubura urusobe no kuba waramaze umubare w'ibyifuzo wemererwa ni ibibazo bitandukanye.

Gerageza ububiko bwa rusange nyabwo, izina rizwi neza ko ritabaho n'uburyo bwa offline bwa mushakisha. UI ikuraho igisubizo cya kera mbere y'icyifuzo gishya, ikabuza kohereza kabiri kandi ikongera igakoresha buto nyuma.

GitHub ishobora kwanga ibyifuzo bitoherejweho ibyangombwa byo kwemeza uburenganzira kubera imbibi zishingiye kuri IP. Ntubikemure ushyira token y'ibanga muri mushakisha. Kugira ngo ukomeze gukoresha API ukoresheje ibyangombwa byo kwemeza uburenganzira, nimurira ibyo byangombwa ku nzira ya seriveri igenzurwa kandi ubike ibisubizo muri cache aho bikwiye.

Urugero rusobanuye

Niba ikarita y'intsinzi iguma igaragara munsi ya «Not found» bivuga ko bitabonetse, usura ashobora kwitiranya amakuru ashaje n'igisubizo gishya. Gukuraho igisubizo cya kera bituma imimerere y'icyifuzo kiriho yumvikana neza.

GitHub: umubare ntarengwa w'ibyifuzo bya REST API

Extra implementation exercise

Gushakisha birananiwe nyuma y'ibizamini byinshi. UI ikwiye kuvuga ko ububiko bufite inyenyeri zeru?

Erekana igisubizo gisobanuye

Oya. Zeru ni agaciro nyako k'amakuru. Vuga ko amakuru atabonetse cyangwa yabujijwe kandi usuzume imimerere; umubare ntuzwi kugeza igisubizo cyagenze neza kiwutanze.

  • Amakuru atabonetse ntahindurwa zeru.
  • Hasuzumwa imimerere y'icyifuzo n'ibimenyetso by'umubare w'ibyifuzo usigaye.

Intambwe 4

Ongeramo igisubizo gifasha

Sobanura amakuru mashya ureke umufasha ayahuze.

Saba umufasha kongeramo umwanya open_issues_count w’igisubizo iruhande rw’ibisanzwe, awite open issues and pull requests. Uyu mubare wa GitHub urimo ibyiciro byombi; ntukwitwe bugs gusa. Koresha urugero watanzwe nyuma yo kugerageza verisiyo yawe.

Gereranya agaciro kerekanywe n’igisubizo nyacyo, hanyuma usubiremo ibyatsinze, ibyabuze n’ibitabonetse. Wowe ureba igisobanuro n’imimerere wiboneye; umufasha yandika ibikenewe muri mushakisha.

Urugero rufatika

Umubare w’impimbano open_issues_count wa 5 ushobora kuba issues ebyiri zifunguye na pull requests eshatu zifunguye. Ikirango kivuga bugs 5 cyaba cyemeza ibyo uwo mwanya utemeza.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Umukoro wawe: ongeraho umwanya umwe w'ububiko w'ingirakamaro

Ongeraho umubare wa issues ugumana itandukaniro risobanutse hagati y'amakuru n'amakosa.

Erekana open_issues_count umaze kugenzura ko ari umubare wemewe, utari NaN cyangwa Infinity. Menya ko umubare wa GitHub w'ububiko urimo pull requests nk'uko inyandiko zibivuga; ntuwite umubare nyawo w'amakosa yatanzwe gusa.

Andika ugushakisha kumwe kwagenze neza, ububiko bwabuze n'igerageza rya offline. Shyiramo ibyo usura abona igihe icyifuzo kigikorwa na nyuma ya buri gisubizo.

Urugero rusobanuye

Izina nka «Open issues and pull requests» risobanura issues na pull requests bitarafungwa kandi rigaragaza neza icyo agaciro gapima kurusha «Bugs» bivuga amakosa.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Extra implementation exercise

Ongera ku gisubizo umubare w'ibitarafungwa nk'uko inyandiko ziwusobanura kandi werekane imimerere itatu yose.

Erekana igisubizo gisobanuye

Ongeraho open_issues_count ku myanya igenzurwa nyuma yo gucunga imimerere yagenze neza. Saba umubare ufite iherezo, hanyuma uwuhe izina 'Open issues and pull requests' kuko uwo mwanya w'ububiko bwa GitHub urimo byombi. Script yuzuye y'urugero igumana kwerekana inyandiko hakoreshejwe textContent n'imimerere isanzwe yo kuzanwa kw'amakuru n'amakosa.

Amakuru y'urugero yo kugerageza: full_name='sample/site', stargazers_count=3, open_issues_count=2 bitanga 'sample/site — 3 stars — 2 open issues and pull requests', bivuga inyenyeri 3 na issues na pull requests 2 bitarafungwa. Ntibivuga ko ibyo bintu bibiri byose ari amakosa.

Ongera ugerageze ububiko bwa rusange buboneka, 404 na offline. Kuraho ikarita ya mbere mu ntangiriro y’ugushakisha gukurikira; ikosa ntirigomba kugumana imibare ishaje cyangwa gusimbuza amakuru atabonetse zeru.

  • Umubare wongewemo uragenzurwa kandi ukitwa izina rikwiye.
  • Nta ntsinzi ishaje iguma igaragara nyuma y'ugushakisha gushya kwananiranye.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo