ለአበልጻጊዎች

ከኮድ ሊያስተዳድሩት የሚችሉት አስተናጋጅ (ሆስቲንግ)

Zinn Digital® ኤፒአይ-ቀዳሚ (API-first) ፕላትፎርም ነው። የእኛን ዳሽቦርድ የሚያንቀሳቅሰው ያው የሞተር ኤፒአይ የርስዎም ይሆናል — ስሪት የተደረገ፣ ስፔክ-ቀዳሚ እና በግንባታ ጊዜ 100% ሰነድ የተዘጋጀለት፣ ከተፈጠሩ ኤስዲኬዎች፣ ሲኤልአይ፣ ቴራፎም አቅራቢ፣ የተፈረሙ ዌብሁኮች እና ኤምሲፒ ሰርቨር ጋር። ለመሥራት የሚጠቀሙበት ማንኛውም ነገር — ተርሚናል፣ ፓይፕላይን፣ የሁኔታ ፋይል ወይም የAI ወኪል — ፕላትፎርሙ ምላሽ ይሰጥለታል።

ነፃ ጅምር ዋጋዎችን ይመልከቱ

650,000+በዓለም ዙሪያ ያስተናገዷቸው ዌብሳይቶች
1እያንዳንዱ መሳሪያ የሚመነጨው ከOpenAPI spec ነው።
4የደንበኛ SDKs — TypeScript፣ Python፣ PHP፣ Go
OAuth 2.1ወሰን ያለው፣ ሊሻር የሚችል የAI-ወኪል መዳረሻ

አንድ ኤፒአይ። እያንዳንዱ ገጽታ በእሱ ላይ ይሰራል።

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

በመጀመሪያ ዝርዝር መግለጫው፣ ከዚህ በኋላ የተመዘገበ አይደለም

የOpenAPI ዝርዝር መግለጫው የእውነት ምንጭ ነው፣ እና በዝርዝሩ ውስጥ ከሌለ በቀር ማንም ኢንዶፖይንት አይለቀቅም። ያ ብቸኛ ህግ ይፋዊው ኤፒአይ ከጊዜ በኋላ ሳይሆን በሚገነባበት ጊዜ ሙሉ በሙሉ ሰነድ እንዲዘጋጅለት የሚያደርገው ነው — ያልሰነደ ማዕዘን የለም፣ ምክንያቱም ያልሰነደ ኢንዶፖይንት ሊኖር አይችልም።

የተፈጠረ፣ በእጅ የማይጠበቅ

ተግባራዊ የማጣቀሻ ሰነዶች፣ አራቱ የደንበኛ SDKዎች፣ አብዛኛው የCLI እና የTerraform አቅራቢ ስካፎልዲንግ ሁሉም ከተመሳሳይ አንድ ዝርዝር የተፈጠሩ ናቸው። አንድ ምንጭ፣ ብዙ ቅርሶች፣ ሁልጊዜ የተጣጣሙ — ከትግበራው ዘንበል ያለን ሰነድ መቼም አይከታተሉም።

በመቋረጫ መመሪያዎች የተሻሻለ

የመጨረሻ ነጥቦች (Endpoints) በ /v1 ስር የሚገኙ ሲሆን፣ የወጡ የመሰረዝ (deprecation) መመሪያዎች እና የ ለውጥ መዝገብ (changelog) አላቸው። የሚከሽፍ ግንባታ (build) ካጋጠመዎት በኋላ ከማስተዋል ይልቅ፣ ማንኛውም ነገር ከመቀየሩ በፊት በጽሁፍ ይነገሮታል።

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

በእያንዳንዱ ለውጥ ላይ የትግበራ-እና-የስፔሲፊኬሽን ውል ሙከራዎች እና የOpenAPI ሊንቲንግ ይካሄዳሉ። በኮዱ እና በውሉ መካከል ያለው ልዩነት ቢልዱ እንዲወድቅ ያደርጋል — ስለዚህ ክላይንትዎን የሚፈጥሩበት ስፔሲፊኬሽን ሰርቨሩ በእርግጥ የሚያከብረው ስፔሲፊኬሽን ነው።

ማረጋገጫ፣ ወሰን ማበጀት እና በስኬል ጊዜ የሚያጋጥሙ ችግሮች

