商品一覧の取得 (GET v1/products) をアップデートしました

2026/04/02

商品一覧の取得について、検索・ソート用のクエリパラメータを追加しました。

追加されたクエリパラメータ

パラメータ 説明
sales_price_min 整数 販売価格が指定した金額以上の商品を検索。0以上の整数のみ有効
sales_price_max 整数 販売価格が指定した金額以下の商品を検索。0以上の整数のみ有効
price_min 整数 定価が指定した金額以上の商品を検索。0以上の整数のみ有効
price_max 整数 定価が指定した金額以下の商品を検索。0以上の整数のみ有効
members_price_min 整数 会員価格が指定した金額以上の商品を検索。0以上の整数のみ有効
members_price_max 整数 会員価格が指定した金額以下の商品を検索。0以上の整数のみ有効
jan_code 文字列 JAN コードで完全一致検索
sort 文字列 商品の並び順を指定。カラム名の前に - を付けると降順、なしで昇順。カンマ区切りで複数指定可能。デフォルトは -make_date (作成日の降順)

sort パラメータで指定可能なカラム

カラム 説明
make_date 作成日
update_date 更新日
sales_price 販売価格
price 定価
members_price 会員価格

  • sort=sales_price — 販売価格の昇順
  • sort=-update_date — 更新日の降順
  • sort=-sales_price,make_date — 販売価格の降順 → 作成日の昇順

その他

  • recent_zero_stocks: true の説明について詳細にしました。

詳細は、以下ドキュメントを確認ください。