二郎系ラーメン注文API仕様書

概要

本記事はPerplexityで作成しました。

このAPIは、二郎系ラーメン店での注文プロセスをシミュレートします。

エンドポイント

POST /order/jiro-ramen

リクエストボディ

{
  "size": string,
  "noodles": {
    "amount": string,
    "firmness": string
  },
  "toppings": {
    "garlic": string,
    "vegetables": string,
    "oil": string,
    "sauce": string
  },
  "extras": [string]
}

パラメータ

パラメータ型必須説明
sizestringはいラーメンのサイズ（”小”, “大”）
noodlesobjectはい麺に関する設定
toppingsobjectいいえ無料トッピングの設定
extrasarrayいいえ有料トッピングの配列

麺の設定（noodles）

パラメータ型必須説明
amountstringいいえ麺の量（”普通”, “少なめ”, “半分”）
firmnessstringいいえ麺の硬さ（”普通”, “硬め”, “柔らかめ”）

無料トッピング（toppings）

パラメータ型必須説明
garlicstringいいえニンニクの量（”なし”, “普通”, “マシ”, “マシマシ”）
vegetablesstringいいえ野菜の量（”普通”, “マシ”, “マシマシ”, “少なめ”）
oilstringいいえ脂の量（”普通”, “マシ”, “マシマシ”, “少なめ”）
saucestringいいえタレの量（”普通”, “マシ”, “マシマシ”）

レスポンス

成功時のレスポンス (200 OK)

{
  "orderId": string,
  "status": "success",
  "message": "注文が完了しました"
}

エラーレスポンス (400 Bad Request)

{
  "status": "error",
  "message": "無効なリクエストです"
}

使用例

リクエスト

{
  "size": "小",
  "noodles": {
    "amount": "普通",
    "firmness": "普通"
  },
  "toppings": {
    "garlic": "マシ",
    "vegetables": "マシマシ",
    "oil": "普通",
    "sauce": "普通"
  },
  "extras": ["チーズ"]
}

レスポンス

{
  "orderId": "JR12345",
  "status": "success",
  "message": "小ラーメン（ニンニクマシ、ヤサイマシマシ、チーズトッピング）の注文が完了しました"
}

注意事項

  • 食べきれる量を注文し、残すことは避けてください。
  • 店舗によって利用可能なオプションが異なる場合があります。
  • 初めての方は「そのまま」と伝えることで、デフォルトの味を楽しむことができます。
  • コールの際は、はっきりと大きな声で注文してください。

Citations:
[1] https://ramen-laboratory.com/ramenjiroutanomikata/
[2] https://www.myojousa.com/ja/blog/unique-ways-to-order-ramen/
[3] https://news.mynavi.jp/article/20230822-2714674/
[4] https://www.onemile.jp/magazine/ra-menzirou/
[5] https://note.com/toyotamasan/n/nef39fb8e36e0
[6] https://ameblo.jp/hanara-men/entry-12731653414.html