hosting
POST /v1/connector/backup/claim
Ask whether a backup is due — called by the Zinn® WordPress connector plugin.
認証
このエンドポイントは公開されています。認証情報や組織情報は不要で、当社のマーケティングサイトやAI回答エンジンが読み取っているものと同じです。
このエンドポイントは組織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 e… |
このエンドポイントが返すエラー
429