@crvouga/mockingbird-service-edamm (中文(简体) )

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

国家模拟器 爱德玛 API 我们的应用程序呼叫, 从内置食物和食谱回答 体格:食物数据库v2分解器(文字和刚果爱国者联盟)、营养和图像识别、营养 分析(nutrition-data, (中文(简体) ), nutrition-details), Recipe Search v2(使用过滤器和 _cont 呼叫,由URI,由id, 餐饮计划员v1 select,和购物列表 v2. 营养 记录、条码扫描、照片记录、食谱搜索、膳食计划和杂货清单,然后进入 测试没有 Edamam 键、配额或网络.

• 行动范围: 支助
• 合同openapi.yaml由Edamam的 API Docs和我们的消费者亲笔撰写: metrics/adapters/outbound/edamam-nutrition.adapter.ts, (中文(简体) ), meal-planning/adapters/outbound/edamam-meal-planning.adapter.ts,和 Python 聊天 服务 tools/nutrition/client.py。 。 。 .

安装

npm install -D @crvouga/mockingbird-service-edamam

仅限无害环境管理。 节点 22或 Bun 1.2. 无土生属地. 给它服务 npx mockingbird-edamam serve, (中文(简体) ), createServer 从 ./server (节点),或 createRuntime 与 任何获取服务器.

使用量

两个后端适配器硬码 https://api.edamam.com (封口:用于 EDAMAM_BASE_URL 编号 : EDAMAM_MEAL_BASE_URL还有Python客户端 EDAMAM_BASE_URL) (中文(简体) ). 钥匙可以是 任何数值 (EDAMAM_FOOD_APP_ID/KEY 或者说 EDAMAM_APP_ID/KEY, (中文(简体) ), EDAMAM_MEAL_APP_ID/KEY,Python语 客户端 edamam_* 设置);没有它们,我们的适配器报告 unavailable 永远不要叫出来.

npx mockingbird-edamam serve --port 8824

import { createServer } from "@crvouga/mockingbird-service-edamam/server"

// Test setup: the emulator. The application gets EDAMAM_BASE_URL = server.url.
const server = await createServer()
const baseUrl = server.url

// Application code: the Food Database request it sends to api.edamam.com.
const query = new URLSearchParams({
  app_id: "a",
  app_key: "k",
  ingr: "2 large eggs",
  "nutrition-type": "logging",
})
const response = await fetch(`${baseUrl}/api/food-database/v2/parser?${query}`)
const parsed = await response.json()
// → {text, parsed: [{food: {foodId: "food_egg", label: "Egg", nutrients: {ENERC_KCAL: 143, …}},
//     quantity: 2, measure: {uri: "…#Measure_large", label: "Large", weight: 50}}], hints: […]}
await server.close()

路线

每个电话都要接 app_id 财务报告和审定财务报表 app_key 作为查询参数(餐具和购物列表) 还接受 Authorization: Basic app_id:app_key我们的适配器发送.

错误:食物数据库和营养分析答案 {status: "error", error, message}· ; 食谱搜索、餐饮规划和购物清单答案 [{errorCode, message, params}]。 。 。 .

企业 (单位:千美元)DEFAULT_FOODS, (中文(简体) ), DEFAULT_RECIPES:每100克养分和计量量的18种食物 (包括一顿饭,与刚果爱国者联盟的两件包装产品) 850000000012 财务报告和审定财务报表 850000000036一个 刚果爱国者联盟 850000000029 没有营养数据)和8个食谱 从它们,所以食谱总数, 每个服务价值和购物清单与食品数据库一致.

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}: rate_limited (429个), payment_required (402), (中文(简体) ), unauthorized (401个), server_error (500个), parser_schema_drift, (中文(简体) ), recipe_quality (555), (中文(简体) ), vision_not_found, (中文(简体) ), meal_plan_incomplete, (中文(简体) ), meal_plan_timeout, (中文(简体) ), slow (12s,过去10秒), connection_drop。 。 。 .

命名空间

x-mockingbird-namespace页:1 /__admin/ns/<name> 基准 URL 前缀( 营养适配器的工作) 和连接路径的 Python 客户端; 适餐器用 new URL(endpoint, base),将前缀删除,或者通过应用程序 id: PUT /__admin/credentials {"credentials": {"<app_id>": "<namespace>"}}。 。 。 .

故意不模拟

• Edamam的NLP和数据库:解析器理解领先数量、已知计量和 食品名称;真实的食物和食谱内容需要记录.
• 解析器 nutrients[CODE] 是一个 最好猜,不是甲骨文验证 (供应商只说 食物数据库可以"通过给定的营养量来搜索食物";查询语法, a的错误 变形范围以及任何计划限制都从未被观察到现场直播). 模拟器读取 nutrients[PROCNT]=20+, (中文(简体) ), =5 (最多)和 =5-15 (包括)像 calories,反对 每100克粮食 nutrients,还有生的 + 解码到一个空间 仍然意味着"或更多". 几个代码,一个重复代码和 health 编号 : calories 编号 : category 编号 : categoryLabel 所有人必须 抓取; 无匹配 200 与 hints: [] 财务报告和审定财务报表 parsed: []。无价值的食物 代码不匹配 。 任何像养分代码形状的代码都被接受,但内置体 只携带 ENERC_KCAL, (中文(简体) ), PROCNT, (中文(简体) ), FAT, (中文(简体) ), CHOCDF, (中文(简体) ), FIBTG 财务报告和审定财务报表 SUGAR,因此代码,例如 NA 或者说 FE 只匹配种子食物 POST /__admin/foods 载人而行者, 而不是供应商的答复)。 区域或代码不正确 400 bad_request编辑 upc 搜索忽略 过滤器( 用于) calories。 。 。 .
• 食品数据库自动完成、品牌搜索和 nutrients 修饰符; Recipe 搜索用户 食谱(type=user, (中文(简体) ), field= 投影和除URL以外的图像.
• 餐饮计划 fit 除了日间卡片检查, mark 重量,筑巢 子节,以及购物卡的取出页面.

API 密码

部分 嘲笑鸟。 。 。 .