hosting

POST /v1/media-offload/uploads

Presigned upload URLs for a batch of media files.

Всички крайни точки в hosting

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

Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.

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

Опитайте

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

curl -X POST https://api.zinndigital.com/v1/media-offload/uploads \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "keys": <string[]> }'

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

Детайли

Called by the Zinn® Media Offload plugin with a bearer plugin token. Returns one presigned `PUT` URL per key; the plugin then sends the bytes **straight to storage**, so no file ever transits this API and no storage credential ever reaches WordPress. Up to 100 keys per request. Presigning is local cryptography with no vendor round trip, so a batch costs no more than a single key — which is what makes offloading an existing 20,000-file media library 200 requests rather than 20,000. Every key is joined onto the site's own prefix and validated. A key that tries to climb out of that prefix is refused with `422`, never normalised into something plausible.

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

ИмеТипЗадължителноКакво представлява
keysstring[]Да
plugin_versionstringНе

Отговор

ИмеТипЗадължителноКакво представлява
uploadsobject[]Да

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

401 · 422 · 429 · 503