አጭር ትምህርት · አማርኛ

የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?

የአገልግሎት ሰጪውን ቁልፍ ከጎብኚው አሳሽ ለማራቅና የተፈቀዱና የተከለከሉ ጥያቄዎችን ለማረጋገጥ በአገልጋይ የሚደገፈውን የተሰጠ ምሳሌ ይጠቀሙ።

ተግባቦታዊውን ትምህርት ይጀምሩየትምህርቱን ማስታወሻዎች ያንብቡ

ይህ ለማን ነው?

ድረ ገጽን ከAI ወይም ልዩ ፈቃድ ከሚፈልግ ሌላ አገልግሎት ጋር ለሚያገናኙ ሰዎች። የኮድ ጻፊ ረዳት ዝግጁውን ፕሮጀክት ሊያገናኝ ይችላል፤ እርስዎ ማወቅ ያለብዎት ሚስጥሩ የት ሊጠቀም እንደሚችል እንጂ የአገልጋይ ኮድ መጻፍ አይደለም።

ከመጀመርዎ በፊት

የራስዎ Google AI Studio API መዳረሻና የተለየ የNetlify-function ልምምድ ፕሮጀክት ያስፈልጋሉ። ሙሉ ጥቅሉንና የግል አካባቢ ማዋቀሩን ከኮድ ረዳት ጋር ይጠቀሙ። ጥያቄ ከመላክ በፊት የሞዴልና የመለያ አጠቃቀም ገደቦችን፣ ሊኖሩ የሚችሉ ክፍያዎችንም ጨምሮ፣ ያረጋግጡ። ልምምዱ ባለቤቱ የሚይዘውን የተለየ ኮድ ይጠቀማል፤ ዝግጁ ይፋዊ የAI አገልግሎት አይደለም።

ግምታዊ ጊዜ: 20–32 ደቂቃ

ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። የአቅራቢ/መለያ ዝግጅት የበለጠ ጊዜ ሊወስድ ይችላል። አጠቃቀም በመለያዎ ወቅታዊ ውሎችና ኮታ ይገዛል።

ምን ይማራሉ?

  • የአገልግሎት ሰጪውን ሚስጥር በግል የአገልጋይ አካባቢ ብቻ ያስቀምጡ።
  • ቁልፉን ለጎብኚዎች ሳያጋልጡ የተሰጠውን ተግባር ያስኪዱ።
  • የተሳኩና የተከለከሉ የመዳረሻ ሙከራዎችን ይፈትሹ።

የልምምድ ፋይሎች

ደረጃ 1

የትኛው እሴት የግል መቆየት እንዳለበት ይወቁ

አሳሹ የአገልግሎት ሰጪውን ሚስጥር ሳይቀበል ተግባርዎን መጠቀም አለበት።

የተሰጠውን ፕሮጀክት ከረዳትዎ ጋር ይክፈቱ። የአገልግሎት ሰጪው ቁልፍ የግል የመለያ እሴት መሆኑን፣ የተለየው የልምምድ ኮድ ደግሞ ለዚህ ትንሽ ልምምድ የባለቤቱ የመዳረሻ መቆጣጠሪያ መሆኑን ይለዩ።

የግንባታ ሂደቱ የፋይሉን እሴት ወደ ይፋዊ ስክሪፕቶች ከቀዳው፣ ፋይሉ .env መባሉ ብቻ በቂ አይደለም። ረዳቱ ለጎብኚው የሚላኩትን እውነተኛ ፋይሎች እንዲመረምር ይጠይቁ።

ተጨባጭ ምሳሌ

የተደበቀ የቅጽ መስክም የአሳሹ ክፍል ነው፤ የአገልግሎት ሰጪውን ቁልፍ መደበቅ አይችልም።

ይህን ዝግጁ የAPI ቁልፍ ልምምድ ክፈትና የrun-locally.txt ማዋቀሪያውን ምራኝ። የአገልግሎት ሰጪውን ቁልፍና የሞዴል ምርጫ በአገልጋዩ ላይ አቆይ፣ የተለየ የልምምድ መዳረሻ ኮድም ተጠቀም። ሚስጥሮችን በይፋዊ ፋይሎች አታስቀምጥ፣ በሚጋሩ መልዕክቶች ውስጥ እንድለጥፋቸውም አትጠይቀኝ። አሳሹ የሚቀበለውን ለመመርመርና የተፈቀዱና የተከለከሉ ጥያቄዎችን ለመፈተሽ እርዳኝ። የጥያቄ መቀበያውን እኔ እንድተገብር ከመጠየቅ ይልቅ በእይታ የሚረጋገጠውን ማስረጃ አብራራልኝ።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

ከፍተኛ ፈቃድ ያላቸውን የAPI ቁልፎች ከአሳሽ ኮድ ያርቁ

የጎብኚው አሳሽ የሚልኩለትን እያንዳንዱን ፋይል ሊመረምር ይችላል።

የአቅራቢ ሚስጥር ወጪን ወይም ከፍተኛ ፈቃድ ያላቸውን ተግባራት ሊፈቅድ ይችላል። በይፋዊ JavaScript፣ በተደበቀ መስክ ወይም frontend ሲገነባ በሚተካ የአካባቢ ተለዋዋጭ ማስቀመጥ አሁንም ወደ አሳሹ ይልከዋል።

የተሠራው ምሳሌ በአገልጋይ functionዎ በኩል Geminiን አንድ ቋሚ ትምህርታዊ ጥያቄ ይጠይቃል። አሳሹ መልሱን ይቀበላል፤ የአቅራቢው ቁልፍ በአገልጋይ አካባቢ ይቀጥላል። ሁሉም ቁልፎች ሚስጥር አይደሉም፦ የSupabase publishable ቁልፎች በመዳረሻ ፖሊሲዎች ጋር ለአሳሽ አጠቃቀም የታሰቡ ናቸው፣ secret ቁልፎቹ ግን አይደሉም።

የተሠራ ምሳሌ

insecure-example.txt ይክፈቱ። የፈጠራው እሴት የሚታየው በተላከው ኮድ ስላለ ነው። ያንኑ መስመር በminify ማሳጠር ለማንበብ ያስቸግረዋል፣ ግን ማን እንደሚቀበለው አይቀይርም።

Extra implementation exercise

ቁልፍ በ.env ይቀመጣል፣ በbuild ጊዜም በይፋዊ JavaScript bundle ይገባል። ከጎብኚዎች የተደበቀ ነው?

የተሠራ መፍትሔ ያሳዩ

አይደለም። በይፋዊ bundle ከገባ በኋላ የመጀመሪያው የፋይል ቦታ አያስፈልግም። ከፍተኛ ፈቃድ ያለውን ተግባር ወደ አገልጋይ function ያዛውሩ፣ እሴቱንም እዚያ ያቆዩ።

  • ቁልፉን እስከተላከው bundle ይከታተላል።
  • የአገልጋይ አካባቢን ከfrontend መተካት ይለያል።

ደረጃ 2

የተሰጠውን የተጠበቀ ተግባር ያስጀምሩ

ያለውን የአገልጋይ መንገድ ረዳቱ እንዲያዋቅር ያድርጉ።

run-locally.txt እና server-env.example.txt ከረዳቱ ጋር ይከተሉ። የታሰበውን መለያ/ሞዴልና የአጠቃቀም ውሎች ያረጋግጡ፣ የአቅራቢውን ቁልፍ በግል በአገልጋዩ ያስቀምጡ፣ የተለየ የልምምድ ኮድ ይፍጠሩ። ሙሉ ፕሮጀክቱን አስኪደው የአካባቢውን መተግበሪያ URL ይክፈቱ። እነዚህ የማዋቀር ፍተሻዎች የግድ ናቸው፤ የfunction ኮድ መጻፍ ግን አማራጭ ነው።

