
Somo fupi 16 kati ya 30 · Unganisha data na AI
Fungua utafutaji ulio tayari
Somo hili ni la nani?
Kwa watu wanaotaka taarifa za sasa kutoka huduma nyingine kwenye tovuti. Ukurasa uliotolewa na msaidizi wa programu hushughulikia msimbo wa kivinjari; unaweza kulenga matokeo.
Omba thamani kutoka huduma badala ya kuandika namba isiyobadilika kwenye ukurasa.
Utakachojifunza katika somo hili
- Tafuta hifadhi halisi ya umma.
- Onyesha matokeo ya ziada yenye manufaa kwa msaidizi wa programu.
- Tofautisha kutokuwepo kwa hifadhi inayolingana na huduma isiyopatikana.
Maelezo, mfano uliotatuliwa na zoezi
Kabla ya kuanza
Nyenzo za warsha zilizotolewa, intaneti na mwonekano wa awali wa HTTP wa ndani ya kifaa unaoweza kuanzishwa na msaidizi wako wa programu. Mfano huu husoma hifadhi za umma za GitHub bila tokeni binafsi; upatikanaji na mipaka ya maombi ya huduma bado inatumika.
Angalia ujuzi wa kuanzia
Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
Unda utangulizi, sehemu ya miradi na njia ya mawasiliano kutoka kwenye kiolezo kilichotolewa.
Muda unaokadiriwa: 14–26 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Maombi ya GitHub yasiyo na uthibitishaji hushiriki kikomo kinachotegemea IP; majaribio yanayorudiwa yanaweza kukifikia.
Elewa wazo
Mwombe msaidizi aanzishe folda ya public iliyotolewa kwa HTTP. Tumia mfano wa octocat / Hello-World wa kiolezo na uwashe kitufe chake cha kutafuta.
Linganisha utambulisho na idadi ya hifadhi iliyorudishwa na matokeo ya huduma wakati huo. Usiweke namba ya zamani ndani ya msimbo kana kwamba ni ya sasa.
Mfano halisi
Idadi ya nyota iliyohifadhiwa kwenye maandishi ya ukurasa haiwezi kubadilika hifadhi inapobadilika.
Anzisha ukurasa uliotolewa wa kutafuta hifadhi za umma kwa HTTP ya ndani ya kifaa. Hifadhi uonyeshaji salama uliopo wa maandishi na usiongeze tokeni binafsi kwenye faili za kivinjari. Nisaidie kujaribu hifadhi halisi, iliyokosekana na ombi la huduma lililoshindwa. Kisha ongeza idadi ya vipengele vilivyo wazi iliyoelezwa kwenye nyaraka na unisaidie kuilinganisha na jibu la API. Shughulikia mabadiliko ya msimbo kwa ajili yangu.Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Ulitafuta hifadhi ipi, na ukurasa unaoendeshwa ulionyesha matokeo gani kweli?
Onyesha mfano wa suluhisho
Rekodi ya mfano yenye idadi ya kubuni: “Wakati wa jaribio, niliomba octocat / Hello-World. Ukurasa ulirudisha octocat/Hello-World na nyota 12; utambulisho na idadi vililingana na jibu nililokagua.” Hii 12 ni kipimo cha kubuni, si ukweli wa sasa wa hazina hiyo.
Idadi ya nyota hubadilika. Rekodi inahitaji namba na muda uliouona kweli; huduma isipotoa jibu, sema hivyo badala ya kutumia namba hii.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anataja mmiliki/hazina ya umma iliyoombwa kweli na utambulisho uliorudi.
- Anaripoti idadi/muda aliouona au kosa kamili bila kuweka namba ya mfano ndani ya programu.
Jinsi inavyofanya kazi (si lazima)
Onyesha data kutoka huduma nyingine
Pakia jina, maelezo na idadi ya nyota za repository ya umma kutoka GitHub.
API ni njia iliyoainishwa ya programu kuomba data au kitendo. Hapa tovuti yako huiomba GitHub repository moja na hupokea JSON badala ya ukurasa wa HTML.
Tunatumia usomaji wa umma ili ujifunze kushughulikia maombi bila kuanza na uthibitishaji wa mtumiaji. Matokeo yanaweza kubadilika kati ya maombi; ni uchunguzi wa wakati huo, si namba ya kuandika moja kwa moja kwenye msimbo.
Mfano uliotatuliwa
Kwa mmiliki octocat na repository Hello-World, njia ya ombi ni /repos/octocat/Hello-World kwenye api.github.com. Ukurasa unaonyesha full_name na stargazers_count zilizorudishwa.
Zoezi la ziada la utekelezaji
Kuna tofauti gani kati ya kunakili idadi ya nyota kwenye HTML na kuipata wakati kitufe kinapobonyezwa?
Onyesha mfano wa suluhisho
HTML iliyonakiliwa hubakiza thamani ya zamani hadi ihaririwe. Fetch huomba jibu la sasa wakati huo, lakini inahitaji kushughulikia kupakia na kushindwa kwa sababu huduma au mtandao vinaweza kutojibu.
- Anaeleza thamani inapatikana wakati gani.
- Anatambua ombi la huduma ya nje linaweza kushindwa.

