អ្នកអភិវឌ្ឍន៍

ឯកសារយោងសមត្ថភាព Zinn® Reseller Toolkit

Zinn® Reseller Toolkit ចុះឈ្មោះសកម្មភាពរបស់ខ្លួនជាមួយនឹង WordPress Abilities API។ សមត្ថភាពដូចគ្នាគឺឧបករណ៍ MCP នៅលើម៉ាស៊ីនបម្រើផ្ទាល់ខ្លួនរបស់គេហទំព័រ និង REST routes ក្រោម /wp-json/wp-abilities/v1។ ទំព័រនេះត្រូវបានបង្កើតឡើងពីបញ្ជីឈ្មោះរបស់កម្មវិធីជំនួយផ្ទាល់។

សៀវភៅដៃអ្នកប្រើ៖ ភ្ជាប់កម្មវិធី AI មួយ

ចំណុចបញ្ចប់

MCP តាមរយៈ HTTP (ដែលអាចចand stream បាន)

https://example.com/wp-json/zinn-reseller/v1/mcp

MCP តាមរយៈ WP-CLI (លទ្ធផល និងបច្ច័យស្តង់ដារ)

wp mcp-adapter serve --server=zinn-reseller --user=<login>

REST៖ បញ្ជីសមត្ថភាព

/wp-json/wp-abilities/v1/abilities?category=zinn-reseller

REST៖ ដំណើរការសមត្ថភាព

/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-client` `zinn-reseller-create-client`	បង្កើតអតិថិជនម្នាក់ បង្កើតគណនីអតិថិជនមួយនៅក្រោមគណនីរបស់អ្នក (ឈ្មោះ; default_currency ដែលជាកូដបីអក្សរ)។ ដាក់ពួកគាត់នៅលើគម្រោងសេវាកម្មមួយមុនពេលគេបង្កើតគេហទំព័រដំបូង។	ជំនាន់ឥតគិតថ្លៃ	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (ទាមទារ), default_currency: string
`zinn-reseller/create-site` `zinn-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-plan` `zinn-reseller-get-client-plan`	អានផែនការរបស់អតិថិជន បញ្ជូនបន្តនូវកញ្ចប់សេវាកម្មដែលអតិថិជនកំពុងប្រើប្រាស់ និងតម្លៃដែលវាគិតលើអ្នក (client_id)។	ជំនាន់ឥតគិតថ្លៃ	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (ទាមទារ)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	អានគណនីអ្នកលក់បន្តរបស់អ្នក បង្ហាញគណនីអ្នកលក់បន្តរបស់អ្នកក្នុងការអានតែមួយ៖ ម៉ាក ផែនការ ចំនួនអតិថិជន និងសេវាកម្ម និងអ្វីដែលត្រូវបានកំណត់រចនាសម្ព័ន្ធ។	ជំនាន់ឥតគិតថ្លៃ	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	គ្មាន
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	អានការកំណត់ឧបករណ៍ប្រដាប់ប្រដារអ្នកលក់បន្ត បញ្ជូនត្រឡប់នូវការកំណត់របស់ផ្លកអ៊ីននេះ (អាសយដ្ឋាន API, គម្រោងដែលការបញ្ជាទិញថ្មីប្រើប្រាស់, និងមុខងារណាខ្លះដែលត្រូវបានបើក)។ សោ API នឹងមិនត្រូវបានបញ្ជូនត្រឡប់ឡើយ មានតែព័ត៌មានដែលថាតើមានសោមួយត្រូវបានរក្សាទុកដែរឬទេប៉ុណ្ណោះ។	ជំនាន់ឥតគិតថ្លៃ	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	គ្មាន
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	រាយបញ្ជីអតិថិជនរបស់អ្នក បង្ហាញបញ្ជីគណនីអតិថិជនរបស់អ្នក ម្ដងមួយទំព័រ (ទស្សន៍ទ្រនិច, កម្រិតកំណត់)។	ជំនាន់ឥតគិតថ្លៃ	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	រាយបញ្ជីគម្រោងដែលអ្នកអាចលក់បាន រាយបញ្ជីគម្រោងហូស្ដិ៍ និងតម្លៃរបស់វា (product_line និង currency កំណត់ដែនកំណត់)។	ជំនាន់ឥតគិតថ្លៃ	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-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-plan` `zinn-reseller-set-client-plan`	ដាក់អតិថិជនម្នាក់នៅលើកញ្ចប់សេវាកម្មមួយ ដាក់អតិថិជនម្នាក់នៅលើផែនការមួយរបស់អ្នក (client_id, plan_code; interval: ខែ ឬ ឆ្នាំ)។ សូមធ្វើរឿងនេះមុនពេលគេហទំព័រដំបូងរបស់ពួកគេ។	ជំនាន់ឥតគិតថ្លៃ	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (ទាមទារ), plan_code: string (ទាមទារ), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	ផ្អាកគេហទំព័ររបស់អតិថិជន ដាក់គេហទំព័ររបស់អតិថិជនឱ្យស្ថិតក្នុងស្ថានភាពផ្អាកដោយសារការមិនបង់ប្រាក់ (site_id; ហេតុផល៖ កំណត់ចំណាំផ្ទាល់ខ្លួនរបស់អ្នក ដែលមិនបង្ហាញដល់អតិថិជនឡើយ)។ គេហទំព័រនឹងឈប់ដំណើរការរហូតទាល់តែវាត្រូវបានបើកដំណើរការឡើងវិញ។	ជំនាន់ឥតគិតថ្លៃ	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (ទាមទារ), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	ឈប់ផ្អាកគេហទំព័ររបស់អតិថិជន ដកការផ្អាកការមិនបង់ប្រាក់ចេញ ដើម្បីឱ្យគេហទំព័រដំណើរការឡើងវិញ (site_id)។	ជំនាន់ឥតគិតថ្លៃ	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (ទាមទារ)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	ផ្លាស់ប្តូរការកំណត់ឧបករណ៍បណ្តុំសម្រាប់អ្នកលក់បន្ត ផ្លាស់ប្តូរការកំណត់ដែលអ្នកផ្ញើ (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