አሳሹ የአገልጋይዎን ተግባር ሲያነጋግር፣ አገልጋዩ ደግሞ አገልግሎት ሰጪውን በግል ማነጋገር አለበት። በማዋቀር፣ በመዳረሻ ወይም በአጠቃቀም ገደብ ምክንያት ችግር ካጋጠመ፣ ምላሽ ከመፍጠር ይልቅ ያንን ደረጃ ያሳውቁ።

ተጨባጭ ምሳሌ

የቅጹ የልምምድ ኮድ የGoogle አገልግሎት ሰጪ ቁልፍ አይደለም።

Gemini፦ generateContent API · Gemini፦ የAPI ቁልፎች · Gemini፦ ወቅታዊ model IDዎችና ችሎታዎች · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

የአቅራቢውን ጥሪ ከራስዎ endpoint በስተጀርባ ያስቀምጡ

አገልጋዩን ያዋቅሩ፣ ከዚያ ባህሪው የሚፈልገውን ትንሽ ጥያቄ ብቻ ይላኩ።

netlify/functions/mini-explain.mjs ያንብቡ፣ የተለየውን ፕሮጀክት ያሰማሩ፣ GEMINI_API_KEY፣ GEMINI_MODEL እና LAB_TOKENንም በአገልጋዩ ያዘጋጁ። ከመመሪያ አሮጌ የmodel ስም ከመቅዳት ይልቅ፣ በመለያዎ የሚደገፍ የጽሑፍ model ይምረጡ።

የተለየውን የልምምድ ኮድ በቅጹ ያስገቡ። አሳሹ /.netlify/functions/mini-explainን ይጠራል፤ ያ function በx-goog-api-key የGoogleን ቋሚ HTTPS endpoint ይጠራል። ኮዱ ለባለቤቱ ብቻ የሆነ የልምምድ ገደብ ነው፣ የGemini የመግቢያ መረጃ ወይም ሙሉ ይፋዊ የኮታ ስርዓት አይደለም።

GEMINI_MODEL በራስዎ API መለያ የሚገኝ ትክክለኛ model ID ነው፣ ከማያ ፎቶ የተቀዳ የማሳያ ስም አይደለም። generate በተመሳሳይ የአገልጋይ function ፋይል ያለ helper ነው። የአቅራቢው ቁልፍም ሆነ ያ helper በpublic/ መሆን የለባቸውም። አቅራቢው ኮታ ከሌለው ወይም ካልተገኘ፣ ትክክለኛ ጥያቄም አሁንም ላይሳካ ይችላል።

ለሙሉው በኮምፒውተርዎ የማስኬድ ቅደም ተከተል run-locally.txt ይክፈቱ፦ በፕሮጀክቱ ዋና አቃፊ ውስጥ ባለው የግል .env ፋይል የአገልጋይ ቅንብሮችን ያዘጋጁ፣ ከpublic/ ውጭ እና በGit የማይከታተል መሆኑን ያረጋግጡ፣ የልምምድ ፕሮጀክቱን ብቻ ያገናኙ፣ የNetlify function proxyንም ያስነሱ። server-env.example.txt የተለዋዋጭ ስሞችን ያለ እውነተኛ ሚስጥሮች ይዘረዝራል። HTMLን ብቻ መክፈት አገልጋዩን ማስኬድ አይችልም።

ከታች ያለውን ወቅታዊ የmodel መመሪያ ይጠቀሙ፣ ወይም በራስዎ አካባቢ ከግል የልምምድ ሥር list-text-models.mjs ያስኪዱ። ቁልፉን ሳያትም መለያው የሚያያቸውን የgenerateContent እጩዎች ይዘረዝራል። የሚደገፍ የጽሑፍ model ይምረጡ፣ ውሎቹን/ኮታውን ይፈትሹ፣ ከዚያ ትክክለኛ API IDውን በአገልጋይ GEMINI_MODEL ቅንብር ይቅዱ።

