plugin-support
POST /v1/plugin-support/connections
Connect a WordPress site to Zinn® plugin support.
Аутентификација
Ова крајња тачка је јавна. Не захтева никакве акредитиве нити организацију — то је оно што читају наш сопствени маркетиншки сајт и машине за одговоре са вештачком интелигенцијом.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/plugin-support/connections \
-H "Content-Type: application/json" \
-d '{ "email": <string>, "product": <string>, "site_url": <string>, "consent": <boolean> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Called server-side by a Zinn® WordPress plugin (Tranzly, Page Builder Sandwich) after the site owner agreed on the plugin's consent screen (WordPress.org Guideline 7). Creates — or reuses — a support contact for the e-mail address and returns a scoped, revocable connection token once. ADR 0035; contract docs/plugins-overhaul/x1-x7-contract.md §2.1. ⛔ A contact is never an organization. Nothing here creates an org, a user or a membership; a contact whose address matches a platform user is linked for staff to see and nothing more (owner, D33). ⛔ The engine stores only sha256(token). The token's scopes are support.tickets and support.diagnostics and nothing else — no scope administers or logs into the site. Anonymous: no session, CSRF-exempt. Budgets: 10/hour per IP (charged before the body is parsed) and 5/hour per e-mail, 429 with Retry-After. A filled website honeypot answers 202 and stores nothing.
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
email | string | Да | — |
name | string | Не | — |
product | string | Да | — |
site_url | string | Да | — |
site_name | string | Не | — |
plugin_version | string | Не | — |
wp_version | string | Не | — |
php_version | string | Не | — |
locale | string | Не | The WordPress locale (fr_FR); mail to the contact is rendered in it. |
consent | boolean | Да | Must be literally true — the site owner agreed on the consent screen (WordPress.org Guideline 7). Anything else is 422. |
website | string | Не | Honeypot. Must be empty. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
connection_id | string | Да | — |
token | string | Да | zps_ + 43 URL-safe characters. Returned ONCE; the engine keeps only its SHA-256. The plugin stores it sealed (libsodium secretbox, ADR 0034's key scheme). |
scopes | string<support.tickets, support.diagnostics>[] | Да | — |
contact | object | Да | — |
Грешке које ова крајња тачка може вратити
422 · 429