ለገንቢዎች

ከኮድ ማስተዳደር የሚችሉት ሆስቲንግ

Zinn Digital® የኤፒአይ መጀመሪያ መድረክ ነው። የእኛን ዳሽቦርድ የሚያንቀሳቅሰው ይኸው የኢንጅን ኤፒአይ እርስዎ የሚያገኙት ነው — በስሪት የተደገፈ፣ በመግለጫ ቅድሚያ የሚሰጠው እና በግንባታ ጊዜ 100% የተመዘገበ፣ ከእሱ በላይ ከተፈጠሩ ኤስዲኬዎች፣ ሲኤልአይ፣ የ Terraform አቅራቢ፣ የተፈረሙ ዌብሁኮች እና የ MCP አገልጋይ ጋር። ለመስራት ማንኛውንም ቢጠቀሙ — ተርሚናል፣ ቧንቧ መስመር፣ የሁኔታ ፋይል ወይም የ AI ወኪል — መድረኩ ለእሱ ምላሽ ይሰጣል።

የተፈረሙ ኩነቶችን ለተመዘገቡ በርካታ አድማጮች የሚያደርስ የAPI መጨረሻ ነጥብ።
  • 700,000+በዓለም ዙሪያ የተስተናገዱ ድረ-ገጾች
  • 1እያንዳንዱ መሣሪያ የሚመነጭበት የOpenAPI ዝርዝር መግለጫ
  • 4የደንበኛ SDKዎች — TypeScript፣ Python፣ PHP፣ Go
  • OAuth 2.1ወሰን ያለው ሊሰረዝ የሚችል የ AI ወኪል መዳረሻ

አንድ ኤፒአይ። እያንዳንዱ በይነገጽ በእሱ ይደገፋል።

አብዛኛዎቹ አስተናጋጆች ከእውነታው በኋላ ኤፒአይን (API) ወደ ቁጥጥር ፓነል ያያይዙታል፣ እና ይህ በግልጽ ይታያል — የፓነሉ ግማሽ ባህሪያት በጭራሽ አይገኙም። እኛ የገነባነው በተቃራኒው መንገድ ነው። ዳሽቦርዱ፣ የአስተዳዳሪ ኮንሶሉ፣ CLI፣ የ Terraform አቅራቢው፣ የ MCP አገልጋዩ እና የእርስዎ የራስ ውህደቶች ሁሉም ተመሳሳይ የሞተር ኤፒአይን ይጠቀማሉ። በፓነሉ ውስጥ ማድረግ ከቻሉ፣ በኮድ ውስጥም ማድረግ ይችላሉ።

መጀመሪያ-ስፔክ፣ በኋላ የተመዘገበ አይደለም

የOpenAPI ዝርዝር መግለጫ የእውነት ምንጭ ነው፣ እና ማናቸውም የመጨረሻ ነጥብ በዝርዝሩ ውስጥ እስካልተካተተ ድረስ አይለቀቅም። ያ ነጠላ ደንብ ነው ይፋዊው ኤፒአይ ከጊዜ በኋላ ሳይሆን በግንባታ ጊዜ ሙሉ በሙሉ እንዲመዘገብ የሚያደርገው — ያልተመዘገበ ጥግ የለም፣ ምክንያቱም ያልተመዘገበ የመጨረሻ ነጥብ ሊኖር አይችልም።

የተፈጠረ፣ በእጅ ያልተያዘ

በይነተገናኝ የማመሳከሪያ ሰነዶች፣ አራቱ የደንበኛ ኤስዲኬዎች፣ አብዛኛው የትዕዛዝ መስመር በይነገጽ (CLI) እና የTerraform አቅራቢ መዋቅር ሁሉም የሚመነጩት ከዚያ አንድ ዝርዝር መግለጫ ነው። አንድ ምንጭ፣ በርካታ ቅርሶች፣ ሁልጊዜ የተመሳሰሉ — ከተግባራዊነቱ ያፈነገጠን ሰነድ በፍጹም አያሳድዱም።

የስረዛ ፖሊሲ ያለው የዕትም ቁጥጥር

የመጨረሻ ነጥቦች (Endpoints) በ /v1 ሥር የታተመ የውድቀት ፖሊሲ እና የለውጥ መዝገብ ጋር ይገኛሉ። የሆነ ነገር ከመቀየሩ በፊት ያልተሳካ ግንባታን ከመመልከት ይልቅ በጽሑፍ ይነገረዎታል።

በCI ውስጥ ውል የተፈተሸ

