hosting

POST `/v1/connector/backup/claim`

Ask whether a backup is due — called by the Zinn® WordPress connector plugin.

Xác thực

Điểm cuối này là công khai. Nó không yêu cầu thông tin xác thực hay tổ chức nào — đây chính là nội dung mà trang web tiếp thị và các công cụ trả lời bằng AI của chúng tôi đọc.

Endpoint này không nhận ID tổ chức. Khóa của bạn đã xác định tổ chức mà nó thuộc về và phản hồi được giới hạn trong phạm vi đó.

Dùng thử

Thay thế bất kỳ nội dung nào trong ngoعل (angle brackets) bằng giá trị của riêng bạn và trình giữ chỗ key bằng một key từ trang tổng quan của bạn.

curl -X POST https://api.zinndigital.com/v1/connector/backup/claim \
  -H "Content-Type: application/json" \
  -d '{  }'

Đã đăng nhập? Bảng điều khiển API trong trang quản lý của bạn sẽ tự điền ID tổ chức thực tế và khóa của riêng bạn, sau đó chạy yêu cầu đối với API trực tiếp để bạn có thể xem phản hồi thực tế. Mở điểm cuối này trong bảng điều khiển API

Chi tiết

**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.

Nội dung yêu cầu

Tên	Loại	Bắt buộc	Nội dung này là gì
`site_url`	`string`	Không	The plugin's own view of the site address, for diagnostics only.

Phản hồi

Tên	Loại	Bắt buộc	Nội dung này là gì
`job_id`	`string`	Không	The backup row this upload settles.
`upload_url`	`string`	Không	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 e…

Các lỗi điểm cuối này có thể trả về

429

POST /v1/connector/backup/claim