សម្រាប់អ្នកអភិវឌ្ឍន៍
Zinn Digital® គឺជាផ្លែតហ្វមដែលផ្អែកលើ API ជាចម្បង។ API ម៉ាស៊ីនដូចគ្នាដែលដំណើរការផ្ទាំងគ្រប់គ្រងរបស់យើង គឺជា API ដែលអ្នកទទួលបាន — ដែលមានកំណែ ច្បាស់លាស់តាមលក្ខណៈបច្ចេកទេស និងមានឯកសារពន្យល់ 100% នៅពេលបង្កើត ព្រមទាំងមាន SDKs ដែលបានបង្កើតឡើង, CLI, អ្នកផ្តល់សេវា Terraform, webhooks ដែលមានហត្ថលេខា និងម៉ាស៊ីនបម្រើ MCP នៅលើវា។ មិនថាអ្នកប្រើអ្វីសម្រាប់ធ្វើការ — ធើមីនល, ផាយឡាញ, ឯកសារស្ថានភាព ឬភ្នាក់ងារ AI នោះទេ ផ្លែតហ្វមនេះឆ្លើយតបទាំងអស់។
hosts ភាគ ច្រើន បន្ថែម API ទៅ លើ control panel ពេល ក្រោយ ដែល ធ្វើ ឱ្យ ឃើញ ច្បាស់ ថា ពាក់ កណ្តាល នៃ លក្ខណៈ ពិសេស របស់ panel មិន ធ្លាប់ ដំណើរ ការ ឡើយ ។ យើង បាន បង្កើត ឡើង វិញ ផ្ទុយ ពី នេះ ។ dashboard, admin console, CLI, Terraform provider, MCP server និង integrations ផ្ទាល់ ខ្លួន របស់ អ្នក សុទ្ធ តែ ប្រើ ប្រាស់ engine API ដូច គ្នា ។ ប្រសិន បើ អ្នក អាច ធ្វើ វា ក្នុង panel បាន អ្នក ក៏ អាច ធ្វើ វា តាម កូដ បាន ដែរ ។
លក្ខណៈជាក់លាក់របស់ OpenAPI គឺជាប្រភពនៃការពិត ហើយគ្មានចំណុចបញ្ចប់ណាមួយត្រូវបានដាក់ឱ្យប្រើប្រាស់ឡើយ លើកលែងតែវាមាននៅក្នុងលក្ខណៈជាក់លាក់នោះ។ ច្បាប់តែមួយនេះហើយ ដែលធ្វើឱ្យ API សាធារណៈមានឯកសារយោងពេញលេញនៅពេលសាងសង់ ជាជាងនៅពេលក្រោយ ដែលមិនមានជ្រុងណាមួយដែលគ្មានឯកសារយោងនោះទេ ព្រោះថាចំណុចបញ្ចប់ដែលគ្មានឯកសារយោង គឺមិនអាចមាននោះឡើយ។
ឯកសារយោងអន្តរកម្ម កញ្ចប់ SDK របស់អតិថិជនទាំងបួន CLI ភាគច្រើន និងបណ្តុំ Terraform provider សុទ្ធតែត្រូវបានបង្កើតឡើងពី spec តែមួយនោះ។ ប្រភពតែមួយ វត្ថុបុរាណជាច្រើន តែងតែស៊ីសង្វាក់គ្នា — អ្នកមិនចាំបាច់តាមដានឯកសារដែលខុសប្លែកពីការអនុវត្តឡើយ។
Endpoints ស្ថិតនៅក្រោម /v1 ដោយមានគោលការណ៍លុបចោលការប្រើប្រាស់ដែលបានផ្សព្វផ្សាយ និងមានកំណត់ហេតុផ្លាស់ប្តូរ។ អ្នកនឹងទទួលបានការជម្រាបជូនជាលាយលក្ខណ៍អក្សរមុនពេលមានការផ្លាស់ប្តូរអ្វីមួយ ជាជាងការរកឃើញវាចេញពី build ដែលបរាជ័យ។
ការធ្វើតេស្តកិច្ចសន្យារវាងការអនុវត្ត និងលក្ខណៈបច្ចេកទេស ក៏ដូចជាការពិនិត្យកូដ OpenAPI ត្រូវបានដំណើរការលើរាល់ការកែប្រែទាំងអស់។ ការខុសគ្នារវាងកូដ និងកិច្ចសន្យា ធ្វើឱ្យដំណើរការកសាងបរាជ័យ — ដូច្នេះ លក្ខណៈបច្ចេកទេសដែលអ្នកបង្កើតខ្លាយអិន (client) របស់អ្នកចេញពីវា គឺជាលក្ខណៈបច្ចេកទេសដែលសឺវើ (server) គោរពតាមជាក់ស្តែង។
វិធីសាស្ត្រចូលពីរផ្សេងគ្នា ប៉ុន្តែមានគោលការណ៍គ្រឹះតែមួយនៅពីក្រោយវា។ មិនថាអ្នកប្រើមួយណាទេ ការពិនិត្យសិទ្ធិដូចគ្នា និងការដាក់ឱ្យដាច់ដោយឡែកកម្រិតមូលដ្ឋានទិន្នន័យដូចគ្នានឹងត្រូវអនុវត្ត។
គ្រាប់ចុចមានទម្រង់ zdk_<mode>_<prefix>_<secret>។ មានតែតម្លៃហាស SHA-256 នៃលេខសម្ងាត់ប៉ុណ្ណោះដែលត្រូវបានរក្សាទុក ដែលមានន័យថាយើងមិនអាចបង្ហាញគ្រាប់ចុចដល់អ្នកម្ដងទៀតបានទេបន្ទាប់ពីចេញវា ហើយក៏គ្មាននរណាម្នាក់អាចចូលមើលមូលដ្ឋានទិន្នន័យរបស់យើងបានដែរ។ គ្រាប់ចុចមានវិសាលភាពកំណត់ អាចត្រូវបានដកហូត និងត្រូវបានចេញជូនក្នុងកម្រិតអង្គភាព មិនមែនក្នុងកម្រិតបុគ្គលនោះឡើយ។
សោរប្រអប់ខ្សាច់ (Sandbox) គឺដាច់ដោយឡែកពីសោរផលិតកម្ម ហើយដំណើរការក្នុងរបៀបប្រអប់ខ្សាច់៖ គ្មានការចេញវិក្កយបត្រពិតប្រាកដ ឬការរៀបចំសេវាកម្មពិតប្រាកដទេ។ ការធ្វើតេស្តរួមបញ្ចូលគ្នារបស់អ្នកអាចប្រើប្រាស់ API នេះបានយ៉ាងច្រើនដោយមិនចាំបាច់ចំណាយប្រាក់ ឬបង្កើតម៉ាស៊ីនមេទេ។
វគ្គសវនកម្មអ្នកប្រើប្រាស់ធ្វើការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវជាមួយនឹង JWTs ដែលចេញដោយ Keycloak ដែលត្រូវបានផ្ទៀងផ្ទាត់ធៀបនឹងសោសាធារណៈរបស់រ៉េល (realm public key) ហើយដោះស្រាយទៅកាន់វត្ថុ Principal ដូចគ្នាដែលគ្រាប់ចុច API ធ្វើ។ ចំណុចបញ្ចប់ធ្វើការទប់ស្កាត់នៅលើគ្រាប់ចុចសិទ្ធិលម្អិតដូចជា sites.create ឬ apikeys.manage ដែលត្រូវបានពិនិត្យតាមអង្គភាពនីមួយៗ ដោយសិទ្ធិនៅក្នុងអង្គភាពមួយមិនផ្ដល់នូវការចូលប្រើប្រាស់នៅក្នុងអង្គភាពដាច់ដោយឡែក និងមិនទាក់ទងគ្នានោះទេ ទោះបីជាវាអនុវត្តចំពោះអង្គភាពដែលស្ថិតនៅក្រោមវាជាបន្តបន្ទាប់ក៏ដោយ។
សំណើរបស់អ្នកជួលនីមួយៗដំណើរការក្នុងប្រតិបត្តិការមួយ ដែលមានវិសាលភាពអង្គការ Postgres កំណត់ពីប្រ៊ីនស៊ីប៉ាល់ ដូច្នេះការដាក់ឱ្យនៅដាច់ដោយឡែកត្រូវបានអនុវត្តដោយមូលដ្ឋានទិន្នន័យ មិនមែនដោយតម្រង ORM ដែលនរណាម្នាក់អាចភ្លេចនោះទេ។ តម្រងសំណុំសំណួរនៅតែមាននៅទីនោះជាការការពារស៊ីជម្រៅ។
វាមានភាពងាយស្រួលក្នុងការធ្វើឱ្យ API មើលទៅល្អនៅក្នុងឯកសារ README ប៉ុន្តែវាពិបាកក្នុងការធ្វើឱ្យវាដំណើរការបានល្អក្រោមចរាចរណ៍ពិតប្រាកដ។ ទាំងនេះគឺជាផ្នែកដែលយើងខិតខំប្រឹងប្រែងយ៉ាងខ្លាំង ព្រោះវាជាផ្នែកដែលតែងតែបង្កបញ្ហាដល់ការរួមបញ្ចូលប្រព័ន្ធនៅពេលម៉ោងបីទៀបភ្លឺ។
ចំណុចលម្អិតមួយដែលគួររំលេចឡើង ព្រោះវាបង្កើតជារូបរាងបៀបដែលការងារតាមប្លុកដំណើរការ៖ លទ្ធផល 409 លើដែនស្ទួន ឆ្លើយតបនូវសំណួរ "តើឈ្មោះម៉ាស៊ីនបម្រើនេះត្រូវបានបង្ហោះនៅទីនេះមែនទេ?" សម្រាប់អ្នកប្រើប្រាស់ណាមួយ ដែលវាគឺជា enumeration oracle និងជាហានិភ័យនៃការលាតត្រដាងអត្តសញ្ញាណពិតប្រាកដប្រឆាំងនឹង Footprint-Free។ ការកម្រិតល្បឿនបង្កើតគេហទំព័រ អាចជានិន្នាការដោះស្រាយបែបខ្ជិលច្រអូស ហើយវានឹងធ្វើឱ្យផលិតផលបង្កើតជាប្លុកដំណើរការលែងកើតទាំងស្រុង។ ផ្ទុយទៅវិញ មានតែការព្យាយាមបង្កើតដែនស្ទួនដែលត្រូវបានបដិសេធប៉ុណ្ណោះដែលត្រូវបានរាប់ចូលក្នុងកូតា ផ្អែកតាមគណនីមេនីមួយៗ។ ការបង្កើតដោយជោគជ័យមិនដែលត្រូវបានគិតបញ្ចូលប្រឆាំងនឹងវាឡើយ — ដូច្នេះអ្នកអាចបង្កើតជាប្លុកបានពេញមួយថ្ងៃ ហើយការព្យាយាមលួចស្ទង់មើលនឹងត្រូវបញ្ចប់ស្ទើរតែភ្លាមៗ។
អតិថិជនបីនាក់ដែលមានលក្ខណៈជាក់លាក់ដូចគ្នា សម្រាប់វិធីសាស្ត្រការងារបីផ្សេងគ្នា។
បានបង្កើតសម្រាប់ TypeScript, Python, PHP និង Go ដោយតាមដានការបញ្ជាក់ ដូច្នេះចំណុចប្រទាក់ថ្មីនឹងមកដល់ជាភាសារបស់អ្នកដោយមិនបាច់រង់ចាំកូដរុំដែលសរសេរដោយដៃនោះទេ។
បង្កើតគំរូគេហទំព័រ WordPress ដំណើរការវាជាមូលដ្ឋានដោយមិនចាំបាច់ដំឡើងអ្វីក្រៅពី Node និងដាក់ឱ្យដំណើរការវា។ Zinnector® ធ្វើការត្រួតពិនិត្យជាមុនលើគម្រោងរបស់អ្នកធៀបនឹងរន្ធដែលអ្នកត្រៀមនឹងដាក់ឱ្យដំណើរការ ដែលរួមមានកំណែ PHP ឌីស និងចំនួនឯកសារ ហើយផ្តល់ការព្រមានមុនពេលអ្នកបញ្ជូនទិន្នន័យជាជាងក្រោយពេលបញ្ជូន។ វាថែមទាំងអាចចូល រាយបញ្ជីគេហទំព័រ ដាក់ឱ្យដំណើរការ គ្រប់គ្រងដែន និង DNS អានសេវាកម្មអ៊ីមែល បម្រុងទុកទិន្នន័យ ដំណើរការ WP-CLI ដែលបានអនុញ្ញាត មើលកំណត់ហេតុ (logs) និងដំណើរការប្រតិបត្តិការច្រើនក្នុងពេលតែមួយ។ វាជាកម្មវិធីឥតគិតថ្លៃ មានអាជ្ញាប័ណ្ណ MIT និងត្រូវបានកសាងឡើងនៅលើ API សាធារណៈដូចគ្នានេះ។
គ្រប់គ្រងគេហទំព័រ ដែន កំណត់ត្រា DNS ប្រអប់សារ និងគម្រោងជាហេដ្ឋារចនាសម្ព័ន្ធបែបកូដ (infrastructure as code)។ ការប្រើប្រាស់ terraform apply គឺដើម្បីរៀបចំការបង្ហោះ ហើយបរិស្ថានរបស់អ្នកនឹងអាចបង្កើតឡើងវិញបាន និងអាចពិនិត្យឡើងវិញបាន ជំនួសឱ្យការចុចព្រឹត្តិការណ៍ផ្សេងៗតាមតម្រូវការដែលគ្មានអ្នកណាបានកត់ត្រាទុកឡើយ។
ឯកសារដែលបានបង្កើតឡើងដែលអ្នកអាចអាន និងហៅចេញពីកម្មវិធីរុករក ដែលពិពណ៌នាពិតប្រាកដអំពីចំណុចបញ្ចប់ដែលម៉ាស៊ីនបម្រើអនុវត្ត ពីព្រោះទាំងពីរមកពីលក្ខណៈជាក់លាក់ដូចគ្នា។
នៅពីក្រោយផ្លែតហ្វមនេះ គឺជារចនាសម្ព័ន្ធព្រឹត្តិការណ៍ដ៏រឹងមាំ៖ រាល់ការផ្លាស់ប្តូរស្ថានភាព សរសេរព្រឹត្តិការណ៍ទៅកាន់ transactional outbox នៅក្នុង Postgres ដោយស្វ័យប្រវត្តិជាមួយការផ្លាស់ប្តូរទិន្នន័យ ហើយ relay នឹងបោះពុម្ពវាទៅកាន់ NATS JetStream។ ព្រឹត្តិការណ៍ទាំងនោះត្រូវបានកំណត់ប្រភេទ និងកំណែ — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending និងផ្សេងៗទៀត។
ចុះឈ្មោះចំណុចបញ្ចប់ជា WebhookSubscription ហើយជ្រើសរើសប្រភេទព្រឹត្តិការណ៍ដែលវាទទួលបាន។ ស្ទ្រីមតែមួយផ្ដល់នូវការជូនដំណឹង ការវិភាគ ប្រព័ន្ធស្វ័យប្រវត្តិកម្ម និងការរួមបញ្ចូលរបស់អ្នកដូចគ្នា ដោយអ្នកកំពុងប្រើប្រាស់ព្រឹត្តិការណ៍ដូចគ្នាដែលពួកយើងប្រើដែរ។
រាល់ការដឹកជញ្ជូនទាំងអស់ត្រូវបានចុះហត្ថលេខាដោយ HMAC ដូច្នេះអ្នកអាចផ្ទៀងផ្ទាត់ថាវាពិតជាបានមកពីយើង មុនពេលអ្នកអនុវត្តសកម្មភាពលើវា។
ការបញ្ជូនដែលបរាជ័យនឹងត្រូវព្យាយាមម្តងទៀតដោយពន្យារពេលបន្ថែមជាបន្តបន្ទាប់ ហើយរាល់ការប៉ុនប៉ងត្រូវបានកត់ត្រាជា WebhookDelivery។ អ្នកអាចពិនិត្យមើល និងបញ្ជូនការបញ្ជូនទាំងនោះឡើងវិញពីផ្ទាំងគ្រប់គ្រងដោយផ្ទាល់ ជំនួសឱ្យការផ្ញើអ៊ីមែលទៅកាន់ផ្នែកជំនួយដើម្បីសួរថាតើពួកយើងបានផ្ញើអ្វីខ្លះ។
Pipeline នេះត្រូវបានបង្កើតឡើងយ៉ាងផ្ចិតផ្ចង់ឲ្យដំណើរការយ៉ាងហោចណាស់មួយដង (at-least-once) ជាជាងធ្វើពុតជាដំណើរការតែមួយដងគត់ (exactly-once)។ Relay ណាដែលដាច់នៅពាក់កណ្តាលទីនៃការបោះពុម្ពផ្សាយ នោះកិច្ចសន្យាជួលការទាមទារ (claim lease) របស់វានឹងផុតកំណត់ ហើយព្រឹត្តិការណ៍របស់វានឹងត្រូវបានបោះពុម្ពផ្សាយឡើងវិញ។ ធ្វើការលុបទិន្នន័យជាន់គ្នា (dedupe) លើ envelope id នោះ consumer របស់អ្នកនឹងមានភាពត្រឹមត្រូវតាមការរចនា។
API គឺគ្រាន់តែជាផ្នែកមួយនៃដំណើររបស់អភិវឌ្ឍន៍ប៉ុណ្ណោះ។ ផ្នែកម្ខាងទៀតគឺការដាក់ឱ្យប្រើប្រាស់។
API គឺជាទ្វារមួយ។ ទាំងនេះគឺជាបួនផ្សេងទៀត ហើយពួកវាទាំងអស់ត្រូវបានរួមបញ្ចូលក្នុងកញ្ចប់សេវាកម្ម មិនមែនលក់ជាកម្រិតសម្រាប់អ្នកអភិវឌ្ឍន៍នោះទេ។
VS Code ក្នុងកម្មវិធីរុករកបណ្ដាញ ដែលបានបើកពីទំព័រគេហទំព័រក្នុងផ្ទាំងគ្រប់គ្រង កែសម្រួលឯកសារពិតប្រាកដរបស់គេហទំព័រនោះ ជាមួយ git ដែលភ្ជាប់មកជាមួយ និងកម្មវិធីកែសម្រួលទាំងមូលស្ថិតក្នុង CageFS jail ដូចគ្នាទៅនឹងការចូលប្រើ SFTP របស់អ្នក។ វាធ្វើការកែសម្រួលគេហទំព័រ LIVE — គ្មានច្បាប់ចម្លង staging នៅចន្លោះនោះទេ ដូច្នេះឯកសារដែលអ្នកបានរក្សាទុក គឺសាធារណៈនៅពេលដែលវាត្រូវបានសរសេរ ប៉ុន្តែឯកសារឋិតិវន្តអាចបន្តផ្តល់សេវាកម្មពីឃ្លាំងសម្ងាត់ CDN រហូតដល់បួនម៉ោង។
ឥតគិតថ្លៃ មានអាជ្ញាបណ្័ MIT និងបង្កើតឡើងនៅលើ API សាធារណៈដូចគ្នានេះ។ បង្កើតគេហទំព័រ WordPress ដំណើរការវានៅលើម៉ាស៊ីនផ្ទាល់ខ្លួនរបស់អ្នក ពិនិត្យវាជាមុនធៀបនឹងស្លុតដែលអ្នករៀបនឹងដាក់ឱ្យប្រើប្រាស់ — កំណែ PHP, ឌីស, ចំនួនឯកសារ — ហើយដាក់ឱ្យប្រើប្រាស់។ ត្រូវការ Node 24 ឬថ្មីជាងនេះ។
កាតាឡុកឧបករណ៍តែមួយ ដូច្នេះអតិថិជន AI ដែលអ្នកកំពុងប្រើរួចហើយអាចធ្វើការលើគេហទំព័ររបស់អ្នកតាមរយៈ API ដូចគ្នា និងការអនុញ្ញាតដូចគ្នាដែលផ្ទាំងគ្រប់គ្រងប្រើប្រាស់។ម៉ាស៊ីនបម្រើដូចគ្នាដែលអតិថិជនផ្ទាល់របស់អ្នកតភ្ជាប់ គឺជាម៉ាស៊ីនបម្រើដែលបានតភ្ជាប់ទៅកម្មវិធីកែសម្រួលបណ្តាញ។ អាចអានបានតែប៉ុណ្ណោះ រហូតទាល់តែអ្នកប្រាប់ជាយ៉ាងផ្សេង។
ការងាររបស់អតិថិជនមិនត្រូវការពាក្យសម្ងាត់របស់អ្នកទេ។ អញ្ជើញនរណាម្នាក់តាមអាសយដ្ឋានអ៊ីមែល ហើយពួកគេទទួលបានគេហទំព័រមួយគត់៖ ពួកគេចូលគណនីដោយផ្ទាល់ ដោយមានតួនាទីជាអ្នកមើល អ្នកកែសម្រួល ឬអ្នកគ្រប់គ្រង ហើយគេហទំព័រផ្សេងទៀតទាំងអស់នឹងបង្ហាញកូដ 404 មុនពេលកម្មវិធីគ្រប់គ្រងណាមួយដំណើរការ ដែលនេះគឺជាគោលការណ៍សុវត្ថិភាពកម្រិតជួរដេករបស់ Postgres និងរបាំងការពារកម្រិតសំណើ មិនមែនគ្រាន់តែជាការផ្ទៀងផ្ទាត់មួយនោះទេ។ ម្ចាស់គណនីផ្ដល់សិទ្ធិ និងដកហូតសិទ្ធិវាបានដោយចុចតែម្តង ដែលមានប្រសិទ្ធភាពភ្លាមៗនៅសំណើបន្ទាប់របស់ពួកគេ។
យើងផ្តល់ជូនវេទិកានេះជាម៉ាស៊ីនបម្រើ MCP ដែលមានស្រាប់៖ ឧបករណ៍សម្របពិធីការស្ដើងមួយនៅលើ API ម៉ាស៊ីន ដែលប្រើប្រាស់កាតាឡុកសកម្មភាព RBAC និងកំណត់ត្រាត្រួតពិនិត្យដូចគ្នា។ ភ្ជាប់ Claude Code, Cursor, ChatGPT, Claude Desktop ឬអតិថិជនណាមួយដែលប្រើប្រាស់ MCP ម្ដង ហើយរាល់សមត្ថភាពដែលយើងបន្ថែមទៅក្នុង API នឹងអាចប្រើប្រាស់បានដោយស្វ័យប្រវត្តិ។
ភ្នាក់ងារទទួលបានបីយ៉ាងគឺ៖ ឧបករណ៍ (ចំណុចប្រទាក់ API ដូចគ្នា មិនមានតក្កវិជ្ជាស្របគ្នាដែលងាយរអិលឡើយ) ធនធាន (សុខភាពគេហទំព័រ ការកំណត់ កំណត់ហេតុថ្មីៗ រង្វាស់ សុពលភាពដំណើរការ និងអត្ថបទមជ្ឈមណ្ឌលជំនួយដែលមិនអាចកែប្រែបាន ដូច្នេះវាធ្វើរោគវិនិច្ឆ័យជាមួយទិន្នន័យជាក់ស្តែងមុននឹងចាត់វិធានការ) និងប្រអប់បញ្ចូល (គំរូដំណើរការការងារដែលបានផ្សាយបន្តផ្ទាល់ ដូចជា "ធ្វើរោគវិនិច្ឆ័យគេហទំព័រនេះ" ឬ "រៀបចំការផ្ទេរទិន្នន័យ")។
សុវត្ថិភាពគឺមានទម្រង់ដូចគ្នានឹងការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវដែរ៖ OAuth 2.1, តូកិនដែលភ្ជាប់ទៅនឹងអង្គភាពរបស់អ្នក និងការអនុញ្ញាត RBAC ដែលមានសុវត្ថិភាពកម្រិតជួរដេកត្រូវបានអនុវត្ត, កំណត់វិសាលភាព និងអាចដកហូតបានតាមឧបករណ៍នីមួយៗ, សែនបក្ស (sandbox) ត្រូវបានបំបែកចេញពីប្រព័ន្ធផលិតកម្ម។ សកម្មភាពដែលបំផ្លិចបំផ្លាញ — លុប, ផ្អាក, ការទូទាត់ប្រាក់, ការចំណាយច្រើន — ទាមទារឱ្យមានការបញ្ជាក់ច្បាស់លាស់ ឬគោលការណ៍អនុម័តពីមនុស្ស។ កម្រិតអត្រា និងដែនកំណត់ការចំណាយ ត្រូវបានកំណត់ចំពោះសកម្មភាពបង់ប្រាក់ដែលកេះដោយ AI ហើយរាល់ការហៅ MCP ទាំងអស់ត្រូវបានកត់ត្រាក្នុងកំណត់ហេតុសវនកម្មជាមួយនឹងអត្តសញ្ញាណ, ឧបករណ៍, អាគុយម៉ង់ និងលទ្ធផល។
យើងគាំទ្រប្រូតូកុលនេះជាជាងការរួមបញ្ចូលកម្មវិធីនីមួយៗម្តងមួយៗ ដែលមានន័យថាជម្រើសនៃឧបករណ៍ AI របស់អ្នកអាចផ្លាស់ប្តូរបានដោយមិនចាំបាច់ផ្លាស់ប្តូរការរួមបញ្ចូលការបង្ហោះរបស់អ្នកជាមួយវាឡើយ។
បាទ/ចាស — វាគឺជា API ម៉ាស៊ីនតែមួយ ដែលត្រូវបានផ្សព្វផ្សាយ និងពង្រឹងសុវត្ថិភាព។ បន្ទះគ្រប់គ្រង កុងសូលអភិបាលកិច្ច CLI អ្នកផ្តល់សេវា Terraform ម៉ាស៊ីនមេ MCP និង webhooks សុទ្ធតែជាអ្នកប្រើប្រាស់ផ្ទៃតែមួយ ហេតុផលនេះហើយទើប API មិនមានភាពយឺតយ៉ាវជាងផ្ទាំងគ្រប់គ្រងឡើយ។
បាទ/ចាស។ សោប្រអប់ខ្សាច់ត្រូវបានចេញដាច់ដោយឡែកពីសោផលិតកម្ម និងដំណើរការក្នុងរបៀបសាកល្បង៖ គ្មានការចេញវិក្កយបត្រពិតប្រាកដ និងគ្មានការផ្តល់ធនធានពិតប្រាកដទេ។ ចង្អុលបង្ហាញ CI របស់អ្នកទៅកាន់ព័ត៌មានសម្ងាត់ប្រអប់ខ្សាច់ ហើយធ្វើតេស្តរង្វិលជុំសំណើ និងការឆ្លើយតបពេញលេញដោយសុវត្ថិភាព។
ផ្ញើ Idempotency-Key នៅលើសំណើ POST របស់អ្នក។ កំណត់ត្រាផ្ដាច់ផ្ដល់ (replay record) ត្រូវបានសរសេរនៅពេល commit ជំនួសឱ្យការសរសេរផ្ទាល់ក្នុងជួរ ដូច្នេះការធ្វើសំណើឡើងវិញមិនអាចចម្លងទិន្នន័យដែលជោគជ័យដែលបានរក្សាទុកក្នុងឃ្លាំងសម្ងាត់ សម្រាប់ជួរដេកដែលតាមពិតមិនបាន commit នោះទេ ហើយសំណើដែលបរាជ័យនឹងលែងសោភ្លាមៗ ដូច្នេះការធ្វើសំណើឡើងវិញដែលបានកែសម្រួលរបស់អ្នកនឹងមិនត្រូវជាប់គាំងឡើយ។ ការបញ្ជូន Webhook ត្រូវបានរចនាឡើងឱ្យមានការបញ្ជូនយ៉ាងហោចណាស់ម្ដង (at-least-once) — សូមធ្វើការលុបស្ទួន (dedupe) នៅលើអត្តសញ្ញាណកាតាប (envelope id) នៅខាងចុងរបស់អ្នក។
មិនមែនថ្ងៃនេះទេ។ កូនសោ API ត្រូវ បានចេញជូនតាមអង្គភាពនីមួយៗ ដូច្នេះការធ្វើអាំងតេក្រាលដែលគ្របដណ្តប់លើអង្គភាពអតិថិជនច្រើន នឹងកាន់កាប់កូនសោមួយសម្រាប់អង្គភាពនីមួយៗ។ សិទ្ធិអនុញ្ញាតក៏ត្រូវបានពិនិត្យតាមអង្គភាពនីមួយៗសម្រាប់អ្នកប្រើប្រាស់សំខាន់ៗផងដែរ៖ ការមានសិទ្ធិ sites.create នៅក្នុងអង្គភាពមួយ មិនផ្តល់សិទ្ធិចូលប្រើប្រាស់នៅក្នុងអង្គភាពផ្សេងទៀតដែលមិនពាក់ព័ន្ធនោះទេ ទោះបីជាវាអនុវត្តចំពោះអង្គភាពដែលស្ថិតនៅក្រោមអង្គភាពនោះក៏ដោយ។ នោះគឺជាចេតនា — វាបិទខ្ទប់កូនសោដែលរងការខូចខាតឱ្យនៅត្រឹមអង្គភាពរបស់វា និងអង្គភាពរងនៅខាងក្រោមវាតែប៉ុណ្ណោះ មិនមែនប្រព័ន្ធទាំងមូលនោះទេ។
តួនាទីអ្នកអភិវឌ្ឍន៍ (Dev) រួមមានការអានព័ត៌មានអង្គភាព ការគ្រប់គ្រងកូនសោ API ការមើល និងការបង្កើតគេហទំព័រ ការចាប់ផ្តើមឡើងវិញ ការលុប Cache និងការមើលព្រមទាំងឆ្លើយតបទៅសំបុត្រស្នើសុំជំនួយ។ តួនាទីនេះត្រូវបានកំណត់មិនរាប់បញ្ចូលការគ្រប់គ្រងការទូទាត់ប្រាក់នោះទេ។ សូមកត់សម្គាល់ថា សិទ្ធិក្នុងការបញ្ចេញ (Deploy) និងការរុញទៅផ្សាយផ្ទាល់ (Push-to-live) គឺមិនមែនជាផ្នែកនៃតួនាទីនេះទេ — ប្រសិនបើសមាជិកក្រុមត្រូវការសិទ្ធិទាំងនោះ សូមប្រគល់តួនាទីដែលមានសិទ្ធិទាំងនោះ ជំនួសឱ្យការសន្មតថា Developer ជាតួនាទីបច្ចេកទេសដែលមានសិទ្ធិទូលំទូលាយបំផុត។
ការដឹកជញ្ជូនឡើងវិញត្រូវបានព្យាយាមដោយប្រើប្រាស់ប្រព័ន្ធ backoff ហើយរាល់ការព្យាយាមទាំងអស់ត្រូវបានកត់ត្រាជា WebhookDelivery ដែលអ្នកអាចពិនិត្យមើលបាន។ នៅដើមចរន្ត ព្រឹត្តិការណ៍នានាត្រូវបានសរសេរចូលទៅក្នុងប្រអប់ចេញប្រតិបត្តិការ (transactional outbox) ក្នុងប្រតិបត្តិការមូលដ្ឋានទិន្នន័យតែមួយជាមួយនឹងការផ្លាស់ប្តូរផ្ទាល់ ដូច្នេះគ្មានអ្វីត្រូវបានបាត់បង់ឡើយខណៈពេលដែលអ្នកប្រើប្រាស់មិនមានវត្តមាន—អ្នកប្រើប្រាស់ដែលផ្អាកដំណើរការនឹងមានភាពយឺតយ៉ាវ ប៉ុន្តែវាមិនធ្វើឱ្យប្រព័ន្ធផលិតខូចឡើយ ហើយអ្នកអាចចាក់បញ្ចូនការដឹកជញ្ជូនឡើងវិញពីផ្ទាំងគ្រប់គ្រងបាននៅពេលដែលអ្នកត្រឡប់មកវិញ។
ចាប់ផ្តើមសាកល្បងប្រើប្រាស់ Footprint-Free Hosting រយៈពេល ១៤ថ្ងៃដោយមិនបាច់ប្រើកាត—មិនបាច់មានព័ត៌មានទូទាត់ប្រាក់ ព្រមទាំងអាចប្រើបានរហូតដល់ ៥ គេហទំព័រ។ កញ្ចប់សេវាកម្ម Footprint-Free បង់ប្រាក់ចាប់ផ្តើមពី $6/ខែ សម្រាប់ PBN 5។ កញ្ចប់សេវាកម្មនីមួយៗមានការធានាជូនប្រាក់វិញក្នុងរយៈពេល ៣០ថ្ងៃ ការផ្ទេរទិន្នន័យដោយឥតគិតថ្លៃ និងគ្មានការចងភ្ជាប់ជាមួយអ្នកផ្តល់សេវាកម្មឡើយ។
API ដែលផ្តោតលើការបញ្ជាក់, SDKs ដែលបានបង្កើត, CLI, ឧបករណ៍ផ្តល់សេវា Terraform, វេបហ៊ុកដែលបានចុះហត្ថលេខា និងម៉ាស៊ីនមេ MCP — នៅលើសេវាបង្ហោះដែលយើងបានបង្កើតសម្រាប់គេហទំព័រជាង 650,000 ទូទាំងពិភពលោក។ ចាប់ផ្តើមការសាកល្បងរយៈពេល 14 ថ្ងៃដោយមិនចាំបាច់ប្រើកាត និងមិនត្រូវការព័ត៌មានទូទាត់។
ចាប់ផ្តើមដោយឥតគិតថ្លៃ