Hatua 1 · Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
Kagua jibu moja lililofaulu
Tumia uchunguzi unaoweza kulinganisha na chanzo.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Mwombe msaidizi aonyeshe jibu la API ya umma linalolingana na hifadhi yako ya jaribio na uhakiki ukurasa unaonyesha thamani zilizokusudiwa. Weka jaribio la umma bila taarifa nyeti.
Ombi linalorudisha hitilafu lisichukuliwe kama matokeo ya kawaida. Huhitaji kuandika msimbo wa ombi na hitilafu ili kuhukumu matokeo yanayoonekana.
Mfano halisi
Thamani za mfano: full_name = practice/example na stargazers_count = 12 zinapaswa kuonekana kama jina practice/example na nyota 12. Hizi ni thamani za kubuni za kueleza uhusiano, si idadi ya sasa ya mfano wa GitHub.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Matokeo ya ukurasa yalilingana na jibu la hifadhi ulilokagua?
Onyesha mfano wa suluhisho
Ulinganisho wa mfano wenye thamani za kubuni: full_name = practice/example na stargazers_count = 12 zionyeshe practice/example na nyota 12. Zisihifadhi jina la hazina iliyopita wala kugeuza idadi iliyokosekana kuwa sifuri.
Kwa ukaguzi halisi, tumia jibu halisi la hazina uliyoomba wakati huo. Jibu la kikomo cha maombi halina idadi ya kawaida ya nyota ya kuonyesha.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Analinganisha utambulisho na nyota za ukurasa na jibu lilelile la huduma ya umma.
- Haonyeshi jibu la kosa au sehemu isiyopo kama matokeo ya kawaida yenye sifuri.
Jinsi inavyofanya kazi (si lazima)
Tengeneza na ukague ombi moja
Simba thamani za mtumiaji kwa URL na ukague jibu kabla ya kulitumia.
Soma public/app.js na uendeshe ukurasa uliotolewa kupitia HTTP. encodeURIComponent huweka kila thamani ya mmiliki/repository kwenye sehemu yake ya njia. Jina la mwenyeji wa API limewekwa tayari katika msimbo; mgeni hatoi endpoint yoyote anayochagua.
fetch hukamilika pia kwa makosa ya HTTP kama 404, hivyo kuisubiri pekee hakutoshi. Kagua response.ok na hali husika, soma JSON, kisha uhakikishe sehemu zinazohitajika na kipengele. textContent huonyesha maandishi kutoka nje kuwa maandishi ya kawaida.
Kipande kifupi hapa chini kinaonyesha ukaguzi wa jumla wa HTTP. Faili kamili ya app.js hushughulikia kwanza 404 na majibu yaliyozuiwa au yaliyofikia kikomo cha maombi, kisha hukagua hali nyingine zisizofanikiwa, husoma JSON na kuthibitisha sehemu. Hifadhi mpangilio huo unapoongeza sehemu mpya ya kuonyesha.
Mfano uliotatuliwa
Maelezo yenye alama za mabano ya pembe yanapaswa kubaki maandishi yanayoonekana, yasigeuke kuwa HTML ya ukurasa. Jibu la 404 lionyeshe ujumbe wa kutopatikana au ufikiaji wa umma badala ya kadi tupu ya mafanikio.
if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;Zoezi la ziada la utekelezaji
Kwa nini try/catch pekee haigundui kila jibu la HTTP lisilofanikiwa?
Onyesha mfano wa suluhisho
Makosa ya HTTP bado yanaweza kutoa kitu cha kawaida cha Response. Kagua status/ok na uanzishe au ushughulikie kosa kabla ya kuchukulia maudhui yake kuwa repository iliyoombwa.
- Anajua fetch inaweza kukamilika kwa 404/500.
- Anakagua hali kabla ya kuonyesha mafanikio.