የትግበራ እና የዝርዝር መግለጫ የውል ሙከራዎች እንዲሁም የOpenAPI ማረጋገጫ በእያንዳንዱ ለውጥ ላይ ይሰራሉ። በኮዱ እና በውሉ መካከል ያለው ልዩነት ግንባታውን እንዳይሳካ ያደርገዋል — ስለዚህ ደንበኛዎን የሚያመነጩበት ዝርዝር መግለጫ አገልጋዩ በትክክል የሚያከብረው ዝርዝር መግለጫ ነው።

ማረጋገጫ፣ ወሰን መወሰን እና በከፍተኛ መጠን ላይ እንቅፋት የሚሆኑ ነገሮች

ሁለት የመግቢያ መንገዶች፣ ከበስተጀርባቸው አንድ ወጥ መርህ። የትኛውንም ቢጠቀሙ፣ ተመሳሳይ የፈቃድ ፍተሻዎች እና ተመሳሳይ የውሂብ ጎታ-ደረጃ ማግለል ተግባራዊ ይሆናሉ።

የኤፒአይ ቁልፎች፣ በድርጅት

ቁልፎች zdk_<mode>_<prefix>_<secret> ይመስላሉ። የተከማቸው የሚስጥሩ SHA-256 ሐሽ ብቻ ነው — ከወጣ በኋላ ቁልፉን በድጋሚ ልናሳይዎት አንችልም፣ የእኛን የውሂብ ጎታ የሚያገኝ ማንኛውም ሰውም እንዲሁ ማድረግ አይችልም። ቁልፎች ወሰኖችን ይይዛሉ፣ ሊሰረዙ ይችላሉ፣ እና በግለሰብ ሳይሆን በድርጅት ደረጃ ይሰጣሉ።

የቀጥታ እና የሙከራ ሁነታዎች፣ ተነጣጥለው የተቀመጡ

የSandbox ቁልፎች ከProduction ቁልፎች የተለዩ ናቸው እና በSandbox ሁነታ ላይ ይሰራሉ፦ ምንም እውነተኛ የክፍያ አከፋፈል የለም፣ ምንም እውነተኛ አቅርቦት የለም። የእርስዎ የውህደት ሙከራዎች ገንዘብ ሳያወጡ ወይም አገልጋዮችን ሳይገነቡ APIውን ያለገደብ መሞከር ይችላሉ።

OIDC ለሰዎች

የተጠቃሚ ክፍለ-ጊዜዎች በKeycloak በተሰጡ JWTዎች ይረጋገጣሉ፣ ይህም ከግዛቱ ይፋዊ ቁልፍ አንጻር የሚረጋገጥ ሲሆን የኤፒአይ ቁልፍ ወደሚያገኘው ተመሳሳይ Principal ነገር ይፈታል። የመጨረሻ ነጥቦች እንደ sites.create ወይም apikeys.manage ባሉ ዝርዝር የፍቃድ ቁልፎች ላይ ይገደባሉ፣ ይህም በድርጅት ይፈተሻል — በአንድ ድርጅት ውስጥ ያለ ፈቃድ በተለየ እና ባልተገናኘ ድርጅት ውስጥ ምንም መዳረሻ አይሰጥም፣ ምንም እንኳን በእሱ ሥር ለተካተቱት ድርጅቶች ተፈጻሚ ቢሆንም።

ከስር የረድፍ-ደረጃ ደህንነት

እያንዳንዱ የተከራይ ጥያቄ ዋና አካል ከተወሰደው የ Postgres ድርጅት ወሰን ጋር ግብይት ውስጥ ይካሄዳል፣ ስለዚህ ማግለል የሚተገበረው በመረጃ ቋቱ እንጂ አንድ ሰው ሊረሳው በሚችለው የ ORM ማጣሪያ አይደለም። የ queryset ማጣሪያ አሁንም እንደ ጥልቅ የመከላከያ ዘዴ አለ።

ለማሳያዎች ብቻ ሳይሆን ለማሽኖች የተሰራ

ኤፒአይን በ README ውስጥ ጥሩ እንዲመስል ማድረግ ቀላል ነው፤ ነገር ግን በእውነተኛ ትራፊክ ውስጥ በሚገባ እንዲሰራ ማድረግ ከባድ ነው። እኩለ ሌሊት ላይ ውህደቶችን የሚያበላሹት ክፍሎች እነዚሁ በመሆናቸው እጅግ አድክመውናል።

የጅምላ ስራ እንዴት እንደሚሰራ ስለሚወስን ሊገለጽ የሚገባው አንድ ዝርዝር ነገር አለ፡ በተባዛ ዶሜይን ላይ የሚከሰት 409 ስህተት ለማንኛውም ተከራይ "ይህ ሆስትኔም እዚህ ነው የተስተናገደው?" የሚለውን ጥያቄ ይመልሳል፤ ይህም የዝርዝር ማወቂያ (enumeration oracle) እና በFootprint-Free ላይ እውነተኛ ማንነትን የማጋለጥ አደጋ ነው። የጣቢያ ፈጠራን መገደብ (throttling) ቀላል መፍትሄ ይሆን ነበር፣ ነገር ግን የጅምላ አቅርቦት ምርቱን ሙሉ በሙሉ ያበላሸው ነበር። በምትኩ፣ ለእያንዳንዱ ፕሪንሲፓል በጀት የተያዘው ውድቅ ለተደረጉ የተባዙ ዶሜይን ሙከራዎች ብቻ ነው። የተሳኩ ፈጠራዎች በጭራሽ ከእሱ አይቀነሱም — ስለዚህ ቀኑን ሙሉ በጅምላ ማቅረብ ይችላሉ፣ እና አላስፈላጊ ፍተሻዎች ወዲያውኑ ይቆማሉ።

  • በእያንዳንዱ ውድቀት ላይ ወጥ የሆነ የስህተት ኤንቨሎፕ፦ ኮድ፣ የሰው መልእክት፣ አማራጭ የመስክ ደረጃ ዝርዝሮች እና ለድጋፍ ሊጠቅሱት የሚችሉት request_id። የማረጋገጫ ስህተቶች ጥፋተኛ የሆኑትን መስኮች በመጥቀስ 422 ይመልሳሉ።
  • በ POST ላይ ያሉ የኢደምፖተንሲ ቁልፎች፣ የተደጋገመው መዝገብ በመስመር ላይ ከመሆን ይልቅ በኮሚት ላይ የሚጻፍ በመሆኑ — ዳግም ሙከራ ፈጽሞ ላልተረጋገጠ ረድፍ የተሸጎጠ 201 ምላሽን ፈጽሞ መልሶ ማጫወት አይችልም። ያልተሳካ ጥያቄ በመካሄድ ላይ ያለውን ቁልፍ ወዲያውኑ ይለቃል፣ ስለዚህ 422 የተስተካከለውን ዳግም ሙከራዎን አያግደውም።
  • የጠቋሚ ገጽ ቅየራ እንደ ቁልፍ ስብስብ በUUIDv7 ላይ — በተመሳሳይ ጊዜ በሚከናወኑ ጽሁፎች ወቅት የተረጋጋ፣ በቅኝት መሃል ረድፎች በሚጨመሩበት ጊዜ ምንም ዓይነት የገጽ መንሸራተት የሌለበት።
  • የተፈጠረ ደንበኛ ከመገመት ይልቅ በጥበብ ወደ ኋላ ማፈግፈግ እንዲችል በምላሾች ላይ RateLimit-Remaining።
  • ከወሰን ውጭ የሆኑ ግብዓቶች ከ403 ይልቅ 404 ይመልሳሉ — 403 ግብዓቱ መኖሩን ያረጋግጣል። በተመሳሳይ ምክንያት ከእርስዎ ወሰን ውጭ በሆነ ድርጅት ማጣራት ባዶ ገጽ ይመልሳል።
  • የጣቢያ መፍጠር ምዝገባ እንጂ አቅርቦት አይደለም፦ POST /v1/sites በሁኔታ pending 201 ይመልሳል እና በግንባታው ላይ በጭራሽ አይዘጋም። ክስተቱ ከረድፉ ጋር በተመሳሳይ ግብይት ውስጥ ወደ transactional outbox ይጻፋል፣ ስለዚህ አንድ ጣቢያ የሚኖረው አቅርቦቱ እንዲጠየቅ ዋስትና ከተሰጠ ብቻ ነው።

SDKs፣ CLI እና የTerraform አቅራቢ

ለሦስት የተለያዩ የሥራ መንገዶች የአንድ ዝርዝር ሦስት ተጠቃሚዎች።

የደንበኛ SDKዎች

ለTypeScript፣ Python፣ PHP እና Go የተፈጠረ ሲሆን፣ ዝርዝር መግለጫውን በመከታተል አዲስ የመጨረሻ ነጥብ በእጅ የተጻፈ መጠቅለያ ሳይጠብቁ በቋንቋዎ እንዲደርስ ያደርጋል።

Zinnector®፣ CLI

የ WordPress ጣቢያ ይገንቡ፣ Node ብቻ ተጭኖ በአካባቢው ያስኪዱት እና ያሰማሩት። Zinnector® ፕሮጀክትዎን ሊያሰማሩበት ካሰቡት ቦታ ጋር አስቀድሞ ይፈትሻል — የ PHP ስሪት፣ ዲስክ፣ የፋይል ብዛት — እና ከገፉ በኋላ ሳይሆን ከመግፋትዎ በፊት ያስጠነቅቃል። በተጨማሪም ይገባል፣ ጣቢያዎችን ይዘረዝራል፣ ያሰማራል፣ ጎራዎችን እና DNSን ያስተዳድራል፣ የፖስታ አገልግሎቶችን ያነባል፣ ምትኬዎችን ይወስዳል፣ የተፈቀደለትን WP-CLI ያስኪዳል፣ ምዝግቦችን ይከታተላል እና የጅምላ ስራዎችን ያከናውናል። ነፃ፣ በ MIT ፈቃድ የተሰጠው እና በዚህ ይኸው ይፋዊ API ላይ የተገነባ።

የ Terraform አቅራቢ

ድህረ ገጾችን፣ ጎራዎችን፣ የDNS መዝገቦችን፣ የመልዕክት ሳጥኖችን እና ዕቅዶችን እንደ ኮድ መሰረተ ልማት ያስተዳድሩ። terraform apply ማስተናገጃን ያቀርባል፣ እንዲሁም ማንም ሰው ያልመዘገባቸው ጠቅታዎች ቅደም ተከተል ከመሆን ይልቅ አካባቢዎችዎ እንደገና ሊባዙ እና ሊገመገሙ የሚችሉ ይሆናሉ።

ተግባራዊ ማመሳከሪያ

አገልጋዩ የሚተገብራቸውን የመጨረሻ ነጥቦች በትክክል የሚገልጹ፣ ከአሳሹ ማንበብ እና መጥራት የሚችሏቸው የተፈጠሩ ሰነዶች — ምክንያቱም ሁለቱም ከአንድ አይነት ዝርዝር መግለጫ የመጡ ናቸው።

የመጨረሻ ነጥብዎ የማይሰራ ቢሆንም የሚቀጥሉ ዌብሁኮች

ከመድረኩ ጀርባ አስተማማኝ የክስተት መዋቅር (event spine) አለ፡ እያንዳንዱ የሁኔታ ለውጥ ከመረጃ ቋቱ ለውጥ ጋር በአንድ ላይ በአቶሚክ ሁኔታ አንድን ክስተት በPostgres ውስጥ ወደሚገኝ የግብይት ሳጥን (transactional outbox) ይጽፋል፣ ከዚያም አንድ ሪሌይ ወደ NATS JetStream ያትመዋል። ክስተቶች አይነት እና ስሪት ያላቸው ናቸው — site.deployed፣ order.paid፣ invoice.overdue፣ backup.completed፣ abuse.flagged፣ trial.ending እና የመሳሰሉት።

ለሚፈልጉት ነገር ይመዝገቡ

የመጨረሻ ነጥብን እንደ WebhookSubscription ይመዝግቡ እና የሚቀበላቸውን የክስተት ዓይነቶች ይምረጡ። አንድ ዥረት ለማሳወቂያዎች፣ ለመተንተኛዎች፣ ለአውቶሜሽኖች እና ለእርስዎ ውህደት በተመሳሳይ መልኩ ይመገባል — እኛ የምንጠቀምባቸውን ተመሳሳይ ክስተቶች እየተጠቀሙ ነው።

በHMAC የተፈረመ

እርምጃ ከመውሰድዎ በፊት ከእኛ መላኩን ማረጋገጥ እንዲችሉ እያንዳንዱ ማድረስ በHMAC የተፈረመ ነው።

በተራዘመ የጊዜ ልዩነት እንደገና ተሞክሯል፣ እና ተመዝግቧል

ያልተሳኩ አቅርቦቶች በየጊዜው በሚጨምር የጊዜ ክፍተት እንደገና ይሞከራሉ፣ እና እያንዳንዱ ሙከራ እንደ WebhookDelivery ይመዘገባል። ምን እንደላክን ድጋፍ ሰጪ ቡድንን በኢሜይል ከመጠየቅ ይልቅ አቅርቦቶችን ከመቆጣጠሪያ ሰሌዳው ላይ መመርመር እና እንደገና ማስኬድ ይችላሉ።

ቢያንስ አንድ ጊዜ፣ ስለዚህ በ id ላይ ድግግሞሽን ያስወግዱ

የውሂብ መስመሩ ሆን ተብሎ በትክክል አንድ ጊዜ እንደሆነ ከማስመሰል ይልቅ ቢያንስ አንድ ጊዜ እንዲሆን ተደርጓል። በማተም ሂደት ላይ የሚቋረጥ ቅብብሎሽ የይገባኛል ውል ጊዜው ያልፍበታል እንዲሁም ክስተቶቹ እንደገና ይታተማሉ። በኤንቨሎፕ መታወቂያው ላይ ተደጋጋሚነትን ያስወግዱ፣ ያኔ የእርስዎ ተጠቃሚ በንድፉ መሰረት ትክክለኛ ይሆናል።

ኮድን ወደ ጣቢያው መጫን

ኤፒአይ የአንድ ገንቢ ታሪክ ግማሽ ብቻ ነው። ሌላኛው ግማሽ ማድረስ ነው።

  • GitHub፣ GitLab ወይም Bitbucketን በOAuth በኩል ያገናኙ፣ የማሰማሪያ ቁልፎች በውቅር ፋይል ውስጥ ሳይሆን በማረጋገጫ ማከማቻ ውስጥ ይቀመጣሉ።
  • Push የማዘጋጀት እና የማሰማራት (build-and-deploy) ፓይፕላይንን ያስነሳል፣ ከቅርንጫፍ-ወደ-አካባቢ ካርታ ስራ (ዋና ወደ production፣ staging ወደ staging) እና ለእያንዳንዱ-ስቴክ ለcomposer እና npm የማዘጋጀት ደረጃዎች አሉት።
  • ስምሪት ሳይሳካ ሲቀር ወደ ቀዳሚው የተለቀቀ ስሪት ይመለሱ።
  • ጎብኝዎች ጋር ከመድረሱ በፊት ለውጡ በእውነተኛ ቦታ ላይ መረጋገጡን ለማረጋገጥ የማዘጋጃ ክሎን እና በቀጥታ የማስተላለፍ ተግባር።
  • ለእያንዳንዱ ጣቢያ የ SFTP መዳረሻ በ CageFS ማግለያ ሥር ነው፤ ስለዚህ እያንዳንዱ ተከራይ የራሱን ፋይሎች ብቻ ያያል፣ በተጨማሪም በተጋራው መድረክ ላይ የታጠረ የ SSH ሼል ያገኛል።
  • wp-cli ከፓነሉ ተርሚናል እና በ SSH በኩል።
  • VS Code በአሳሽ ውስጥ በ code-server በኩል — ሙሉ አርታዒ ከ git ጋር፣ የድረ-ገጹን ፋይሎች በቀጥታ የሚያስተካክል።
  • ለእያንዳንዱ ድረ-ገጽ የ-PHP ስሪት፣ ሊስተካከሉ የሚችሉ የ-PHP ቅንብሮች፣ ለእያንዳንዱ ድረ-ገጽ ቅጥያዎች፣ የአካባቢ ተለዋዋጮች እና ከ-WP-cron ጎን ለእውነተኛ cron።

በአንድ ጣቢያ ላይ ለመስራት አራት መንገዶች

ኤፒአይ አንዱ በር ነው። ሌሎቹ አራቱ እነዚህ ናቸው፣ እና እያንዳንዳቸው እንደ ገንቢ ደረጃ ለብቻቸው ከመሸጥ ይልቅ ከዕቅዱ ጋር ተካተዋል።

የድር አርታዒው

VS Code በአሳሽ ውስጥ፣ ከጣቢያው ገጽ በመቆጣጠሪያ ሰሌዳው (dashboard) ውስጥ ተከፍቶ፣ አብሮ በተሰራው git እና መላው አርታዒ የእርስዎ SFTP መዳረሻ ካለው ተመሳሳይ CageFS እስር (jail) ውስጥ ሆኖ የጣቢያውን ትክክለኛ ፋይሎች ያርማል። የቀጥታ (LIVE) ጣቢያውን ያርማል — በመካከሉ ምንም የሙከራ (staging) ቅጂ የለም፣ ስለዚህ ያስቀመጡት ፋይል ልክ እንደተጻፈ ወዲያውኑ ለህዝብ ይፋ ይሆናል፣ ምንም እንኳን የማይንቀሳቀስ (static) ፋይል ከCDN መሸጎጫ እስከ አራት ሰዓታት ድረስ አገልግሎት መስጠቱን ሊቀጥል ቢችልም።

Zinnector®፣ ሲኤልአይ

ነፃ፣ በMIT ፈቃድ የተሰጠ እና በዚሁ ይፋዊ ኤፒአይ (API) ላይ የተገነባ። የWordPress ድረ-ገጽ ያዋቅሩ፣ በራስዎ መሣሪያ ላይ ያስኪዱት፣ ሊጭኑበት ባሰቡት ማስቀመጫ መሰረት ቅድመ-ምርመራ ያድርጉለት — የPHP ስሪት፣ ዲስክ፣ የፋይል ብዛት — ከዚያም ያሰማሩ። Node 24 ወይም አዲስ ስሪት ያስፈልገዋል።

የ MCP አገልጋይ

አንድ የመሳሪያዎች ካታሎግ፤ በዚህም አስቀድመው የሚጠቀሙበት የAI ደንበኛ የመቆጣጠሪያ ፓነሉ በሚጠቀመው ተመሳሳይ ኤፒአይ (API) እና ተመሳሳይ ፈቃዶች አማካኝነት በድር ጣቢያዎችዎ ላይ መስራት ይችላል። የእርስዎ ደንበኛ የሚገናኝበት ተመሳሳይ አገልጋይ ከድር አርታዒው ጋር የተገናኘው ነው። እርስዎ በተለየ መንገድ ካልገለጹ በስተቀር ለንባብ ብቻ ክፍት ነው።

ለእያንዳንዱ ድረ-ገጽ የገንቢ መዳረሻ

የደንበኛ ሥራ የእርስዎን የይለፍ ቃል አያስፈልገውም። በኢሜይል አድራሻ ማንንም ይጋብዙ እና እነሱ በትክክል አንድ ጣቢያ ያገኛሉ፡ እንደ ራሳቸው ይገባሉ፣ የተመልካች፣ የአርታዒ ወይም የአስተዳዳሪ ሚና ይዘው፣ እና ማናቸውም ሌላ ጣቢያ ማንኛውም ተቆጣጣሪ ከመስራቱ በፊት 404 ምላሽ ይሰጣል — የ Postgres ረድፍ-ደረጃ ደህንነት ፖሊሲ እና የጥያቄ-ደረጃ አጥር እንጂ አንድ ማረጋገጫ ብቻ አይደለም። የመለያው ባለቤት በአንድ ጠቅታ ይፈቅደዋል እና ይሰርዘዋል፣ በሚቀጥለው ጥያቄያቸው ላይም ወዲያውኑ ተግባራዊ ይሆናል።

እና የእርስዎ AI ወኪል ሊጠቀምበት የሚችል ተመሳሳይ ኤፒአይ (API)

መድረኩን እንደ አስተናጋጅ የMCP አገልጋይ እናቀርባለን፦ ተመሳሳይ የተግባር ካታሎግን፣ RBACን እና የኦዲት ዱካን እንደገና የሚጠቀም በቀላል ፕሮቶኮል የተዘጋጀ የኢንጂን ኤፒአይ (API) አስማሚ ነው። Claude Code፣ Cursor፣ ChatGPT፣ Claude Desktop ወይም ማንኛውንም MCP የሚደግፍ ደንበኛ አንዴ ያገናኙ፣ እና ወደ ኤፒአይ (API) የምንጨምረው እያንዳንዱ አቅም በራስ-ሰር ለእሱ ተደራሽ ይሆናል።

ወኪሉ ሦስት ነገሮችን ያገኛል፦ መሣሪያዎች (ተመሳሳይ የኤፒአይ መድረሻ ነጥቦች፣ ሊዛባ የሚችል ትይዩ አመክንዮ የለም)፣ ምንጮች (እርምጃ ከመውሰዱ በፊት በእውነተኛ መረጃ እንዲመረምር የተነበቡ ብቻ የጣቢያ ጤና፣ ውቅር፣ የቅርብ ጊዜ ምዝግብ ማስታወሻዎች፣ መለኪያዎች፣ የስራ ጊዜ እና የእውቀት መሰረት መጣጥፎች) እና መጠየቂያዎች (እንደ «ይህን ጣቢያ ይመርምሩ» ወይም «ስደትን ያዘጋጁ» ያሉ የታተሙ የስራ ፍሰት አብነቶች)።

ደህንነት ልክ እንደ ማረጋገጫ (authentication) ተመሳሳይ ታሪክ ነው፡ OAuth 2.1፣ ከድርጅትዎ ጋር የተሳሰሩ ቶከኖች እና የረድፍ-ደረጃ ደህንነት የተተገበረባቸው የ-RBAC ፈቃዶች፣ ለእያንዳንዱ መሣሪያ ወሰን የተበጀላቸውና ሊሰረዙ የሚችሉ፣ ከአመራረት የተለየ ሳንድቦክስ። አጥፊ እርምጃዎች — መሰረዝ፣ ማገድ፣ ክፍያ፣ ትልቅ ወጪ — ግልጽ ማረጋገጫ ወይም የሰው-ማጽደቂያ ፖሊሲ ያስፈልጋቸዋል። የፍጥነት ገደቦች እና የወጪ ጣሪያዎች በ-AI የሚቀሰቀሱ የሚከፈልባቸውን እርምጃዎች ይገድባሉ፣ እና እያንዳንዱ የ-MCP ጥሪ በማንነት፣ በመሣሪያ፣ በክርክሮች እና በውጤት ኦዲት-ይመዘገባል።

እያንዳንዱን መተግበሪያ አንድ በአንድ ከማቀናጀት ይልቅ ፕሮቶኮሉን እንደግፋለን፣ ይህም ማለት የአስተናጋጅ ውህደትዎ አብሮ ሳይቀየር የ AI መሳሪያዎች ምርጫዎ ሊቀየር ይችላል ማለት ነው።

ተደጋግመው የሚጠየቁ ጥያቄዎች

የህዝብ ኤፒአይ (API) ዳሽቦርዱ ከሚጠቀመው ጋር አንድ አይነት ነው?

አዎ — የታተመ እና የተጠናከረ ያው የሞተር API ነው። የመቆጣጠሪያ ዳሽቦርዱ፣ የአስተዳዳሪ ኮንሶሉ፣ CLI፣ የ Terraform አቅራቢ፣ የ MCP አገልጋይ እና ዌብሁኮች ሁሉም የአንድ ገጽታ ተጠቃሚዎች ናቸው፣ ለዚህም ነው APIው ከፓነሉ ወደ ኋላ የማይቀረው።

ገንዘብ ሳላወጣ ወይም እውነተኛ ሰርቨሮችን ሳልገነባ ውህደትን መሞከር እችላለሁ?

አዎ። የ Sandbox ቁልፎች ከምርት ቁልፎች ተለይተው የሚሰጡ ሲሆን በሙከራ ሁነታ ይሰራሉ፦ ምንም እውነተኛ የክፍያ አከፋፈል እና እውነተኛ አቅርቦት የለም። የእርስዎን CI ወደ sandbox ምስክርነቶች ያመልክቱ እና አጠቃላይ የጥያቄ እና ምላሽ ዑደት ደህንነቱ በተጠበቀ ሁኔታ ይሞክሩ።

እንደገና መሞከር የአንድን ነገር ቅጂ እንዳይፈጥር እንዴት መከላከል እችላለሁ?

በእርስዎ POST ላይ የIdempotency-Key ይላኩ። የመልሶ ማጫወት መዝገብ በመስመር ላይ ከመሆን ይልቅ በ commit ላይ ስለሚጻፍ፣ ድጋሚ ሙከራ በትክክል ላልተፈጸመ ረድፍ የተቀመጠ ስኬትን በፍፁም መልሶ ሊያጫውት አይችልም፣ እንዲሁም ያልተሳካ ጥያቄ ወዲያውኑ ቁልፉን ስለሚለቅ የተስተካከለው ድጋሚ ሙከራዎ አይዘገይም። የWebhook አቅርቦት በንድፍ ቢያንስ-አንድ-ጊዜ (at-least-once) ነው — በእርስዎ በኩል በ envelope id ላይ ተደጋጋሚነትን ያስወግዱ።

ለአንድ የAPI ቁልፍ ለሁሉም የደንበኛ ድርጅቶቼ የመድረሻ ፈቃድ መስጠት እችላለሁ?

ዛሬ አይደለም። የAPI ቁልፎች የሚሰጡት በየድርጅቱ ስለሆነ፣ በርካታ የደንበኛ ድርጅቶችን የሚያጠቃልል ውህደት ለእያንዳንዳቸው ቁልፍ ይይዛል። ፈቃዶችም ለተጠቃሚ ዋና አካላት በየድርጅቱ ይፈተሻሉ፦ በአንድ ድርጅት ውስጥ sites.create መያዝ በተለየ እና ባልተገናኘ ድርጅት ውስጥ ምንም መዳረሻ አይሰጥም፣ ምንም እንኳን ከዚያ በታች ላሉት ድርጅቶች ተፈጻሚ ቢሆንም። ይህ ሆን ተብሎ የተደረገ ነው — የተጣሰ ቁልፍን በራሱ ድርጅት እና ከስሩ ባሉ ንዑስ ድርጅቶች ብቻ ይገድባል እንጂ በመላው መድረክ ላይ አይደለም።

