エンドポイント

Cloudflare Filters API操作を呼び出すには、エンドポイントをCloudflare APIベースURLに追加します：

https://api.cloudflare.com/client/v4/

認証手順については、Cloudflare APIドキュメントのはじめに: リクエストを参照してください。

エンドポイントとページネーションに関するヘルプについては、はじめに: エンドポイントを参照してください。

ノート

Filters APIエンドポイントには、<ZONE_ID>の値が必要です。

アカウントに関連付けられたゾーンのリストを取得するには、ゾーンのリスト操作を使用し、フィルターを管理したいドメインに関連付けられたゾーンIDをメモしてください。

Cloudflare Filters APIは、以下に示す操作をサポートしています。このセクションのページを訪れて、例を確認してください。

操作	メソッド & エンドポイント	ノート
フィルターの作成	POST zones/<ZONE_ID>/filters	単一のトランザクションとして処理されます。エラーが発生した場合、全体の操作が失敗します。
フィルターの取得	GET zones/<ZONE_ID>/filters	現在のすべてのフィルターをリストします。結果はデフォルトでページごとに25アイテムでページネーションされて返されます。オプションのパラメータを使用して結果を絞り込むことができます。
フィルターの取得	GET zones/<ZONE_ID>/filters/<FILTER_ID>	IDによって単一のフィルターを取得します。
フィルターの更新	PUT zones/<ZONE_ID>/filters	単一のトランザクションとして処理されます。操作が成功するためには、すべてのフィルターが存在する必要があります。エラーが発生した場合、全体の操作が失敗します。
フィルターの更新	PUT zones/<ZONE_ID>/filters/<FILTER_ID>	IDによって単一のフィルターを更新します。
フィルターの削除	DELETE zones/<ZONE_ID>/filters	既存のフィルターを削除します。フィルターIDのリストを指定する必要があります。 空のリクエストは削除を行いません。指定されたフィルターが存在しない場合、HTTPステータスコード200を返します。
フィルターの削除	DELETE zones/<ZONE_ID>/filters/<FILTER_ID>	IDによってフィルターを削除します。