ከመጀመሪያው የfunction ጥያቄ በፊት የmodel ዝርዝር helperን ያስኪዱ፣ እዚህ የሚጠቀሙትን የgenerateContent ጥያቄ መስኮች፣ systemInstructionን ጨምሮ፣ የሚደግፍ ወቅታዊ የጽሑፍ model ይምረጡ። ዝርዝሩ እጩዎችን ይለያል፣ ኮታን ወይም ሁሉንም የmodel ችሎታ አይደለም። ሙሉው netlify/functions/mini-explain.mjs ፋይል በአገልጋይ ይሠራል፤ public/app.js ለእያንዳንዱ ጎብኚ ይላካል። የማስተናገጃ ዕቅዱን የfunction ጊዜ ገደብም ይፈትሹ፦ የአቅራቢው የ20 ሰከንድ ገደብ ከዚያ ያነሰ የአስተናጋጅ ገደብ ማራዘም አይችልም።

የተሠራ ምሳሌ

የአቅራቢው ጥያቄ በአገልጋይ ላይ ቋሚ ነው፣ ስለዚህ ጠሪ ይህን መንገድ ወደ ማንኛውም ትልቅ ጥያቄ ማስተላለፊያ መቀየር አይችልም። functionው ውጤቱንም ይገድባል፣ ለአቅራቢ ጥያቄውም ቢበዛ 20 ሰከንዶች ይጠብቃል።

Gemini፦ generateContent API · Gemini፦ የAPI ቁልፎች · Gemini፦ ወቅታዊ model IDዎችና ችሎታዎች · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

Extra implementation exercise

የትኞቹን ሁለት ጥያቄዎች ማየት አለብዎት፣ የትኛውስ በአሳሽ Network መሣሪያዎች መታየት የለበትም?

የተሠራ መፍትሔ ያሳዩ

አሳሹ ወደ functionዎ ያደረገውን ጥሪና የተመለሰውን መልስ ያሳያል። አገልጋዩ የአቅራቢውን ጥያቄ ያደርጋል፤ የመግቢያ መረጃ የያዘው የGoogle ጥሪ እንደ አሳሽ ጥያቄ መታየት የለበትም።

  • ወደ የራስ ድረ ገጽ function የሚሄደውን የአሳሽ ጥያቄ ያያል።
  • በማንነት የተረጋገጠውን የGoogle ጥያቄ በአገልጋይ ያቆያል።

ደረጃ 3

ግላዊነትንና ውድቀትን በአንድነት ይፈትሹ

ጠቃሚ ምላሽ የተጋለጠ ቁልፍን ተቀባይነት ያለው አያደርገውም።

ረዳቱ የአገልግሎት ሰጪው ሚስጥር በተላኩ ይፋዊ ፋይሎችና በአሳሽ ጥያቄዎች ውስጥ መኖሩን እንዲፈትሽ እርዳታ ይጠይቁ፤ ሚስጥሩን በሚጋሩ የሥራ መዝገቦች ላይ አያሳዩ። በጊዜያዊው ፕሮጀክት የተሳሳተ የልምምድ ኮድና የጎደለ ውቅር ያለበትን ሁኔታ ይሞክሩ።

እውነተኛው ቁልፍ በአሳሹ ፋይሎችና ጥያቄዎች ውስጥ መታየት የለበትም። የተከለከሉ ወይም አገልግሎቱ የማይገኝላቸው ጥያቄዎች ሊጠቀሙበት የሚችሉ የዳግም ሙከራ መንገድ እያላቸው ያልተሳኩ ሆነው መቆየት አለባቸው።

ተጨባጭ ምሳሌ

አሳማኝ መልስ እያለ ቁልፉ በapp.js ውስጥ ከተጋለጠ፣ ሥራው አሁንም ያልተጠናቀቀ ነው።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

