hosting

POST /v1/sites/{siteId}/wordpress/search-replace

Rewrite a string throughout a site's WordPress database.

すべての hosting エンドポイント

すべての開発者向けドキュメント

認証

ベアラー トークンとして 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).

リクエスト本文

名前タイプ必須これがその内容です
searchstringはいThe string to find. Must not be blank: an empty search matches every row in the customer's database.
replacestringはい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