የመግቢያ ሁለት መንገዶች አሉ፣ ከኋላቸው ግን አንድ ዩኒፎርም መርህ አለ። የትኛውንም ቢጠቀሙ፣ ተመሳሳይ የፈቃድ ምርመራዎች እና ተመሳሳይ የዳታቤዝ-ደረጃ ማግለል ይሠራሉ።

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

ቁልፎች zdk_<mode>_<prefix>_<secret> የሚሉ ቅርጸቶች አሏቸው። የተስጢሩ የ SHA-256 ሃሽ ብቻ ነው የሚቀመጠው — አንዴ ከወጣ በኋላ ቁልፉን ዳግመኛ ልንታይዎ አንችልም፣ የውሂብ ማከማቻችንን የሚያገኝ ሌላ አካልም ሊያየው አይችልም። ቁልፎቹ የስልጣን ወሰኖች (scopes) አሏቸው፣ ሊሻሩ ይችላሉ፣ እና የሚሰጡት ለእያንዳንዱ ግለሰብ ሳይሆን ለእያንዳንዱ ድርጅት ነው።

የቀጥታ እና የሙከራ ሁነታዎች፣ ተለይተው የተያዙ

የሳንድቦክ ቁልፎች ከምርት (ፕሮዳክሽን) ቁልፎች የተለዩ ሲሆኑ በሳንድቦክ ሁነታ ላይ ይሰራሉ፡ ምንም እውነተኛ ክፍያ የለም፣ ምንም እውነተኛ ድልድል (ፕሮቪዥንግ) የለም። የውህደት ሙከራዎችዎ ገንዘብ ሳያወጡ ወይም አገልጋዮችን ሳይገነቡ ኤፒአይውን (API) መፈተሽ ይችላሉ።

OIDC ለሰዎች

የተጠቃሚ ክፍለ-ጊዜዎች በ Keycloak በተሰጡ JWTዎች ያረጋግጣሉ፣ ከግዛቱ ይፋዊ ቁልፍ (realm public key) አንጻር ይረጋገጣሉ፣ እና የ API ቁልፍ ከሚፈታው ተመሳሳይ Principal ነገር ጋር ይፈታሉ። የመጨረሻ ነጥቦች (Endpoints) እንደ sites.create ወይም apikeys.manage ባሉ ዝርዝር የፈቃድ ቁልፎች ላይ ይዘጋሉ፣ ይህም በእያንዳንዱ ድርጅት ይፈተሻል — ለአንድ ድርጅት የተሰጠ ፈቃድ የተለየና ያልተያያዘ ድርጅት ውስጥ ምንም ዓይነት መዳረሻ አይሰጥም፣ ነገር ግን ከእሱ ስር ላሉ ድርጅቶች ይሠራል::

ከሥር ያለው የረድፍ ደረጃ ደህንነት

እያንዳንዱ የTenant ጥያቄ ከፕሪንሲፓሉ በተቀመጠው የPostgres ድርጅት ወሰን (scope) አማካኝነት በ ትራንዛክሽን (transaction) ውስጥ ይከናወናል፤ ስለዚህ መገለል (isolation) የሚረጋገጠው በማንም ሊረሳ በሚችል የORM ማጣሪያ ሳይሆን በዳታቤዙ ነው። የqueryset ማጣሪያ እንደ ተጨማሪ የመከላከያ ሽፋን አሁንም በቦታው ይገኛል።

ለመሣሪያዎች የተሰራ፣ ለዲሞዎች ብቻ አይደለም

ኤፒአይ በ README ውስጥ ውብ ሆኖ እንዲታይ ማድረግ ቀላል ሲሆን በእውነተኛ ትራፊክ ስር እንዲሰራ ማድረግ ግን ከባድ ነው። ውህዶችን እኩለ ሌሊት ላይ ሊያበላሹ የሚችሉ እነዚህኑ ክፍሎች በመሆናቸው፣ እኛ አበክረን የሰራንባቸው እነዚህን ክፍሎች ነው።