Hatua 2 · Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
Jaribu hali za kutokuwepo na kutopatikana
Weka hitilafu tofauti zieleweke.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Jaribu jina la hifadhi lisilokuwepo. Ukiwa na msaidizi wako, jaribu pia ombi lililozuiwa au kushindwa kwenye ukurasa wa ndani wa mazoezi. Hifadhi swali lililoandikwa kwa kurekebisha au kujaribu tena.
Ukurasa utofautishe hifadhi iliyokosekana na hitilafu ya muda ya huduma. Usiongeze tokeni binafsi ya kivinjari kukwepa kikomo cha maombi.
Mfano halisi
“Hifadhi haijapatikana” na “Huduma haipatikani; jaribu tena” humwambia mgeni hatua tofauti zinazofuata.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Hali hizo mbili za kushindwa zilionyesha nini, na mgeni aliweza kuendelea?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Jina la kubuni lilionyesha Repository not found or not publicly accessible. Ombi lilipozuiwa makusudi kwa jaribio la ndani, ukurasa ulionyesha kosa; sehemu za mmiliki/hazina zilibaki na kitufe kiliweza kujaribiwa tena.”
Ombi lililozuiwa ni uigaji, si ushahidi wa GitHub kukatika kweli. Kikomo kielekeze kurudia baadaye, si kuweka token binafsi kwenye msimbo wa umma.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anaandika matokeo tofauti ya hazina isiyopo na jaribio la ombi lililoshindwa kwa msaada.
- Anahakiki swali linaendelea kutumika kurekebisha au kurudia bila kuongeza token binafsi kwenye kivinjari.
Jinsi inavyofanya kazi (si lazima)
Fanya hali za kushindwa zitofautishike
Kutokuwa na repository, kukosa mtandao na kuisha kikomo cha matumizi ni matatizo tofauti.
Jaribu repository halisi ya umma, jina lisilopo wazi na hali ya kivinjari ya kutokuwa na mtandao. Kiolesura huondoa matokeo ya zamani kabla ya ombi jipya, huzuia kutuma mara mbili na hurudisha kitufe baada ya ombi.
GitHub inaweza kukataa maombi yasiyothibitishwa kwa sababu ya mipaka ya IP. Usitatue hilo kwa kuweka tokeni ya siri kwenye kivinjari. Kwa matumizi endelevu yenye uthibitishaji, hamishia matumizi ya taarifa za ufikiaji kwenye njia ya seva inayodhibitiwa na utumie cache inapofaa.
Mfano uliotatuliwa
Ikiwa kadi ya mafanikio inabaki chini ya “Not found”, mgeni anaweza kudhani data ya zamani ni matokeo ya utafutaji mpya. Kuondoa matokeo ya zamani hufanya hali ya ombi la sasa iwe wazi.
GitHub: mipaka ya kasi ya maombi ya REST API
Zoezi la ziada la utekelezaji
Utafutaji unashindwa baada ya majaribio mengi. Je, kiolesura kiseme repository ina nyota sifuri?
Onyesha mfano wa suluhisho
Hapana. Sifuri ni thamani halisi ya data. Ripoti data kutopatikana au kuzuiwa na ukague hali; idadi haijulikani hadi jibu lililofaulu liitoe.
- Hageuzi data isiyopatikana kuwa sifuri.
- Anakagua hali ya ombi na ushahidi wa kikomo cha matumizi.