ድንበሩንም ሆነ መልሱን ያረጋግጡ

የተሳካ መልስ ብቻ ቁልፉ የግል ሆኖ መቆየቱን አያረጋግጥም።

በማያ ፎቶዎች ወይም በጋራ logs ሳይለጥፉት፣ እውነተኛውን የአቅራቢ ቁልፍ በተሰማራው ይፋዊ HTML እና scripts ይፈልጉ። የአሳሽ ጥያቄዎችን ይመርምሩ፦ የልምምድ ኮዱ ለባለቤቱ ሊታይ ይችላል፣ የGemini ቁልፍ ግን መታየት የለበትም።

በሊሰረዝ የሚችል ፕሮጀክት የተሳሳተ የልምምድ ኮድና የጎደለ የአቅራቢ ቅንብር ይፈትሹ። አለመሳካት አለመሳካት ሆኖ መቀጠል አለበት። የአቅራቢ ሁኔታ 429 የኮታ/የጥያቄ ፍጥነት ገደቦችን ሊያመለክት ይችላል፤ 401 ወይም 403 የመዳረሻ/ቅንብር ችግሮችን ሊያመለክቱ ይችላሉ። እነዚህን ሁሉ ለመደበቅ፣ በእውነት ከአቅራቢው ያልተመለሰ የሐሰት የAI መልስ አይፍጠሩ።

የተሠራ ምሳሌ

ትክክለኛ የአቅራቢ ቅንብሮች ያሉት ትክክለኛ የልምምድ ኮድ እውነተኛ መልስ መመለስ አለበት። ተመሳሳዩ endpoint ከተሳሳተ ኮድ ጋር ከማንኛውም የአቅራቢ ጥያቄ በፊት መከልከል አለበት።

Extra implementation exercise

መልሱ ይሠራል፣ የአቅራቢው ቁልፍ ግን በpublic/app.jsም ይታያል። ተግባሩ ተጠናቋል?

የተሠራ መፍትሔ ያሳዩ

አልተጠናቀቀም። ቁልፉን ከይፋዊ ፋይሎች ያስወግዱ፣ ስለተጋለጠ ይተኩት፣ የአገልጋዩን ቅንብር ያዘምኑ፣ አዲሱን deployment እና የማከማቻ ታሪክም የቀረ መጋለጥ እንዳለ ይፈትሹ።

  • የተሳካ ውጤትን እንደ በቂ ማስረጃ አይቀበልም።
  • ፍሳሹን ያስወግዳል፣ የተጋለጠውንም ቁልፍ ይተካል።

ደረጃ 4

አንድ ወሰን ያለው ለውጥ በጥንቃቄ ያድርጉ

ተግባሩን ሲቀይሩ ተመሳሳይ የሚስጥር ወሰን ይጠብቁ።

ረዳቱ የተሰጠውን ቋሚ ተግባር DNSን በአጭሩ እንዲያብራራ እንዲያስተካክል ይጠይቁ። የሞዴልና የቁልፍ ቅንብሮች በአገልጋዩ ላይ እንዲቆዩ፣ የልምምዱም መዳረሻ ለባለቤቱ ብቻ እንዲወሰን ይጠብቁ።

የታሰበውን ምላሽና ልክ ያልሆነ የመዳረሻ ኮድ እንደገና ይፈትሹ። ለሕዝብ ከመክፈትዎ በፊት እውነተኛ የማንነት ማረጋገጫ፣ ዘላቂ የአጠቃቀም ቁጥጥሮችና የአገልግሎት ሰጪውን በጀት መከታተያ ላይ ይወስኑ።

ተጨባጭ ምሳሌ

የመልሱን ርዕስ መቀየር የግል የመለያ እሴቶችን ወደ ገጹ ማዛወር የለበትም።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

ተግባርዎ፦ ሁለተኛ ቋሚ ተግባር ያዛውሩ