ሊታወቅ የሚገባው አንድ ዝርዝር ጉዳይ፣ የጅምላ ስራ እንዴት እንደሚሰራ ስለሚወስን፡ በድግግሞሽ ጎራ (duplicate domain) ላይ የሚፈጠር 409 ምላሽ ለማንኛውም ተከራይ (tenant) "ይህ የሆስት ስም እዚህ ተስተናግዷል?" የሚለውን ይመልሳል፤ ይህ ደግሞ የቁጥር ማግኛ ኦራክል (enumeration oracle) እና በ Footprint-Free ላይ እውነተኛ የማንነት መገለጥ (deanonymisation) አደጋ ነው። የጣቢያ መፍጠር ፍጥነን መገደብ ቀላል መፍትሄ ሊሆን ይችል ነበር ነገር ግን የጅምላ ማዘጋጃ ምርቱን ሙሉ በሙሉ ያበላሸው ነበር። በምትኩ ውድቅ የተደረጉ የተባዙ-ጎራ ሙከራዎች ብቻ በዋናው (principal) ልክ ይመደባሉ። የተሳካ መፍጠሮች በእሱ ላይ ፈጽሞ አይከፈሉም — ስለዚህ ቀኑን ሙሉ በጅምላ ማዘጋጀት ይችላሉ፣ እና ፍተሻ (probing) ወዲያውኑ ማለት ይቻላል ይቆማል።

በእያንዳንዱ ውድቀት ጊዜ የተጣጣመ የስህተት መጠቅለያ: ኮድ፣ ለሰው የሚነበብ መልእክት፣ አማራጭ የመስክ-ደረጃ ዝርዝሮች እና ለድጋፍ ሰጪዎች ሊጠቅሱት የሚችሉት request_id። የማረጋገጫ ስህተቶች የተሳሳቱ መስኮች ስም ተጠቅሰው 422 ይመልሳሉ።
በPOST ላይ ያሉ Idempotency ኬዎች፣ የመልሶ ማጫወት መዝገቡ በውስጥ መስመር (inline) ሳይሆን በኮሚት (commit) ጊዜ የሚጻፍበት — ስለዚህ ድጋሚሞከሩ (retry) ፈጽሞ ያልተሰላሰለ ሰንጠረዥ ስም የሚሰጥ መሸጎጫ 201 ሊያጫወት አይችልም። የወደቀ ጥያቄ በሂደት ላይ ያለውን (in-flight) መቆለፊያ ወዲያውኑ ይለቀዋል፣ ስለዚህ 422 የተስተካከለውን ድጋሚ ሙከራዎን አይቆልፍም።
የጠቋሚ ገፅ አወጣጥ (Cursor pagination) እንደ UUIDv7 የቁልፍ ስብስብ — ጎን ለጎን በሚካሄዱ የመፃፍ ሂደቶች ጊዜ የፀና፣ እና በቅኝት መሃል ረድፎች በሚገቡበት ጊዜ የገፅ መንሸራተት የሌለበት።
በምላሾች ላይ RateLimit-Remaining አለ፣ ስለዚህ የተፈጠረ ደንበኛ ከመገመት ይልቅ በብልህነት ራሱን ማግለል ይችላል።
ከወሰን ውጭ ያሉ ሀብቶች 403 ሳይሆን 404 ይመልሳሉ — 403 ሀብቱ መኖሩን ያረጋግጣል። ከወሰንዎ ውጭ ባለው ድርጅት ማጣራት ለዚሁ ተመሳሳይ ምክንያት ባዶ ገጽ ይመልሳል።
የድር ጣቢያ መፍጠር ምዝገባ ነው እንጂ ማቅረብ አይደለም፡ POST /v1/sites የ 201 ሁኔታን ከ በመጠባበቅ ላይ (pending) ጋር ይመልሳል እና በግንባታው ላይ ፈጽሞ አያግድም። ክስተቱ ከረድፉ ጋር በአንድ ሰቅጥ (transaction) ውስጥ ወደ ትራንዛክሽናል ውጪ (transactional outbox) ይጻፋል፣ ስለዚህ አንድ ድር ጣቢያ የሚኖረው ማቅረቢያው እንዲጠየቅ ዋስትና ከተሰጠው ብቻ እና ብቻ ነው።

SDKዎች፣ የ CLI እና የ Terraform አቅራቢ

ለሶስት የተለያዩ የስራ አይነቶች የተዘጋጁ ሶስት ተመሳሳይ ዝርዝር መግለጫ ያላቸው ተጠቃሚዎች።

የደንበኛ SDKዎች

