hosting
POST /v1/connector/backup/claim
Ask whether a backup is due — called by the Zinn® WordPress connector plugin.
Аутентификација
Ова крајња тачка је јавна. Не захтева никакве акредитиве нити организацију — то је оно што читају наш сопствени маркетиншки сајт и машине за одговоре са вештачком интелигенцијом.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/connector/backup/claim \
-H "Content-Type: application/json" \
-d '{ }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Unauthenticated by session, authorised by a per-site bearer token minted when the customer connected the site. The caller is PHP on a server we have never seen and has no session with us. Returns either a job (job_id plus a short-lived presigned upload URL) or an empty object meaning nothing due. The plugin polls hourly and streams the archive straight to object storage, so it never passes through our servers. ⛔ A wrong or unknown token returns 200 with an empty body, exactly like "nothing due". That is deliberate and is the opposite of what an API normally does: a 401 would confirm to an unauthenticated caller that a given site is enrolled for backups, and this route is reachable by anyone. The plugin cannot tell the two apart either, and does not need to.
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
site_url | string | Не | The plugin's own view of the site address, for diagnostics only. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
job_id | string | Не | The backup row this upload settles. |
upload_url | string | Не | A short-lived presigned PUT. ⛔ A bearer credential — whoever holds it can write that object — so the plugin never logs it, stores it, or shows it in an admin notice. It grants… |
Грешке које ова крајња тачка може вратити
429