Hatua 3 · Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
Ongeza matokeo yenye manufaa
Eleza taarifa mpya na umruhusu msaidizi aiunganishe.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Mwombe msaidizi aongeze open_issues_count karibu na matokeo na aiite masuala na pull request zilizo wazi. Jumla hii ya GitHub ina makundi yote mawili; isiitwe hitilafu pekee. Tumia rejea baada ya kujaribu toleo lako.
Linganisha thamani inayoonekana na jibu halisi, kisha rudia mafanikio, kutokuwepo na kutopatikana. Wewe unapima maana na hali; msaidizi anashughulikia utekelezaji wa kivinjari.
Mfano halisi
open_issues_count ya kubuni ya 5 inaweza kuwa masuala mawili na pull request tatu zilizo wazi. Lebo hitilafu 5 ingedai kitu ambacho sehemu hiyo haithibitishi.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Ongeza jumla ya masuala na pull request zilizo wazi. Thamani ililingana vipi na jibu, na nini kilitokea kwa kutokuwepo/kutopatikana?
Unachopaswa kuandaa: Ukurasa uliosasishwa wa utafutaji na matokeo ya kawaida, kutokuwepo na kushindwa kwa huduma uliyoyaona.
Onyesha mfano wa suluhisho
Ulinganisho wa mfano: “Kwa jibu la kubuni la open_issues_count = 5, ukurasa unaonyesha masuala na pull request 5 zilizo wazi. Jumla inaweza kuwa masuala mawili na pull request tatu; si idadi ya hitilafu tano.”
Rekodi ya mfano: “Utafutaji wa kawaida ulilingana na jibu; hazina isiyopo ilihifadhi ujumbe wa kutopatikana; ombi lililozuiwa kwa kuiga lilibaki kosa linalorudiwa.” Wasilisha thamani yako halisi iliyolinganishwa na taja ukaguzi usiofanywa.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anaonyesha open_issues_count kama masuala na pull request zilizo wazi, si hitilafu au masuala pekee.
- Analinganisha thamani mpya na jibu na kurudia hali ya kawaida, isiyopo na isiyopatikana.
Jinsi inavyofanya kazi (si lazima)
Kazi yako: ongeza sehemu moja yenye manufaa ya repository
Ongeza idadi ya issues huku ukihifadhi tofauti wazi kati ya data na makosa.
Onyesha open_issues_count baada ya kuthibitisha kuwa ni namba halali yenye thamani yenye kikomo, si NaN wala Infinity. Kumbuka idadi hii ya repository ya GitHub inajumuisha pull requests kama nyaraka zinavyoeleza; usiiite idadi sahihi ya ripoti za hitilafu pekee.
Rekodi utafutaji mmoja uliofaulu, repository inayokosekana na jaribio bila mtandao. Jumuisha anachoona mgeni wakati wa ombi na baada ya kila matokeo.
Mfano uliotatuliwa
Lebo kama “Open issues and pull requests” (issues na maombi ya kuunganisha msimbo yaliyo wazi) hueleza kipimo kwa usahihi zaidi kuliko “Bugs” (hitilafu).
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Zoezi la ziada la utekelezaji
Panua matokeo kwa idadi ya vipengele vilivyo wazi kama inavyoelezwa na nyaraka, na uonyeshe hali zote tatu.
Onyesha mfano wa suluhisho
Ongeza open_issues_count kwenye sehemu zinazothibitishwa baada ya ukaguzi wa hali kufaulu. Hitaji namba yenye thamani yenye mwisho, kisha ipe lebo “Open issues and pull requests” kwa sababu sehemu hiyo ya GitHub inajumuisha vyote. Skripti kamili ya marejeo huhifadhi textContent na hali zilizopo za kupakia na makosa.
Data ya mfano ya jaribio: full_name='sample/site', stargazers_count=3, open_issues_count=2 hutoa “sample/site — 3 stars — 2 open issues and pull requests”, yaani nyota 3 na issues pamoja na pull requests 2 zilizo wazi. Haimaanishi kuwa vipengele vyote viwili ni hitilafu.
Jaribu tena repository ya umma inayofaulu, 404 na hali bila mtandao. Ondoa kadi ya awali mwanzoni mwa utafutaji unaofuata; kosa lisibakize idadi ya zamani wala kubadilisha data isiyopatikana kuwa sifuri.
- Anathibitisha namba iliyoongezwa na kuipa lebo sahihi.
- Hakuna matokeo ya zamani ya mafanikio yanayobaki baada ya utafutaji mpya kushindwa.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.