ለTypeScript፣ Python፣ PHP እና Go የተሰራ፣ አዲስ ማቆሚያ (endpoint) በእጅ የተጻፈ መጠቅለያ (wrapper) ሳይጠብቁ በቋንቋዎ እንዲደርስ ዝርዝር መግለጫውን (spec) ይከታተላል።

Zinnector®፣ CLI

የ WordPress ድህረ ገጽ ይገንቡ፣ Node ብቻ ተጭኖ በአካባቢያዊ (ሎካል) ስርዓት ያሂዱት፣ እንዲሁም ያሰማሩት። Zinnector® ከሚያሰማሩበት ቦታ ጋር በማስተካከል ፕሮጀክትዎን አስቀድሞ ይፈትሻል (የ PHP ስሪት፣ ዲስክ፣ የፋይል ብዛት)፤ ከመግፋትዎ በፊትም (ከማሰማራትዎ በኋላ ሳይሆን) ያስጠነቅቃል። በተጨማሪም ወደ ውስጥ ያስገባል፣ ድህረ ገጾችን ይዘረዝራል፣ ያሰማራል፣ ጎራዎችን እና DNS ያስተዳድራል፣ የፖስታ አገልግሎቶችን ያነበባል፣ መጠባበቂያዎችን (ባክአፕ) ይወስዳል፣ የተፈቀደ WP-CLI ያካሂዳል፣ መዝገብ (ሎግ) ይከታተላል፣ እንዲሁም የጅምላ ክንውኖችን ይፈጽማል። ነጻ፣ በ MIT ፈቃድ የተሰጠው፣ እና በተመሳሳይ ይፋዊ API ላይ የተገነባ ነው።

የቴራፎርም አቅራቢው

sites፣ ዶሜኖች፣ የDNS ሬኮርዶች፣ የሜይል ሳጥኖች እና እቅዶችን እንደ መሠረተ ልማት በኮድ (infrastructure as code) ያስተዳድሩ። terraform apply የድርጅት ማስተናገጃን (hosting) ያዘጋጃል፣ እና አካባቢዎችዎ ማንም ያልፃፈቸው የጠቅታዎች ቅደም ተከተል ከመሆን ይልቅ ሊባዙ የሚችሉ እና ሊገመገሙ የሚችሉ ይሆናሉ።

የግንኙነት ማጣቀሻ

ከተመሳሳዩ ዝርዝር መግለጫ (spec) የሚመጡ በመሆናቸው ሰቨሩ የሚተገብራቸውን ኤንድፖይንቶች (endpoints) በትክክል የሚገልጹ እና ከብራውዘር ሊነበቡና ሊጠሩ የሚችሉ የተፈጠሩ ሰነዶች።

የድር መዝገቦች (Webhooks) የመድረሻ ነጥብዎ (endpoint) ሲቋረጥም ይቀጥላሉ

ከመድረኩ ጀርባ ጠንካራ የክስተት ስፒን (event spine) አለ፡ እያንዳንዱ የሁኔታ ለውጥ ከዳታቤዝ ለውጡ ጋር በአቶሚክ መልኩ ክስተት በፖስትግሬስ (Postgres) ውስጥ ወደሚገኝ ግብይታዊ አውትቦክስ (transactional outbox) ይጽፋል፣ እና አንደኛ ሪሌይ (relay) ወደ NATS JetStream ያትመዋል። ክስተቶች ዓይነት እና ስሪት አላቸው — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending እና ሌሎችም።

የሚያስቡትን ይመዝገቡ

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

በ HMAC የተፈረመ

እያንዳንዱ ማድረሻ በHMAC የተፈረመ በመሆኑ እርምጃ ከመውሰድዎ በፊት ከእኛ መሆኑን ማረጋገጥ ይችላሉ።

በመጠባበቂያ ጊዜ ተደጋግሞ ሞክሯል፣ እንዲሁም ተመዝግቧል

ያልተሳኩ የማድረስ ሙከራዎች ከጊዜ ወደ ጊዜ እየጨመረ በሚሄድ የጊዜ ልዩነት (backoff) እንደገና ይሞከራሉ፣ እና እያንዳንዱ ሙከራ እንደ WebhookDelivery ይመዘገባል። ምን እንደላክን በመጠየቅ ለድጋፍ ሰጪ ቡድን ኢሜይል ከማድረግ ይልቅ፣ ከዳሽቦርዱ ላይ ሆነው ማድረስን መመልከት እና እንደገና ማስጀመር ይችላሉ።

