hosting

POST `/v1/media-offload/claim`

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

Authenticatie

Dit eindpunt is openbaar. Het vereist geen inloggegevens en geen organisatie; het is wat onze eigen marketingwebsite en AI-antwoordmachines uitlezen.

Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

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

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

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.

Aanvraaglichaam

Naam	Type	Verplicht	Wat dit is
`code`	`string`	Ja	—
`plugin_version`	`string`	Nee	—
`site_url`	`string`	Nee	—

Reactie

Naam	Type	Verplicht	Wat dit is
`token`	`string`	Ja	Shown once and never again. Stored by us only as a SHA-256 hash.
`site_id`	`string`	Ja	—
`prefix`	`string`	Ja	The key prefix this site's objects live under.
`public_base_url`	`string`	Nee	Where a rewritten media URL points. Empty when the bucket is private, in which case the plugin must not rewrite anything.
`rewrite_urls`	`boolean`	Ja	—
`delete_local`	`boolean`	Ja	—

Fouten die dit eindpunt kan retourneren

422 · 429

POST /v1/media-offload/claim