አብሮ የተሰራው የገንቢ ሚና በትክክል ምን ይፈቅዳል?

የdev ሚና የድርጅት ንባብን፣ የAPI ቁልፍ አስተዳደርን፣ ድረ-ገጾችን ማየትንና መፍጠርን፣ እንደገና ማስጀመርን፣ መሸጎጫቸውን ማጽዳትን፣ እንዲሁም ትኬቶችን ማየትንና ምላሽ መስጠትን ያካትታል። ሆን ተብሎ የክፍያ ቁጥጥርን አያካትትም። የማሰማራት እና push-to-live ፈቃዶች የዚህ አካል እንዳልሆኑ ልብ ይበሉ — የአንድ ቡድን አባል እነዚያ የሚያስፈልጉት ከሆነ Developer በጣም ሰፊው ቴክኒካዊ ሚና ነው ብለው ከማሰብ ይልቅ እነሱን የያዘ ሚና ይመድቡላቸው።

የእኔ የመጨረሻ ነጥብ ለአንድ ሰዓት ቢቋረጥ የድር ሁኮቼ ምን ይሆናሉ?

ማድረሻዎች በጊዜ ክፍተት (backoff) እንደገና ይሞከራሉ፣ እንዲሁም እያንዳንዱ ሙከራ እርስዎ ሊመረምሩት በሚችሉት የWebhookDelivery መልክ ይመዘገባል። ወደ ላይኛው ተፋሰስ (upstream)፣ ኩነቶች ከለውጡ ጋር በአንድ የውሂብ ጎታ ግብይት ውስጥ ወደ transactional outbox ይጻፋሉ፤ ስለዚህ ተቀባዩ በማይገኝበት ጊዜ ምንም ነገር አይጠፋም — የማይሰራ ተቀባይ ወደኋላ ይቀራል እንጂ አምራቹን መቼም አያቋርጥም፣ እና አንዴ ተመልሰው ሲመጡ ማድረሻዎቹን ከመቆጣጠሪያ ሰሌዳው (dashboard) ላይ እንደገና ማስኬድ ይችላሉ።

በእሱ ላይ መገንባት ለመጀመር ምን ያህል ያስወጣል?

በ Footprint-Free ሆስቲንግ የ 14-ቀን ካርድ-አልባ የሙከራ ጊዜ ይጀምሩ — ምንም የክፍያ ዝርዝሮች አያስፈልጉም፣ እስከ 5 ድረ-ገጾች። የሚከፈልባቸው የ Footprint-Free ደረጃዎች ለ PBN 5 በወር ከ $6 ጀምሮ ይገኛሉ። እያንዳንዱ እቅድ የ 30-ቀን የገንዘብ ተመላሽ ዋስትና፣ ነፃ ዝውውር እና የአቅራቢ ጥገኝነት አለመኖርን ያካትታል።

ዝርዝር መግለጫውን ያንብቡ፣ ከዚያም በእሱ መሠረት ይገንቡ

ስፔክ-ቀዳሚ ኤፒአይ፣ የተፈጠሩ ኤስዲኬዎች፣ ሲኤልአይ፣ ቴራፎርም ፕሮቫይደር፣ የተፈረሙ ዌብሁኮች እና ኤምሲፒ ሰርቨር — በዓለም ዙሪያ ለ700,000+ ድረ-ገጾች በገነባነው ሆስቲንግ ላይ። ያለምንም የክፍያ ዝርዝር፣ በካርድ-ነጻ የ14-ቀናት የሙከራ ጊዜ ይጀምሩ።

በነጻ ይጀምሩ

AI ኤጀንትዎ ሊሰራባቸው የሚችሏቸው WordPress ተሰኪዎች

ከእነዚህ ተሰኪዎች እያንዳንዳቸው የእርስዎን የWordPress ድረ-ገጽ የMCP ሰርቨር ያደርጉታል፣ ስለዚህ Claude፣ Cursor፣ VS Code እና ሌሎች አርቴፊሻል ኢንተለጀንስ ረዳቶች በእርስዎ ገብተው እና እርስዎ እንዲሰሩ በተፈቀደልዎ ገደብ ውስጥ በእሱ ላይ እውነተኛ ስራ መስራት ይችላሉ።

ለሁለቱም ዴቨሎፖዎች የMCP እና API ዶክመንቴሽን አጠቃላይ መረጃ →