ਡਿਵੈਲਪਰਜ਼

Zinn® Reseller Toolkit ਸਮਰੱਥਾ ਹਵਾਲਾ

Zinn® Reseller Toolkit ਆਪਣੇ ਕਾਰਜਾਂ ਨੂੰ WordPress Abilities API ਨਾਲ ਰਜਿਸਟਰ ਕਰਦਾ ਹੈ। ਇਹੋ ਅਯੋਗਤਾਵਾਂ ਸਾਈਟ ਦੇ ਆਪਣੇ ਸਰਵਰ 'ਤੇ MCP ਟੂਲ ਅਤੇ /wp-json/wp-abilities/v1 ਦੇ ਅਧੀਨ REST ਰੂਟ ਹਨ। ਇਹ ਪੰਨਾ ਪਲੱਗਇਨ ਦੀ ਆਪਣੀ ਰਜਿਸਟਰੀ ਤੋਂ ਤਿਆਰ ਕੀਤਾ ਗਿਆ ਹੈ।

ਯੂਜ਼ਰ ਗਾਈਡ: ਇੱਕ AI ਐਪ ਕਨੈਕਟ ਕਰੋ

ਸਿਰੇ

HTTP ਉੱਤੇ MCP (ਸਟ੍ਰੀਮ ਕਰਨ ਯੋਗ)

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

WP-CLI ਉੱਤੇ MCP (ਸਟੈਂਡਰਡ ਇਨਪੁੱਟ ਅਤੇ ਆਉਟਪੁੱਟ)

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 ਸਰਵਰ ਨਾਲ ਕਨੈਕਟ ਕਰਨ ਲਈ ਹੇਠਾਂ ਦਿਖਾਈ ਗਈ ਸਮਰੱਥਾ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ; ਫਿਰ ਹਰ ਇੱਕ ਸਮਰੱਥਾ ਪ੍ਰਤੀ ਆਬਜੈਕਟ ਆਪਣੀ ਖੁਦ ਦੀ ਇਜਾਜ਼ਤ ਦੀ ਜਾਂਚ ਕਰਦੀ ਹੈ। ਪੜ੍ਹਨ-ਯੋਗ (Read-only) ਸਮਰੱਥਾਵਾਂ 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`	ਕਲਾਇਆਇੰਟ ਬਣਾਓ ਤੁਹਾਡੇ ਹੇਠਾਂ ਇੱਕ ਕਲਾਇੰਟ ਖਾਤਾ ਬਣਾਉਂਦਾ ਹੈ (name; 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: month ਜਾਂ year)। ਇਸ ਨੂੰ ਉਹਨਾਂ ਦੀ ਪਹਿਲੀ ਸਾਈਟ ਤੋਂ ਪਹਿਲਾਂ ਕਰੋ।	ਮਫ਼ਤ ਐਡੀਸ਼ਨ	`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