hosting

POST `/v1/media-offload/claim`

The WordPress plugin, redeeming a pairing code for a scoped token.

Упълномощаване

Този крайpoint е публичен. Той не изисква данни за удостоверяване и организация — това е съдържанието, което нашият собствен маркетинг сайт и AI машини за отговори четат.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

curl -X POST https://api.zinndigital.com/v1/media-offload/claim \
  -H "Content-Type: application/json" \
  -d '{ "code": <string> }'

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

Called by the Zinn® Media Offload plugin on a customer's WordPress server. **This endpoint is unauthenticated**: the caller has no session with us and can name no organisation — the pairing code is what names it. Every failure — an expired code, an already-claimed code and a code that never existed — returns the same `422`. Distinguishing them would confirm to a caller that a guessed code exists, which is the only thing between them and another organisation's storage.

Тяло на заявката

Име	Тип	Задължително	Какво представлява
`code`	`string`	Да	—
`plugin_version`	`string`	Не	—
`site_url`	`string`	Не	—

Отговор

Име	Тип	Задължително	Какво представлява
`token`	`string`	Да	Shown once and never again. Stored by us only as a SHA-256 hash.
`site_id`	`string`	Да	—
`prefix`	`string`	Да	The key prefix this site's objects live under.
`public_base_url`	`string`	Не	Where a rewritten media URL points. Empty when the bucket is private, in which case the plugin must not rewrite anything.
`rewrite_urls`	`boolean`	Да	—
`delete_local`	`boolean`	Да	—

Грешки, които този крайpoint може да върне

422 · 429

POST /v1/media-offload/claim