
Somo fupi · Kiswahili
Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
Tumia ukurasa tayari wa kutafuta hifadhi, ongeza matokeo moja yenye manufaa kwa msaada wa msaidizi na ukague majibu ya kawaida, kutokuwepo na kutopatikana.
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.
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.
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.
Utakachojifunza
- Tafuta hifadhi halisi ya umma.
- Onyesha matokeo ya ziada yenye manufaa kwa msaidizi wa programu.
- Tofautisha kutokuwepo kwa hifadhi inayolingana na huduma isiyopatikana.
Hatua 1
Fungua utafutaji ulio tayari
Omba thamani kutoka huduma badala ya kuandika namba isiyobadilika kwenye ukurasa.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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 2
Kagua jibu moja lililofaulu
Tumia uchunguzi unaoweza kulinganisha na chanzo.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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;Extra implementation exercise
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 3
Jaribu hali za kutokuwepo na kutopatikana
Weka hitilafu tofauti zieleweke.
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.
GitHub: mipaka ya kasi ya maombi ya REST API
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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
Extra implementation exercise
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 4
Ongeza matokeo yenye manufaa
Eleza taarifa mpya na umruhusu msaidizi aiunganishe.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuwaruhusu watumiaji kupakia picha
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kupokea malipo kwenye tovuti yako
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma