hosting
POST /v1/sites/{siteId}/wordpress/search-replace
Rewrite a string throughout a site's WordPress database.
認証
ベアラー トークンとして API キーを送信します。キーには sites.view 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/wordpress/search-replace \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "search": <string>, "replace": <string> }'ログインしていますか?ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
⛔ Destructive and irreversible from this platform. It rewrites every occurrence in the site's database, including inside serialised values, and this platform holds no copy of what was there before. the platform returns no body, so a refusal cannot be detected after the fact — every protection is in front of the call: the package must carry wp_search_replace, WordPress must be installed, and search must not be blank (an empty search rewrites every row in the database, and it is refused twice — at the field and again before the vendor call). The client is required to take a typed confirmation naming the site. 202 and no body, because the rewrite continues at the vendor after the acknowledgement. 404 for a site with no vendor hosting package. Requires sites.view and sites.panel_access.
パラメータ
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
siteId (path) | Uuid | はい | Site ID (UUIDv7). |
リクエスト本文
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
search | string | はい | The string to find. Must not be blank: an empty search matches every row in the customer's database. |
replace | string | はい | What to put in its place. May be empty — deleting a string throughout the database is a legitimate migration step. |
このエンドポイントが返すエラー
401 · 403 · 404 · 409 · 422 · 429 · 503