コンテンツにスキップ
スマレジ・プラットフォームAPI リファレンス

メニューの販売状態・残数一覧取得

GET
/menu_conditions/stores/{store_id}
curl --request GET \
  --url 'https://api.smaregi.dev/TARGET-CONTRACT-ID/waiter/menu_conditions/stores/1?menu_ids=1%2C2%2C3&type=all&category_id=1&updated_from=2023-10-01T00%3A00%3A00%2B09%3A00&limit=20&sort=menu_id&page=1' \
  --header 'Authorization: Bearer <token>'

店舗で取り扱うメニューの販売状態・残数一覧を取得します。

コースメニューは、コース区分が「標準コース」の場合のみ取得可能です。「簡易コース」はサポートしておりません。

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
store_id
required
string

店舗ID

Example
1

Query Parameters

Section titled “Query Parameters”
menu_ids
Array<string>
<= 100 items

メニューID
カンマ区切りで複数のパラメータを指定できます。

Example
?menu_ids=1,2,3
type
string
default: all
Allowed values: all normal plan course

[フィルタ]メニュー種別

  • all: 全て
  • normal: 単品
  • plan: プラン
  • course: コース
Example
all
category_id
string

カテゴリーID

Example
1
updated_from
string format: date-time

更新日時(RFC3339の日付形式)[YYYY-MM-DDThh:mm:ssTZD]
指定日時以降に販売状態・残数が更新されたメニューを取得します。

Example
2023-10-01T00:00:00+09:00
limit
integer
default: 20 >= 1 <= 100

取得件数

Example
20
sort
string
default: menu_id

ソート順

  • menu_id: メニューID
  • category_id: カテゴリーID
Example
menu_id
page
integer
default: 1 >= 1

ページ番号

Example
1

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
Array
MenuCondition
object
menuId

メニューID

string
condition

販売状態

  • orderable: 販売可
  • soldout: 売切
string
Allowed values: orderable soldout
quantity

残数

integer
nullable
Examples
Exampleレスポンス例
[
  {
    "menuId": "1",
    "condition": "orderable",
    "quantity": 5
  },
  {
    "menuId": "2",
    "condition": "orderable",
    "quantity": 10
  },
  {
    "menuId": "3",
    "condition": "soldout",
    "quantity": 0
  }
]

Headers

Section titled “Headers”
Link
string

<前のURI>; rel="prev", <次のURI>; rel="next"

403

Section titled “403”

店舗が休止中の場合

Media typeapplication/json
object
title
required
string
type
required
string
status
integer
detail
string
Examplegenerated
{
  "title": "example",
  "type": "example",
  "status": 1,
  "detail": "example"
}

404

Section titled “404”

指定した店舗が存在しない場合

Media typeapplication/json
object
title
required
string
type
required
string
status
integer
detail
string
Examplegenerated
{
  "title": "example",
  "type": "example",
  "status": 1,
  "detail": "example"
}