メインコンテンツまでスキップ

Strapi のインタラクティブツールでクエリ URL を組み立てる

REST API では多くのパラメータを組み合わせられるため、クエリ URL が長く複雑になりがちです。

Strapi のコードベースでは `qs` ライブラリ でネストした JavaScript オブジェクトをパース・文字列化しています。複雑なクエリ URL は手入力より qs で生成することを推奨します。

次のインタラクティブなクエリビルダーで URL を自動生成できます。

  1. 用途に合わせて EndpointEndpoint Query Parameters の値を書き換えます。
  2. Copy to clipboard をクリックし、入力に応じて更新される Query String URL をコピーします。
パラメータの使い方

REST API のパラメータ一覧 と、各パラメータのドキュメントを参照すると理解しやすくなります。


{
sort: ['title:asc'],
filters: {
  title: {
    $eq: 'hello',
  },
},
populate: {
  author: {
    fields: ['firstName', 'lastName']
  }
},
fields: ['title'],
pagination: {
  pageSize: 10,
  page: 1,
},
status: 'published',
locale: ['en'],
}


Note

既定のエンドポイントパスは /api/ で始まり、API 設定の rest.prefix で変更していない限りそのままにしてください。
例: 既定の API プレフィックスで books コレクションタイプをクエリする場合、Endpoint/api/books と入力します。

免責

このページの qs とインタラクティブクエリビルダーは次の限界があります。

  • 構文エラーをすべて検出できるわけではない
  • プロジェクトで使えるパラメータや値を知らない
  • オートコンプリートはない

現状は、JavaScript オブジェクトをインラインのクエリ文字列 URL に変換するための補助です。生成した URL が必ずしも API で期待どおりの結果を返すとは限りません。