ቢያንስ አንድ ጊዜ፣ ስለዚህ በመታወቂያው ላይ ድግግሞሾችን አስወግድ

የቧንቧ መስመሩ (pipeline) ትክክለኛ-አንድ-ጊዜ (exactly-once) እንደሆነ ከመምሰል ይልቅ ሆን ተብሎ ቢያንስ-አንድ-ጊዜ (at-least-once) እንዲሆን የተደረገ ነው። በማተም ሂደት ላይ የሚቋረጥ ሪሌይ (relay) የይገባኛል ጥያቄ የሊዝ ጊዜው ያበቃል፣ ክስተቶቹም እንደገና ይታተማሉ። በኤንቨሎፕ አይዲው (envelope id) ላይ ተደጋጋሚዎችን ያስወግዱ (dedupe)፣ የእርስዎ ተጠቃሚም በግንባታው ትክክለኛ ይሆናል።

ኮድ ወደ ዌብሳይቱ ማስገባት

ኤፒአይ የዴቨሎፐር ታሪክ ግማሽ ብቻ ነው። ሌላኛው ግማሽ ማድረስ ነው።

GitHub, GitLab ወይም Bitbucket በ OAuth ያገናኙ፣ የማሰማሪያ ቁልፎች (deploy keys) ከውቅር ፋይል (config file) ይልቅ በመታወቂያ ማከማቻው (credential store) ውስጥ ይቀመጣሉ።
ፑሽ (Push) የገንቢ እና የትግበራ (build-and-deploy) ሂደትን የሚያስጀምር ሲሆን፣ የቅርንጫፍ-ወደ-አካባቢ አmapping (main ወደ production፣ staging ወደ staging) እና ለእያንዳንዱ ስታክ የcomposer እና npm የገንቢ ደረጃዎች አሉት።
ማሰማራት ሲበላሽ ወደ ቀደመው ልቀቅ ይመለሱ።
የስቴጂንግ ክሎን እና ወደላይቭ መግፋት (push-to-live)፣ ለጎብኝዎች ከመድረሱ በፊት ለውጥ በእውነተኛ ቦታ እንዲሞከር።
በCageFS ማKlል ስር ለእያንዳንዱ ሳይት የታሰረ SSH፣ SFTP እና FTP፣ በዚህም እያንዳንዱ ተከራይ የራሱን ፋይሎች ብቻ ያያል።
የፓነል ተርሚናል እና በኤስኤስኤች (SSH) በኩል wp-cli
በኮድ ሰርቨር (code-server) አማካኝነት በብሮውዘር ውስጥ ያለው VS Code — ኤክስቴንሽኖች፣ የተቀናጀ ተርሚናል እና ጊት (git) ያለው ሙሉ ኤዲተር ሲሆን የጣቢያውን ፋይሎች በቀጥታ ያርትዖታል።
የጣቢያ-별 የPHP ስሪት፣ ሊስተካከሉ የሚችሉ የPHP ቅንብሮች፣ የጣቢያ-별 ቅጥያዎች፣ የአካባቢ ተለዋዋጮች እና ከWP-cron በተጨማሪ እውነተኛ cron።

እና የእርስዎን AI ወኪል መጠቀም የሚችለው ተመሳሳይ API ደግሞ አለ።

ፕላትፎርሙን እንደ አስተናጋጅ ኤም.ሲ.ፒ ሰርቨር እናቀርባለን፡ ይህም ተመሳሳይ የድርጊት ካታሎግ፣ አር.ቢ.ኤ.ሲ እና የኦዲት ዱካ የሚጠቀም በኤንጂን ኤ.ፒ.አይ ላይ ያለ ቀጭን የፕሮቶኮል አስማሚ ነው። Claude Code፣ Cursor፣ ChatGPT፣ Claude Desktop ወይም ማንኛውንም ኤም.ሲ.ፒ የሚደግፍ ክልየንት አንድ ጊዜ ያገናኙ፣ እና ወደ ኤ.ፒ.አይ የምንጨምረው እያንዳንዱ አቅም በራስ-ሰር ለእሱ ይገኛል።

