
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.
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.
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.Dosiye z'iyi ntambwe
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.
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
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
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
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
- Uko wakora urubuga rwawe rwa mbere
- Uko wasohora urubuga rwawe uhereye kuri GitHub
- Uko wahuza domeni yawe n'urubuga rwawe
- Uko wategura imeli kuri domeni yawe
- Uko watuma urubuga rwawe rukoreshwa kuri telefoni
- Uko watuma amafoto y'urubuga afunguka vuba
- Uko wakwakira ibitekerezo byo ku rubuga muri inbox yawe
- Uko wakongeramo kwiyandikisha kwakira email ku rubuga rwawe
- Uko wakohereza emails zikora ku buryo bwikora ziva ku rubuga rwawe
- Uko wabika ibyoherejwe binyuze muri fomu muri database
- Uko wakwemerera abantu kwinjira muri konti ku rubuga rwawe
- Uko wagumisha urupapuro ari ibanga
- Uko wakwemerera abakoresha guhindura amakuru y'umwirondoro wabo
- Uko wakwemerera abakoresha kohereza amashusho
- Uko wakumira imfunguzo za API muri frontend yawe
- Uko wakongeramo AI chatbot ku rubuga rwawe
- Uko watuma chatbot isubiza ishingiye ku birimo byawe
- Uko wakongeramo blog ku rubuga rwawe
- Uko wakongeramo ishakisha ku rubuga rwawe
- Uko wakongeramo urundi rurimi ku rubuga rwawe
- Uko wafasha Google kubona urubuga rwawe
- Uko wakosora iyerekanwa ry'urubuga rwawe igihe usangiza umurongo
- Uko wapima gusurwa n'ibikorwa by'ingirakamaro ku rubuga rwawe
- Uko wakwemerera abarusura gufata gahunda yo guhura nawe
- Uko wakwakira ubwishyu ku rubuga rwawe
- Uko wareba impinduka z'urubuga mbere yo kuzisohora
- Uko wasubira inyuma nyuma yo gusohora urubuga rwangiritse
- Uko wakora kopi y’ingoboka kandi ugasubizaho amakuru y’urubuga rwawe
- Uko wabona kandi ugakosora amakosa ku rubuga rwawe ruri ku murongo