Lists API は、次の種類のリストをプログラムから管理するためのインターフェースです。
-
カスタムリスト：同じ種類の文字列（IP アドレスやホスト名など）を 1 つ以上含み、ルール式から名前でまとめて参照できます。
-
Bulk Redirect Lists：URL リダイレクトを含み、Bulk Redirect Rule を作成して有効にします。
ルール式でリストを使う方法は、Rules 言語のドキュメントの Lists を参照してください。
まずは Lists の JSON オブジェクト と エンドポイント を確認してください。
カスタムリストおよび Bulk Redirect Lists のリスト項目を作成、変更、削除する API リクエストには、Cloudflare がレート制限を適用することがあります。
リスト項目に対する各操作（作成、編集、削除）は、1 件の変更として数えます。次の制限が適用されます。
- 12 時間あたり、API リクエストによるリスト項目の変更は最大 1,000,000 件です。
- リスト項目を変更する API リクエストは、12 時間あたり最大 30,000 件です。
書き込み操作は非同期で処理されます。処理中に新しいリクエストを送ると、429 HTTP ステータスコードが返ります。この場合は、あとでもう一度リクエストしてください。