ወኪሉ ሦስት ነገሮችን ያገኛል፡ መሣሪያዎች (ተመሳሳይ የኤፒአይ ማብቂያ ነጥቦች፣ ሊዛባ የሚችል ትይዩ አመክንዮ የለም)፣ ሀብቶች (የድር ጣቢያ ጤና፣ ውቅር፣ የቅርብ ጊዜ መዝገቦች፣ መለኪያዎች፣ የስራ ሰዓት እና የዕውቀት መሰረት ርዕሶች በንባብ ብቻ፣ ስለዚህ እርምጃ ከመውሰዱ በፊት በእውነተኛ ውሂብ ይመረምራል) እና ጥያቄዎች (እንደ "ይህንን ጣቢያ መርምር" ወይም "ፍልሰት አዘጋጅ" ያሉ የታተሙ የስራ ፍሰት አብነቶች)።

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

እኛ እያንዳንዱን መተግበሪያ አንድ በአንድ ከማቀናጀት ይልቅ ፕሮቶኮሉን እንደግፋለን፤ ይህ ማለት የእርስዎ የማስተናገጃ ውህደት ከእሱ ጋር ሳይለወጥ የመረጡት የAI መሣሪያዎች ሊቀየሩ ይችላሉ ማለት ነው።

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

የሕዝብ ኤፒአይ (public API) ዳሽቦርዱ ከሚጠቀመው ጋር ተመሳሳይ ነውን?

አዎ — የታተመ እና የተጠናከረ ተመሳሳይ የሞተር ኤፒአይ (engine API) ነው። ዳሽቦርዱ፣ የአስተዳዳሪ ኮንሶል፣ CLI፣ የ Terraform አቅራቢ፣ የ MCP ሰርቨር እና ዌብሁኮች (webhooks) ሁሉም የአንድ ነጠላ ገጽታ ተጠቃሚዎች ናቸው፤ ለዚህም ነው ኤፒአይው ከፓነሉ የማይዘገየው።

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

አዎ። የሳንድቦክስ ቁልፎች ከምርት ቁልፎች ተለይተው የሚሰጡ እና በፈተና ሁነታ የሚሰሩ ናቸው፡ እውነተኛ ክፍያ የለም እና እውነተኛ ድልድል የለም። የCIዎን ወደ ሳንድቦክስ ምስክርነቶች ያመልክቱ እና ሙሉውን የጥያቄ እና የምላሽ ዑደት ደህንነቱ በተጠበቀ ሁኔታ ይለማመዱ።

ድግግሞሽ ሁለት ነገር እንዳይፈጥር እንዴት ማቆም እችላለሁ?

በእርስዎ POST ላይ Idempotency-Key ይላኩ። የድጋሚ መልሶ ማጫወት መዝገብ የሚጻፈው ከውስጥ መስመር (inline) ይልቅ በግዴታ (commit) ላይ ነው፤ ስለዚህ ዳግምሞክር (retry) በእርግጥ ያልተፈጸመ ረድፍ መሸጎጫ ስኬትን በ ποτέ ሊያጫውተው አይችልም፣ እና የሚከሽፍ ጥያቄ መቆለፊያውን (lock) ወዲያውኑ ይለቀቃል በዚህም የተስተካከለው ዳግምሞክርዎ አይዘገይም። የድር ሁክ (Webhook) ማድረስ በንድፍ ቢያንስ-አንድ-ጊዜ (at-least-once) ነው — በመጨረሻዎ ላይ ባለው የፖስታ መሸፈኛ (envelope) መታወቂያ ላይ ተደጋጋሚዎችን ያስወግዱ።

አንድ ኤፒአይ ቁልፍ (API key) ለሁሉም የደንበኛ ድርጅቶቼ መዳረሻ መስጠት እችላለሁን?

