
Isomo rigufi 16 kuri 30 · Guhuza amakuru n'ubwenge bukorano
Fungura uburyo bwo gushaka bwiteguye
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.
Saba serivisi agaciro aho kwandika umubare udahinduka mu rupapuro.
Intego y'iri somo
- 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.
Ibisobanuro, urugero rusobanuye n'imyitozo
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.
Reba ubumenyi bwo gutangiriraho
Ni ubumenyi bw’ingirakamaro, si amasomo utegetswe kubanza kurangiza. Niba ubuzi, tangirira hano; niba utabwuzi, fungura amasomo y’imyiteguro. Dosiye zo gutangira ziratanzwe; ntukeneye urubuga rwawe wari usanganywe.
- Uko wakora urubuga rwawe rwa mbere
Kora intangiriro, igice cy'imishinga n'inzira yo kuvugana nawe ukoresheje umushinga w'ibanze watanzwe.
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.
Sobanukirwa igitekerezo
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
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Ni ubuhe bubiko bwa kode washakishije, kandi urupapuro ruri gukora rwerekanye iki koko?
Erekana igisubizo gisobanuye
Inyandiko y’ishakisha y’icyitegererezo ifite umubare wahimbwe: “Mu gihe nageragezaga, nasabye octocat / Hello-World. Urupapuro rwagaruye octocat/Hello-World n’inyenyeri 12; umwirondoro n’umubare byagaragaraga byahuje n’igisubizo nasuzumye.” 12 ni igipimo cy’impimbano cy’uru rugero, si amakuru y’ubu y’ubwo bubiko bwa kode.
Imibare y’inyenyeri ishobora guhinduka. Inyandiko yawe ikeneye umubare n’igihe cy’igerageza wiboneye koko; niba serivisi itasubije, vuga iyo mimerere aho gusimbuza umubare w’urugero.
Ibigize igisubizo gikwiye
- Avuga nyir’ububiko bwa kode rusange yasabye n’ububiko, n’umwirondoro wagarutse.
- Yandika umubare n’igihe yiboneye cyangwa ikosa nyaryo rya serivisi atanditse umubare w’icyitegererezo muri kode nk’udashobora guhinduka.
Uko bikora (si itegeko)
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.
Undi mwitozo wa tekiniki
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 1 · Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe
Genzura igisubizo kimwe cyatsinze
Koresha ibyo wiboneye ushobora kugereranya n'inkomoko.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
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
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Igisubizo cyo ku rupapuro cyahuye n'igisubizo cy'ububiko bwa kode wasuzumye?
Erekana igisubizo gisobanuye
Guhuza kw’icyitegererezo hakoreshejwe indangagaciro z’impimbano: igisubizo gifite full_name = practice/example na stargazers_count = 12 kigomba kwerekana practice/example n’inyenyeri 12. Ntikigomba kugumana izina ry’ububiko bwa mbere cyangwa guhindura umubare ubura ngo ube zero.
Mu igenzura nyaryo ryawe, koresha igisubizo nyacyo cy’ububiko wasabye muri icyo gihe. Igisubizo cy’uko warengeje imbibi z’ubusabe ntigifite umubare usanzwe w’inyenyeri wo kwerekana.
Ibigize igisubizo gikwiye
- Ahuza umwirondoro n’umubare w’inyenyeri by’urupapuro n’igisubizo kimwe cya serivisi rusange.
- Ntavuga igisubizo cy’ikosa cyangwa umwanya ubura nk’igisubizo gisanzwe gifite zero.
Uko bikora (si itegeko)
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;Undi mwitozo wa tekiniki
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 2 · Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe
Gerageza ibibuze na serivisi itaboneka
Kunanirwa gutandukanye gukomeze kumvikana.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
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.
Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Amagerageza yombi yo kunanirwa yerekanye iki, kandi umushyitsi yashoboye kongera gukomeza?
Erekana igisubizo gisobanuye
Inyandiko yo kunanirwa y’icyitegererezo: “Izina ry’ububiko ryahimbwe ryerekanye Repository not found or not publicly accessible. Nabujije ubusabe nkana mu igerageza rya hafi, ishakisha ryerekana ikosa; imyanya ya nyir’ububiko n’ububiko yaragumye kandi buto yashoboraga kongera gukoreshwa.”
Ubwo busabe bwabujijwe ni ukwigana ikibazo, si gihamya ko GitHub yahagaze koko. Kugera ku mbibi z’ubusabe bigomba gutuma wongera nyuma, si ugushyira token ya konti y’ibanga muri kode rusange y’urupapuro.
Ibigize igisubizo gikwiye
- Yandika ibisubizo bitandukanye by’ububiko bwa kode butabonetse n’igerageza ry’ubusabe bwabiranye ryafashijwe.
- Agenzura ko ibyo washakishije biguma bishobora gukosorwa cyangwa kongera kugeragezwa, nta kongeramo token y’ibanga muri mushakisha.
Uko bikora (si itegeko)
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
Undi mwitozo wa tekiniki
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 3 · Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe
Ongeramo igisubizo gifasha
Sobanura amakuru mashya ureke umufasha ayahuze.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
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
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Ongeramo igiteranyo cya open issues and pull requests. Agaciro kerekanwe kagereranyije gate n’igisubizo, kandi byagenze bite mu magerageza y’ibyabuze n’ibitabonetse?
Ibyo ugomba gukora: Urupapuro rwo gushaka rwavuguruwe n'ibisubizo wiboneye by'ibisanzwe, kubura no kunanirwa kwa serivisi.
Erekana igisubizo gisobanuye
Guhuza kw’icyitegererezo: “Ku gisubizo cy’impimbano gifite open_issues_count = 5, urupapuro rwerekana 5 open issues and pull requests. Icyo giteranyo gishobora kuba issues ebyiri na pull requests eshatu; si umubare w’amakosa atanu.”
Inyandiko y’igerageza y’icyitegererezo: “Ishakisha risanzwe ryahuje n’igisubizo; ububiko butariho bwagumanye ubutumwa bwo kutaboneka; kwigana ubusabe bwabujijwe byagumanye ikosa rishobora kongera kugeragezwa.” Ibyo utanga bigomba kugira agaciro kawe nyako gahuje no kuvuga amagenzura utakoze.
Ibigize igisubizo gikwiye
- Yerekana open_issues_count nka open issues and pull requests, atari bugs cyangwa issues gusa.
- Agereranya agaciro gashya n’igisubizo agasubiramo imimerere isanzwe, ibuze n’itabonetse.
Uko bikora (si itegeko)
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.
Undi mwitozo wa tekiniki
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.