អ្នកអភិវឌ្ឍន៍
ឯកសារយោងសមត្ថភាព Zinn® Reseller Toolkit
Zinn® Reseller Toolkit ចុះឈ្មោះសកម្មភាពរបស់ខ្លួនជាមួយនឹង WordPress Abilities API។ សមត្ថភាពដូចគ្នាគឺឧបករណ៍ MCP នៅលើម៉ាស៊ីនបម្រើផ្ទាល់ខ្លួនរបស់គេហទំព័រ និង REST routes ក្រោម /wp-json/wp-abilities/v1។ ទំព័រនេះត្រូវបានបង្កើតឡើងពីបញ្ជីឈ្មោះរបស់កម្មវិធីជំនួយផ្ទាល់។
ចំណុចបញ្ចប់
MCP តាមរយៈ HTTP (ដែលអាចចand stream បាន)
https://example.com/wp-json/zinn-reseller/v1/mcpMCP តាមរយៈ WP-CLI (លទ្ធផល និងបច្ច័យស្តង់ដារ)
wp mcp-adapter serve --server=zinn-reseller --user=<login>REST៖ បញ្ជីសមត្ថភាព
/wp-json/wp-abilities/v1/abilities?category=zinn-resellerREST៖ ដំណើរការសមត្ថភាព
/wp-json/wp-abilities/v1/abilities/<name>/runការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ និងសិទ្ធិអំណាច
សំណើ HTTP ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវជាមួយពាក្យសម្ងាត់កម្មវិធី WordPress (HTTP Basic)។ ការតភ្ជាប់ទៅកាន់ម៉ាស៊ីនមេ MCP ត្រូវការសមត្ថភាពដែលបង្ហាញខាងក្រោម។ បន្ទាប់មក សមត្ថភាពនីមួយៗពិនិត្យមើលសិទ្ធិផ្ទាល់ខ្លួន ក្នុងមួយគោលវត្ថុ។ សមត្ថភាពអានតែប៉ុណ្ណោះដំណើរការជាមួយ GET និងការបញ្ចូលរបស់វាគ្ហទំព័រក្នុងប្រអប់សំណួរ ចំណែកឯសមត្ថភាពផ្សេងទៀតដំណើរការជាមួយ POST និងតួ JSON {"input": {…}}។
ឧទាហរណ៍
# REST៖ ដំណើរការសមត្ថភាព
curl -u your-username:your-application-password \
"https://example.com/wp-json/wp-abilities/v1/abilities/zinn-reseller/get-overview/run"# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-reseller-get-overview","arguments":{}}}សមត្ថភាពទាំងអស់
បង្កើតចេញពី abilities.json របស់ជំនួយការ ដែលវាផ្ទាល់ត្រូវបានបង្កើតចេញពីគេហទំព័រដែលកំពុងដំណើរការ។ ការធ្វើតេស្តមួយបរាជ័យនៅពេលដែលរបស់ទាំងពីរនេះមិនស៊ីគ្នា។
| សមត្ថភាព | អ្វីដែលវាធ្វើ | ជំនាន់ | REST | ការអនុញ្ញាត | ប៉ារ៉ាម៉ែត្រ |
|---|---|---|---|---|---|
zinn-reseller/create-clientzinn-reseller-create-client | បង្កើតម៉ាស៊ីនភ្ញៀវ បង្កើតគណនីអតិថិជនមួយនៅក្រោមគណនីរបស់អ្នក (name; default_currency ដែលជាកូដមានបីអក្សរ)។ សូមដាក់ពួកគាត់ឱ្យប្រើគម្រោងណាមួយ មុនពេលគេហទំព័រដំបូងរបស់ពួកគាត់។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (ទាមទារ), default_currency: string |
zinn-reseller/create-sitezinn-reseller-create-site | បង្កើតគេហទំព័រសម្រាប់អតិថិជន បង្កើតគេហទំព័រដែលបានបង្ហោះសម្រាប់អតិថិជនម្នាក់របស់អ្នក (client_id, product_line, primary_domain)។ វាត្រូវបានគិតប្រាក់ទៅគណនីរបស់អ្នកតាមគម្រោងរបស់អតិថិជន ដូចជាពីហាងរបស់អ្នកដែរ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/create-site/run | manage_options | client_id: string (ទាមទារ), product_line: string (ទាមទារ), primary_domain: string (ទាមទារ) |
zinn-reseller/get-client-planzinn-reseller-get-client-plan | អានគម្រោងរបស់អតិថិជន បង្ហាញថាតើអតិថិជនកំពុងប្រើគម្រោងណា និងតម្លៃដែលអ្នកត្រូវចំណាយ (client_id)។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (ទាមទារ) |
zinn-reseller/get-overviewzinn-reseller-get-overview | អានគណនីអ្នកលក់បន្តរបស់អ្នក បង្ហាញគណនីអ្នកលក់បន្តរបស់អ្នកក្នុងការអានតែម្តង៖ ម៉ាកយីហោ គម្រោង ចំនួនអតិថិជន និងសេវាកម្ម ព្រមទាំងអ្វីដែលត្រូវបានរៀបចំរួចរាល់។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/get-overview/run | manage_options | គ្មាន |
zinn-reseller/get-settingszinn-reseller-get-settings | អានការកំណត់ Reseller Toolkit បង្ហាញការកំណត់នៃកម្មវិធីជំនួយនេះ (អាសយដ្ឋាន API, គម្រោងដែលការបញ្ជាទិញថ្មីប្រើប្រាស់, មុខងារណាខ្លះដែលត្រូវបានបើក)។ សោ API មិនត្រូវបានបង្ហាញឡើងវិញឡើយ ដោយគ្រាន់តែបង្ហាញថាតើមានរក្សាទុកមួយឬអត់ប៉ុណ្ណោះ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/get-settings/run | manage_options | គ្មាន |
zinn-reseller/list-clientszinn-reseller-list-clients | រាយបញ្ជីអតិថិជនរបស់អ្នក រាយបញ្ជីគណនីអតិថិជនរបស់អ្នក ម្តងមួយទំព័រ (cursor, limit)។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | រាយបញ្ជីគម្រោងដែលអ្នកអាចលក់បាន រាយបញ្ជីគម្រោងបង្ហោះនិងតម្លៃរបស់ពួកវា (product_line និង currency កំណត់វាឱ្យចង្អៀត)។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-reseller-list-sites | រាយបញ្ជីគេហទំព័ររបស់អតិថិជនអ្នក រាយបញ្ជីអ្វីៗគ្រប់យ៉ាងដែលអ្នកបានរៀបចំផ្ដល់ជូនសម្រាប់អតិថិជនរបស់អ្នក (client_id និង status កំណត់ព្រំដែនវា) ម្តងមួយទំព័រ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-reseller/list-sites/run | manage_options | cursor: string, limit: integer, client_id: string, status: string |
zinn-reseller/set-client-planzinn-reseller-set-client-plan | ដាក់អតិថិជននៅលើគម្រោងមួយ កំណត់អតិថិជនទៅកាន់គម្រោងណាមួយរបស់អ្នក (client_id, plan_code; interval: month ឬ year)។ សូមធ្វើដូចនេះមុនគេហទំព័រដំបូងរបស់ពួកគេ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/set-client-plan/run | manage_options | client_id: string (ទាមទារ), plan_code: string (ទាមទារ), interval: month|year |
zinn-reseller/suspend-sitezinn-reseller-suspend-site | ផ្អាកដំណើរការគេហទំព័ររបស់អតិថិជន ដាក់គេហទំព័ររបស់អតិថិជនឱ្យស្ថិតក្នុងការផ្អាកដោយសារការមិនបង់ប្រាក់ (site_id; reason: កំណត់សម្គាល់ផ្ទាល់ខ្លួនរបស់អ្នក មិនដែលត្រូវបានបង្ហាញដល់អតិថិជនឡើយ)។ គេហទំព័រនេះឈប់ដំណើរការរហូតដល់វាត្រូវបានដកការផ្អាក។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (ទាមទារ), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | លើកលែងការព្យួរគេហទំព័ររបស់អតិថិជន ដកការផ្អាកដំណើរការដោយសារការមិនបង់ប្រាក់ចេញ ដើម្បីឱ្យគេហទំព័រអាចដំណើរការឡើងវិញ (site_id)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (ទាមទារ) |
zinn-reseller/update-settingszinn-reseller-update-settings | ផ្លាស់ប្តូរការកំណត់ Reseller Toolkit ផ្លាស់ប្តូរការកំណត់ដែលអ្នកផ្ញើ (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) និងរក្សាទុកអ្វីដែលនៅសល់។ កូនសោ API និងអាសយដ្ឋានត្រូវបានផ្លាស់ប្តូរនៅលើអេក្រង់តែប៉ុណ្ណោះ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-reseller/update-settings/run | manage_options | plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean |