NewtのAPIで利用できるクエリパラメータを理解して、様々なクエリを実行する

質問:
「投稿」モデルと「カテゴリ」モデルを定義しています。
投稿モデルはカテゴリという参照フィールドを定義していて、参照先モデルに「カテゴリ」を指定しています。
特定のカテゴリを持つ投稿を取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
category=123abc
// SDKの場合
query: {
  category: '123abc'
}

質問:
「投稿」モデルと「タグ」モデルを定義しています。
投稿モデルはタグという複数値の参照フィールドを定義していて、参照先モデルに「タグ」を指定しています。
いずれかのタグを含む投稿を取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
tags[in]=123abc,456abc
// SDKの場合
query: {
  tags: {
    in: ['123abc', '456abc']
  }
}

// URLの場合
tags=123abc
// SDKの場合
query: {
  tags: '123abc'
}

質問:
「投稿」モデル・「著者」モデル・「部門」モデルを定義しています。
投稿モデルは著者という参照フィールドを定義していて、参照先モデルに「著者」を指定しています。
著者モデルは部門という参照フィールドを定義していて、参照先モデルに「部門」を指定しています。
投稿を取得した時に、著者の情報は表示されますが、部門の情報は_idのみしか返却されません。
部門の名前やその他の情報を取得できないですか？

// URLの場合
depth=2
// SDKの場合
query: {
  depth: 2
}

質問:
「投稿」モデルを定義していて、「body」というリッチテキストフィールドを定義しています。
一覧表示を行う時に、本文の抜粋を表示しようと考えているのですが、
HTML形式ではなく、プレーンなテキスト形式でbodyデータを取得する方法はありますか？

// URLの場合
body[fmt]=text
// SDKの場合
query: {
  body: {
    fmt: 'text'
  }
}

質問:
「投稿」モデルを定義していて、「description」というマークダウンフィールドを定義しています。
HTML形式ではなく、マークダウン形式のままdescriptionデータを取得する方法はありますか？

// URLの場合
description[fmt]=text
// SDKの場合
query: {
  description: {
    fmt: 'text'
  }
}

質問:
「投稿」モデルを定義しています。
2023年に公開された投稿を取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
_sys.createdAt[gte]=2023&_sys.createdAt[lt]=2024
// SDKの場合
query: {
  '_sys.createdAt': {
    gte: '2023',
    lt: '2024'
  }
}

質問:
「投稿」モデルを定義しています。
2023年3月に公開された投稿を取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
_sys.createdAt[gte]=2023-03&_sys.createdAt[lt]=2023-04
// SDKの場合
query: {
  '_sys.createdAt': {
    gte: '2023-03',
    lt: '2023-04'
  }
}

質問:
「イベント」モデルを定義していて、「date」という日付フィールドを定義しています。
2023年の日付が入力されているイベントを取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
date[gte]=2023&date[lt]=2024
// SDKの場合
query: {
  date: {
    gte: '2023',
    lt: '2024'
  }
}

質問:
「イベント」モデルを定義していて、「date」という日付フィールドを定義しています。
2023年3月の日付が入力されているイベントを取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
date[gte]=2023-03&date[lt]=2023-04
// SDKの場合
query: {
  date: {
    gte: '2023-03',
    lt: '2023-04'
  }
}

質問:
「イベント」モデルを定義していて、「date」という日付フィールドを定義しています。
現在の日時以前の日付が入力されているイベントを取得したいのですが、どのようなクエリを利用すればいいですか？

// URLの場合
date[lte]=2024-01-11T03:00:00.000Z
// SDKの場合
query: {
  date: {
    lte: new Date().toISOString()
  }
}

質問:
コンテンツの更新日に応じて、日付が新しいものから順番に表示したいです。
コンテンツを降順で取得する方法はありますか？

// URLの場合
order=-_sys.updatedAt
// SDKの場合
query: {
  order: ['-_sys.updatedAt']
}

質問:
管理画面でコンテンツを手動で並び替えました。
コンテンツを並び替えた順番の通りに取得する方法はありますか？

// URLの場合
order=-_sys.customOrder
// SDKの場合
query: {
  order: ['-_sys.customOrder']
}

質問:
「投稿」モデルを定義していて、「title」・「body」というフィールドを定義しています。
どちらかのフィールドに特定のキーワードを含むコンテンツを取得したいのですが、
どのようなクエリを利用すればいいですか？

// URLの場合
[or]=(title[match]=hoge;body[match]=hoge)
// SDKの場合
query: {
  or: [
    {
      title: {
        match: 'hoge'
      }
    },
    {
      body: {
        match: 'hoge'
      }
    },
  ],
}

質問:
ページネーションの実装を考えています。
例えば41番目のコンテンツから50番目のコンテンツまで取得する場合、
どのようなクエリを利用すればいいですか？

// URLの場合
skip=40&limit=10
// SDKの場合
query: {
  skip: 40,
  limit: 10
}

質問:
「投稿」モデルを定義しています。
記事詳細ページから次の記事に遷移することを考えているのですが、
あるコンテンツの次のコンテンツを取得する場合、
どのようなクエリを利用すればいいですか？

// URLの場合
_sys.createdAt[lt]=2023-04-06T00:18:26.810Z&order=-_sys.createdAt&limit=1
// SDKの場合
client.getFirstContent({
  （省略）
  query: {
    '_sys.createdAt': {
        lt: article._sys.createdAt, // articleは現在の記事の情報が入っているとする
    },
    order: ['-_sys.createdAt'],
  },
})

質問:
「投稿」モデルを定義しています。
記事詳細ページから前の記事に遷移することを考えているのですが、
あるコンテンツの前のコンテンツを取得する場合、
どのようなクエリを利用すればいいですか？

// URLの場合
_sys.createdAt[gt]=2023-04-06T00:18:26.810Z&order=_sys.createdAt&limit=1
// SDKの場合
client.getFirstContent({
  （省略）
  query: {
    '_sys.createdAt': {
        gt: article._sys.createdAt, // articleは現在の記事の情報が入っているとする
    },
    order: ['_sys.createdAt'],
  },
})

質問:
あるフィールドに値を設定していないコンテンツのみを取得したいです。
どのようなクエリを利用すればいいですか？

// URLの場合
field=
// SDKの場合
query: {
  field: '',
}

// URLの場合
field=0
// SDKの場合
query: {
  field: 0,
}

// URLの場合
field=false
// SDKの場合
query: {
  field: false,
}

// URLの場合
field[exists]=false
// SDKの場合
query: {
  field: {
    exists: false,
  }
}