平臺 知識圖譜 API 數據集 開發者 文檔 企業版 申請 API 訪問
首頁/文檔

API 文檔

在 MenuClaw 餐廳智能 API 上構建所需的一切——快速開始、身份認證、接口參考與更新日誌。

快速開始

三步開始

1 · 獲取密鑰

申請 API 訪問即可獲得沙盒密鑰。沙盒密鑰在樣例數據上擁有完整圖譜權限,且完全免費。

2 · 安裝 SDK

pip install menuclawnpm i menuclaw。也可以直接調用 REST API——提供完整 OpenAPI 規範。

3 · 發起首次調用

查詢餐廳、菜品或食材。多數開發者一天內即可上線。

quickstart.py
from menuclaw import MenuClaw

mc = MenuClaw(api_key="mc_sandbox_...")

# 查詢一家餐廳及其菜單
r = mc.restaurant.get("R-8841")
menu = mc.restaurant.menu(lat=r.lat, lon=r.lon)

print(r.name, "·", r.cuisine, "·", len(menu.items), "items")
身份認證

Bearer 令牌,簡單且安全

Authorization 請求頭中傳入密鑰。密鑰按環境(沙盒 / 生產)隔離,可無中斷輪換。

curl
curl https://api.menuclaw.com/v1/restaurant/R-8841 \
  -H "Authorization: Bearer mc_live_..." \
  -H "Content-Type: application/json"
接口參考

核心接口

方法接口說明
GET/v1/restaurant/{id}餐廳身份、菜系、營業時間、價格帶。
GET/v1/restaurant/menu帶欄目、菜品與規格的結構化菜單。
POST/v1/dish/search帶篩選與地理範圍的語義菜品搜索。
GET/v1/dish/{id}帶食材與標簽的規範化菜品。
GET/v1/dish/{id}/nutrition熱量、宏量與膳食屬性。
GET/v1/restaurant/intelligence衍生洞察:需求、價格指數、熱門菜品。
POST/v1/graph/traverse跨知識圖譜的路徑查詢。
POST/v1/webhooks注冊菜單變更與價格更新鉤子。

完整 schema、參數、錯誤碼與速率限制請參閱交互式參考。前往開發者平臺

更新日誌

最新更新

v1.4 · 圖譜遍歷 API

新增POST /v1/graph/traverse 支持多跳路徑查詢。新增 768 維圖譜向量快照。

v1.3 · 營養置信度評分

改進 — 每條營養事實現在都帶有置信區間與來源鏈路。

v1.2 · Webhook 正式發布

新增 — 菜單變更、價格更新與餐廳生命周期 Webhook,支持重試與回放。

v1.0 · 餐廳智能 API

正式發布 — 穩定、帶版本的基礎。提供沙盒與生產環境。

閱讀文檔,更快上線

申請 API 訪問,獲取集成的完整 OpenAPI 規範。