
አጭር ትምህርት · አማርኛ
ከውጭ API የመጣ ውሂብን በድረ ገጽዎ እንዴት ማሳየት ይችላሉ?
የተዘጋጀውን ማከማቻ መፈለጊያ ገጽ ይጠቀሙ፣ በረዳት እገዛ ጠቃሚ አንድ ውጤት ይጨምሩ፣ መደበኛ፣ ያልተገኘና አገልግሎት የሌለበትን ምላሽ ይፈትሹ።
ይህ ለማን ነው?
ከሌላ አገልግሎት ወቅታዊ መረጃ በድረ ገጻቸው ማሳየት ለሚፈልጉ ሰዎች። የተሰጠው ገጽና የኮድ ጻፊ ረዳት የአሳሹን ኮድ ይሠራሉ፤ እርስዎም በውጤቱ ላይ ማተኮር ይችላሉ።
ከመጀመርዎ በፊት
የተሰጠው የልምምድ ጥቅል፣ የኢንተርኔት ግንኙነትና የኮድ ጻፊ ረዳትዎ ሊያስነሳው የሚችል በአካባቢያዊ HTTP የሚከፈት ቅድመ እይታ ያስፈልጋሉ። ይህ ምሳሌ ይፋዊ የGitHub ማከማቻዎችን ያለ የግል ቶከን ያነባል፤ የአገልግሎት አቅርቦትና የጥያቄ ብዛት ገደቦች ግን ይተገበራሉ።
ግምታዊ ጊዜ: 14–26 ደቂቃ
ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። ያለ ማንነት ማረጋገጫ የሚላኩ የGitHub ጥያቄዎች በIP የተመሠረተ ኮታ ይጋራሉ፤ ተደጋጋሚ ፍተሻዎች ገደቡን ሊደርሱ ይችላሉ።
ምን ይማራሉ?
- እውነተኛ ይፋዊ ማከማቻ ይፈልጉ።
- በኮድ ጻፊ ረዳት እገዛ ጠቃሚ ተጨማሪ ውጤት ያሳዩ።
- የሚዛመድ ማከማቻ አለመገኘትን ከአገልግሎቱ አለመገኘት ይለዩ።
ደረጃ 1
የተዘጋጀውን መፈለጊያ ይክፈቱ
ቋሚ ቁጥር በገጹ ላይ ከመጻፍ ይልቅ እሴቱን ከአገልግሎቱ ይጠይቁ።
ረዳትዎ የተሰጠውን public አቃፊ በHTTP እንዲያስነሳ ይጠይቁ። በመነሻው ያለውን octocat / Hello-World ምሳሌ ተጠቅመው የመፈለጊያ አዝራሩን ያንቁ።
የተመለሰውን የማከማቻ ማንነትና ብዛት በዚያ ጊዜ ካለው የአገልግሎቱ ውጤት ጋር ያወዳድሩ። የድሮ ቁጥርን በኮድ ውስጥ ቋሚ አድርገው እንደ ወቅታዊ አያቅርቡ።
ተጨባጭ ምሳሌ
በገጹ ጽሑፍ የተቀመጠ የኮከብ ብዛት ማከማቻው ሲለወጥ መቀየር አይችልም።
የተሰጠውን ይፋዊ ማከማቻ መፈለጊያ ገጽ በአካባቢያዊ HTTP አስነሳ። ያለውን ደህንነቱ የተጠበቀ የጽሑፍ ማሳያ አስቀጥል፣ በአሳሽ ፋይሎችም የግል ቶከን አትጨምር። እውነተኛ ማከማቻ፣ የሌለ ማከማቻና ያልተሳካ የአገልግሎት ጥያቄ እንድፈትሽ እርዳኝ። ከዚያ በሰነዱ የተገለጸውን የክፍት ንጥሎች ብዛት ጨምር፣ ከAPI ምላሽ ጋርም እንዳወዳድር እርዳኝ። የኮድ ለውጦቹን አንተ ሥራልኝ።የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
ከሌላ አገልግሎት የመጣ ውሂብ ያሳዩ
ከGitHub የይፋዊ ማከማቻ ስም፣ መግለጫና የኮከብ ብዛት ያምጡ።
API ሶፍትዌር ውሂብ ወይም ተግባር የሚጠይቅበት የተወሰነ መንገድ ነው። እዚህ ድረ ገጽዎ GitHubን አንድ ማከማቻ ይጠይቃል፣ ከHTML ገጽ ይልቅም JSON ይቀበላል።
ከማንነት ማረጋገጥ ሳይጀምሩ ጥያቄን ማስተናገድ እንዲማሩ ይፋዊ የማንበብ ተግባር እንጠቀማለን። ውጤቱ በጥያቄዎች መካከል ሊቀየር ይችላል፤ ወቅታዊ ምልከታ ነው፣ በኮድ ውስጥ ቋሚ አድርገው የሚጽፉት ቁጥር አይደለም።
የተሠራ ምሳሌ
ባለቤቱ octocat፣ ማከማቻውም Hello-World ከሆነ፣ የጥያቄ ዱካው በapi.github.com ላይ /repos/octocat/Hello-World ነው። ገጹ የተመለሱትን full_name እና stargazers_count ያሳያል።
Extra implementation exercise
የኮከብ ብዛትን ወደ HTML በመቅዳትና አዝራር ሲጫን በማምጣት መካከል ምን ልዩነት አለ?
የተሠራ መፍትሔ ያሳዩ
የተቀዳ HTML እስኪታረም ድረስ የድሮውን እሴት ይይዛል። fetch በዚያ ቅጽበት ያለውን ምላሽ ይጠይቃል፣ ግን አገልግሎቱ ወይም አውታረ መረቡ ላይመልስ ስለሚችል መጫንንና አለመሥራትን ማስተናገድ ይፈልጋል።
- እሴቱ መቼ እንደሚገኝ ያብራራል።
- የውጭ ጥያቄ ላይሳካ እንደሚችል ያውቃል።
ደረጃ 2
አንድ የተሳካ ምላሽ ይፈትሹ
ከምንጩ ጋር ሊያወዳድሩት የሚችሉትን ምልከታ ይጠቀሙ።
ረዳትዎ ለሙከራ ማከማቻዎ የሚዛመደውን ይፋዊ የAPI ምላሽ እንዲያሳይ ይጠይቁ፣ ገጹም የታሰቡትን እሴቶች እንደሚያሳይ ያረጋግጡ። ሙከራውን ይፋዊና ሚስጥራዊ ያልሆነ ያድርጉት።
ስህተት የሚመልስ ጥያቄ እንደ መደበኛ ውጤት መታየት የለበትም። የሚታየውን ውጤት ለመገምገም የጥያቄውን ወይም የስህተቱን ኮድ መጻፍ አያስፈልግዎትም።
ተጨባጭ ምሳሌ
የምላሽ እሴቶች ምሳሌ፦ full_name = practice/example እና stargazers_count = 12 በሚታይ ማከማቻ ስም practice/example እና 12 ኮከቦች መቀየር አለባቸው። እነዚህ መዛመዱን ለመረዳት የተፈጠሩ እሴቶች ናቸው፣ የተሰጠው የGitHub ምሳሌ የአሁን ቁጥር አይደሉም።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
አንድ ጥያቄ ይፍጠሩና ይፈትሹ
የተጠቃሚ ግቤትን በURL ውስጥ በትክክል ሊወከል ወደሚችል ቅርጽ ይቀይሩ (encode)፣ ምላሹንም ከመጠቀምዎ በፊት ይመርምሩ።
public/app.js ያንብቡና የተሰጠውን ገጽ በHTTP ያስኪዱ። encodeURIComponent የእያንዳንዱን ባለቤት/ማከማቻ እሴት በራሱ የዱካ ክፍል ያስቀምጣል። አስተናጋጁ ቋሚ ነው፤ ጎብኚው የፈለገውን endpoint አያቀርብም።
fetch እንደ 404 ላሉ HTTP ስህተቶችም ይጠናቀቃል፣ ስለዚህ መጠበቅ ብቻ በቂ አይደለም። response.okንና ተዛማጅ ሁኔታዎችን ይፈትሹ፣ JSONን ይተንትኑ፣ ከዚያ ባህሪው የሚፈልጋቸውን መስኮች ያረጋግጡ። textContent የውጭ ሕብረቁምፊዎችን እንደ ጽሑፍ ያሳያል።
ከታች ያለው አጭር ኮድ አጠቃላይ የHTTP መከላከያን ያሳያል። ሙሉው app.js በመጀመሪያ 404ንና የተከለከሉ/የጥያቄ ገደብ የደረሱ ምላሾችን በተለየ ያስተናግዳል፣ ከዚያ ሌሎች ያልተሳኩ ሁኔታዎችን ይፈትሻል፣ JSON ይተነትናል፣ መስኮችንም ያረጋግጣል። አዲስ የሚታይ መስክ ሲጨምሩ ያንን ቅደም ተከተል ይጠብቁ።
የተሠራ ምሳሌ
ማዕዘን ቅንፎች ያሉበት መግለጫ እንደ ጽሑፍ መታየት አለበት፣ የገጽ markup መሆን የለበትም። 404 ባዶ የስኬት ካርድ ከማሳየት ይልቅ አልተገኘም/ይፋዊ መዳረሻ የለም የሚል መልዕክት ማሳየት አለበት።
if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;Extra implementation exercise
try/catch ብቻ ሁሉንም ያልተሳኩ የHTTP ምላሾች ለምን አያገኝም?
የተሠራ መፍትሔ ያሳዩ
የHTTP ስህተቶች አሁንም መደበኛ Response ነገር ሊሰጡ ይችላሉ። ይዘቱን እንደተጠየቀው ማከማቻ ከመቆጠርዎ በፊት status/ok ይፈትሹ፣ ስህተቱንም ያስነሱ ወይም ያስተናግዱ።
- fetch በ404/500 ላይ ሊጠናቀቅ እንደሚችል ያውቃል።
- ስኬትን ከማሳየት በፊት ሁኔታውን ይፈትሻል።
ደረጃ 3
ያልተገኘና አገልግሎት የሌለበትን ሁኔታ ይሞክሩ
የተለያዩ የአለመሳካት ሁኔታዎች ለመረዳት ቀላል ይሁኑ።
የሌለ ማከማቻ ስም ይሞክሩ። በረዳትዎ እገዛ በአካባቢያዊው የልምምድ ገጽ የታገደ ወይም ያልተሳካ ጥያቄም ይፈትሹ። የተጻፈውን ፍለጋ ለማረም ወይም እንደገና ለመሞከር ያቆዩ።
ገጹ የሌለ ማከማቻን ከጊዜያዊ የአገልግሎት ችግር መለየት አለበት። የጥያቄ ብዛት ገደብን ለማለፍ የግል ቶከን በአሳሽ ውስጥ አይጨምሩ።
ተጨባጭ ምሳሌ
“Repository not found” እና “Service unavailable; retry” ለጎብኚው የተለያዩ ቀጣይ እርምጃዎችን ይነግራሉ።
GitHub፦ የREST API የጥያቄ ፍጥነት ገደቦች
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
የአለመሥራት ሁኔታዎችን ተለይተው የሚታወቁ ያድርጉ
ማከማቻ አለመኖር፣ አውታረ መረብ አለመኖርና ኮታ ማለቅ የተለያዩ ችግሮች ናቸው።
እውነተኛ ይፋዊ ማከማቻ፣ በግልጽ የሌለ ስም እና የአሳሽ offline ሁኔታ ይፈትሹ። UIው ከአዲስ ጥያቄ በፊት የድሮውን ውጤት ያጸዳል፣ ተደጋጋሚ ማስገባትን ያሰናክላል፣ ከዚያም አዝራሩን ይመልሳል።
በIP የተመሠረቱ ገደቦች ምክንያት GitHub ያለ ማንነት ማረጋገጫ ጥያቄዎችን ሊከለክል ይችላል። ምላሹን የግል token በአሳሽ ውስጥ በማስገባት አይፍቱ። በማንነት ማረጋገጫ ለቀጣይ አጠቃቀም፣ የመግቢያ መረጃ አጠቃቀምን ወደተቆጣጠረ የአገልጋይ መንገድ ያዛውሩ፣ አስፈላጊ ቦታም cache ያድርጉ።
የተሠራ ምሳሌ
የስኬት ካርድ «Not found» ማለትም «አልተገኘም» በሚለው ሥር ከቀረ፣ ጎብኚ የቆየ ውሂብን እንደ አዲስ ፍለጋ ሊሳሳት ይችላል። የድሮውን ውጤት ማጽዳት የአሁኑን ጥያቄ ሁኔታ ግልጽ ያደርጋል።
GitHub፦ የREST API የጥያቄ ፍጥነት ገደቦች
Extra implementation exercise
ከብዙ ፍተሻዎች በኋላ ፍለጋ አልተሳካም። UIው ማከማቻው ዜሮ ኮከቦች አሉት ማለት አለበት?
የተሠራ መፍትሔ ያሳዩ
አይደለም። ዜሮ እውነተኛ የውሂብ እሴት ነው። ውሂቡ አይገኝም/ተከልክሏል ይበሉና ሁኔታውን ይመርምሩ፤ የተሳካ ምላሽ እስኪሰጠው ድረስ ቁጥሩ አይታወቅም።
- ያልተገኘ ውሂብን ወደ ዜሮ አይቀይርም።
- የጥያቄ ሁኔታንና የኮታ ማስረጃን ይፈትሻል።
ደረጃ 4
ጠቃሚ ውጤት ይጨምሩ
አዲሱን መረጃ ይግለጹ፣ ረዳቱም እንዲያገናኘው ያድርጉ።
ከነባሩ ውጤት አጠገብ የምላሹን open_issues_count መስክ እንዲጨምርና open issues and pull requests ብሎ እንዲሰይም ረዳቱን ይጠይቁ። ይህ የGitHub ድምር ሁለቱንም ምድቦች ይዟል፤ bugs ብቻ ተብሎ መሰየም የለበትም። የራስዎን ስሪት ከሞከሩ በኋላ የተሰጠውን ማጣቀሻ ይጠቀሙ።
የሚታየውን እሴት ከእውነተኛው ምላሽ ጋር ያነጻጽሩ፣ ከዚያ የስኬት፣ የጎደለና ያልተገኘ ፍተሻዎችን ይድገሙ። እርስዎ ትርጉሙንና የታዩ ሁኔታዎችን ይገምግሙ፤ ረዳቱ የአሳሽ ኮዱን ይሥራ።
ተጨባጭ ምሳሌ
ምናባዊ የopen_issues_count እሴት 5፣ ሁለት ክፍት issues እና ሦስት ክፍት pull requests ሊያመለክት ይችላል። 5 bugs የሚል መለያ መስኩ ያላረጋገጠውን ነገር ይናገራል።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
ተግባርዎ፦ አንድ ጠቃሚ የማከማቻ መስክ ያክሉ
ግልጽ የውሂብና የስህተት ድንበሮችን እየጠበቁ የissue ብዛት ያክሉ።
open_issues_count ውሱን ቁጥር መሆኑን ካረጋገጡ በኋላ ያሳዩ። በሰነዱ እንደተገለጸው የGitHub ማከማቻ ብዛት pull requestsንም እንደሚያካትት ያስታውሱ፤ የሳንካ ሪፖርቶች ብቻ ትክክለኛ ብዛት ብለው አይሰይሙት።
አንድ የተሳካ ፍለጋ፣ የጎደለ ማከማቻና የoffline ሙከራ ይመዝግቡ። ጥያቄው በሂደት ላይ እያለና ከእያንዳንዱ ውጤት በኋላ ጎብኚው የሚያየውን ያካትቱ።
የተሠራ ምሳሌ
እንደ «Open issues and pull requests» ማለትም «ክፍት issues እና የለውጥ ውህደት ጥያቄዎች» ያለ መለያ፣ እሴቱ የሚለካውን «Bugs» ማለትም «ሳንካዎች» ከማለት በላይ በትክክል ያብራራል።
ሙሉው የማጣቀሻ መመሪያ በreference/assignment-walkthrough.txt ይገኛል። ደረጃዎቹን ከራስዎ ውጤት ጋር ያወዳድሩ፤ የፍተሻ መዝገቡን በራስዎ ፕሮጀክት ያዩትን ተጠቅመው ይሙሉ።
Extra implementation exercise
ውጤቱን በሰነዱ በተገለጸው የክፍት ንጥሎች ብዛት ያስፉ፣ ሦስቱንም ሁኔታዎች ያሳዩ።
የተሠራ መፍትሔ ያሳዩ
የተሳካ ሁኔታ ከተስተናገደ በኋላ በሚረጋገጡ መስኮች open_issues_count ያክሉ። ውሱን ቁጥር ይጠይቁ፣ ከዚያ 'Open issues and pull requests' ብለው ይሰይሙት፣ ያ የGitHub ማከማቻ መስክ ሁለቱንም ስለሚያካትት። ሙሉው የማጣቀሻ ስክሪፕት የtextContent አቀራረብንና ነባር የመጫን/ስህተት ሁኔታዎችን ይጠብቃል።
የሙከራ ውሂብ ምሳሌ፦ full_name='sample/site', stargazers_count=3, open_issues_count=2 ሲሆን 'sample/site — 3 stars — 2 open issues and pull requests' ያወጣል፣ ይህም 3 ኮከቦችንና 2 ክፍት issues እና pull requestsን ያሳያል። ሁለቱም ንጥሎች ሳንካዎች ናቸው አይልም።
የሚሳካ ይፋዊ ማከማቻ፣ 404 እና offline ሁኔታ እንደገና ይፈትሹ። ቀጣዩ ፍለጋ ሲጀምር የቀድሞውን ካርድ ያጽዱ፤ ስህተት የቆዩ ቁጥሮችን ማቆየት ወይም ያልተገኘ ውሂብን በዜሮ መተካት የለበትም።
- የተጨመረውን ቁጥር ያረጋግጣል፣ በትክክልም ይሰይመዋል።
- አዲስ ፍለጋ ካልተሳካ በኋላ የቆየ ስኬት አይቀርም።
ይህ ትምህርት ጠቅሞሃል?
ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።
መማርዎን ይቀጥሉ
- የመጀመሪያ የግል ድረ ገጽዎን እንዴት መሥራት ይችላሉ?
- ድረ ገጽዎን ከGitHub እንዴት ማተም ይችላሉ?
- የራስዎን ዶሜይን ከድረ ገጽዎ ጋር እንዴት ማገናኘት ይችላሉ?
- በራስዎ ዶሜይን ኢሜይል እንዴት ማዘጋጀት ይችላሉ?
- ድረ ገጽዎን በስልክ ላይ ለመጠቀም አመቺ እንዴት ማድረግ ይችላሉ?
- የድረ ገጽ ምስሎች በፍጥነት እንዲጫኑ እንዴት ማድረግ ይችላሉ?
- የድረ ገጽ አስተያየቶችን በመልእክት ሳጥንዎ እንዴት ማግኘት ይቻላል
- በድረ ገጽዎ ላይ የኢሜይል ደንበኝነት ምዝገባ እንዴት ማከል ይቻላል
- ከድረ ገጽዎ አውቶማቲክ ኢሜይሎችን እንዴት መላክ ይቻላል
- ከቅጽ የተላኩ መረጃዎችን በውሂብ ጎታ ውስጥ እንዴት ማስቀመጥ ይቻላል
- ሰዎች በድረ ገጽዎ ላይ ወደ መለያ እንዲገቡ እንዴት ማስቻል ይችላሉ?
- ገጽን የግል እንዴት ማድረግ ይችላሉ?
- ተጠቃሚዎች የመገለጫ መረጃቸውን እንዲያርትዑ እንዴት ማስቻል ይችላሉ?
- ተጠቃሚዎች ምስሎችን እንዲሰቅሉ እንዴት መፍቀድ ይቻላል
- የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?
- በድረ ገጽዎ ላይ የAI ውይይት ረዳት እንዴት ማከል ይችላሉ?
- የውይይት ረዳት ከራስዎ ይዘት እንዲመልስ እንዴት ማድረግ ይችላሉ?
- በድረ ገጽዎ ላይ ብሎግ እንዴት ማከል ይችላሉ?
- በድረ ገጽዎ ላይ ፍለጋ እንዴት ማከል ይችላሉ?
- በድረ ገጽዎ ላይ ሌላ ቋንቋ እንዴት ማከል ይችላሉ?
- Google ድረ ገጽዎን እንዲያገኝ እንዴት ማገዝ ይቻላል
- አገናኝ ሲያጋሩ የድረ ገጽዎን ቅድመ ዕይታ እንዴት ማስተካከል ይችላሉ?
- የድረ ገጽዎን ጉብኝቶችና ጠቃሚ ተግባራት እንዴት መለካት ይችላሉ?
- ጎብኚዎች ቀጠሮ እንዲያስይዙ እንዴት ማስቻል ይችላሉ?
- በድረ ገጽዎ ላይ ክፍያ እንዴት መቀበል ይቻላል
- የድረ ገጽ ለውጦችን ከማተምዎ በፊት እንዴት ቅድመ ዕይታ ማየት ይችላሉ?
- የተበላሸ የድረ ገጽ ማሰማራትን እንዴት ወደ ኋላ መመለስ ይችላሉ?
- የድረ ገጽዎን ውሂብ መጠባበቂያ ቅጂ እንዴት ማድረግና መመለስ ይችላሉ?
- በቀጥታ በሚሠራው ድረ ገጽዎ ስህተቶችን እንዴት ማግኘትና ማስተካከል ይችላሉ?