ዛሬ አይደለም። ኤፒአይ ቁልፎች ለእያንዳንዱ ድርጅት የሚሰጡ ናቸው፣ ስለዚህ ብዙ የደንበኛ ድርጅቶችን የሚያካትት ውህደት ለእያንዳንዳቸው ቁልፍ ይይዛል። ፈቃዶችም ለተጠቃሚ መለያዎች በድርጅት ይረጋገጣሉ፡ በአንድ ድርጅት ውስጥ sites.create መያዝ ሙሉ በሙሉ በተለየ እና ዝምድና በሌለው ድርጅት ውስጥ መዳረሻ አይሰጥም፣ ምንም እንኳን በዚያ ስር በተሰለፉት ድርጅቶች ላይ የሚሠራ ቢሆንም። ይህ ሆነ ተብሎ የተደረገ ነው — የተበላሸ ቁልፍ በራሱ ድርጅት እና በእሱ ስር ባሉ ንኡስ ድርጅቶች ላይ ብቻ እንጂ መላውን መድረክ ላይ ተጽዕኖ እንዳያሳድር ይገድበዋል።

አብሮ የተሰራው የዴቨሎፐር ሚና ትክክለኛ ፈቃድ ምንድን ነው?

የገንቢው ሚና ድርጅትን ማንበብን፣ የኤፒአይ ቁልፍ አስተዳደርን፣ ጣቢያዎችን ማየትና መፍጠርን፣ እንደገና ማስጀመርን፣ መሸጎጫቸውን ማጽዳትን፣ እንዲሁም ቲኬቶችን ማየትና ምላሽ መስጠት ይሸፍናል። ሆን ብሎ የክፍያ መጠየቂያ ቁጥጥርን አያካትትም። ማሰማራት እና ወደ ቀጥታ ስርጭት መግፋት ፈቃዶች የዚህ አካል እንዳልሆኑ ልብ ይበሉ፤ የአንድ ቡድን አባል እነዚያ ከፈለጉ፣ ገንቢ በጣም ሰፊው ቴክኒካዊ ሚና ነው ብሎ ከማሰብ ይልቅ እነሱን የያዘ ሚና ይመድቡ።

የእኔ የድር ሆክ (webhook) መድረሻ ለአንድ ሰዓት ያህል ቢቋረጥ ምን ይሆናል?

አቅርቦቶች በሂደት በሚጨምር የጊዜ ልዩነት (backoff) እንደገና የሚሞከሩ ሲሆን፣ እያንዳንዱ ሙከራም እርስዎ መመርመር በሚችሉት በWebhookDelivery መልክ ይመዘገባል። ወደ ላይኛው መዋቅር (Upstream)፣ ክስተቶቹ ከለውጡ ጋር አብረው በአንድ የዳታቤዝ ትራንዛክሽን ውስጥ ወደ transactional outbox ስለሚፃፉ፣ ተቀባዩ (consumer) በማይኖርበት ጊዜ ምንም ነገር አይጠፋም — ስራ ያቆመ ተቀባይ ወደኋላ ይዘገያል እንጂ አምራቹን (producer) አያስተጓጉልም፣ እንዲሁም አንዴ እንደገና ዝግጁ ሲሆኑ አቅርቦቶችን ከዳሽቦርዱ ላይ እንደገና ማጫወት (replay) ይችላሉ።

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

የክፍያ ዝርዝር ሳያስፈልግ እስከ 5 ድር ጣቢያዎች የሚደርስ ከካርድ ነፃ የሆነ የ14 ቀናት የFootprint-Free Hosting የሙከራ ጊዜ ይጀምሩ። የሚከፈልባቸው የFootprint-Free እቅዶች ለPBN 5 በወር ከ$6 ይጀምራሉ። እያንዳንዱ እቅድ የ30 ቀናት ገንዘብ ተመላሽ ዋስትና፣ ነፃ ፍልሰቶች እና አቅራቢን ያለማሰር ፖሊሲ አለው።

ተዛማጅ

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

በመጀመሪያ ዝርዝር መግለጫ (Spec-first) ኤፒአይ፣ የተፈጠሩ ኤስዲኬዎች (SDKs)፣ የትዕዛዝ መስመር በይነገጽ (CLI)፣ የቴራፎርም አቅራቢ (Terraform provider)፣ የተፈረሙ ዌብሁኮች እና የMCP ሰርቨር—በዓለም ዙሪያ ከ650,000 በላይ ዌብሳይቶች ላዘጋጀነው አስተናጋጅ (hosting) አገልግሎት ላይ። ከክፍያ ካርድ ነፃ በሆነ የ14 ቀናት የሙከራ ጊዜ ይጀምሩ፣ ምንም የክፍያ ዝርዝሮች አያስፈልጉም።

ነፃ ጅምር