ድንበሩን በአጋጣሚ ከማስፋት ይልቅ በዓላማ ይድገሙት።

የአገልጋዩን ቋሚ ጥያቄ DNSን በሁለት ዓረፍተ ነገሮች እንዲያብራራ ይቀይሩ። የመግቢያ መረጃዎችን፣ የmodel ምርጫንና የውጤት ገደብን በአገልጋይ ያቆዩ፤ አሳሹ የአቅራቢ ቁልፉን እንዳያውቅ ያድርጉ።

በትክክለኛና በማይሠራ የልምምድ ኮድ ውጤቱን ይመዝግቡ። ይፋዊ መዳረሻ ከመስጠትዎ በፊት ምን እንደሚጨምሩ ያብራሩ፦ ማንነታቸው የተረጋገጠ ተጠቃሚዎች ወይም ሌላ ትርጉም ያለው የመዳረሻ ድንበር፣ ዘላቂ የአጠቃቀም ገደቦችና ከአቅራቢ በጀቱ አንጻር ክትትል።

የተሠራ ምሳሌ

ቋሚ ጥያቄን መቀየር የአቅራቢው ባህሪ የት እንደሚቆጣጠር መረዳትዎን ያረጋግጣል። ከአሳሹ ማንኛውንም models፣ endpoints ወይም የውጤት ገደቦች መቀበል ያንን ቁጥጥር ያጠፋል።

ሙሉው የማጣቀሻ መመሪያ በreference/assignment-walkthrough.txt ይገኛል። ደረጃዎቹን ከራስዎ ውጤት ጋር ያወዳድሩ፤ የፍተሻ መዝገቡን በራስዎ ፕሮጀክት ያዩትን ተጠቅመው ይሙሉ።

Extra implementation exercise

የDNS ቅጂውንና አጭር የድንበር ፍተሻ መዝገብ ያዘጋጁ።

የተሠራ መፍትሔ ያሳዩ

በአገልጋይ ብቻ በሚሠራው mini-explain function፣ ስለ ድረ ገጽ አገልጋይ ያለውን ቋሚ ጥያቄ 'Explain DNS in two sentences for a beginner.' በሚለው ይተኩ፣ ይህም DNSን ለጀማሪ በሁለት ዓረፍተ ነገሮች አብራራ ማለት ነው። ቁልፉን/modelን በአገልጋይ የአካባቢ ተለዋዋጮች ያቆዩ፤ ሙሉው የማጣቀሻ function ትክክለኛውን እርማት ያሳያል።

ለአሳሽ የሚላኩ scriptsንና Network ጥያቄዎችን ይመርምሩ። አሳሹ ጥያቄውን ወደ የራስዎ function ይልካል፤ GEMINI_API_KEYን ራሱ ወደ Google መላክ የለበትም። ባለቤቱ የሚያስገባው የልምምድ ኮድ ከአቅራቢው ቁልፍ የተለየ ነው።

የተሳሳተ የልምምድ ኮድ ይሞክሩ፦ ከማንኛውም የአቅራቢ ጥሪ በፊት መከልከልን ይጠብቁ። የአቅራቢ ኮታ/አውታረ መረብ አለመሳካት እውነተኛ አለመሳካት ሆኖ መቀጠል አለበት፣ ቀድሞ የተዘጋጀ የስኬት መልስ አይሁን። እውነተኛ ሚስጥር ከተጋለጠ፣ ያስወግዱትና ይተኩት፤ በኋላ ፋይሉን ችላ ማለት መጋለጡን አይሽርም።

  • ምንም የአቅራቢ ሚስጥር ወደ አሳሹ አይላክም።
  • የተሳሳተ መዳረሻ ይከለከላል፣ እውነተኛ የአቅራቢ አለመሳካትም ይታያል።

ይህ ትምህርት ጠቅሞሃል?

ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።

መማርዎን ይቀጥሉ

ሌሎች ትምህርቶችን ይመልከቱ