@crvouga/ mockingbird-service-rxvortex (英语)

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

国家模拟器 RxVortex( 任务) 测试套房的复合药用API: 客户端 - 证书符号、 命令提交、 状态、 取消、 发送者命令 id 的恢复查询, 预设目录 和签名状态 网络选择药店的帖子。 只移动命令 当测试这样说时(模拟器时钟上的管理过渡或自动推进路径),所以eRx 在真正的沙盒上等待60秒的套房 以毫秒的速度解决.

• 行动范围: 支助
• 供应商不公布具体内容:合同openapi.yaml)是从线上手写的 造就我们的消费者阅读和写作, 并且它依赖的每一个领域都得到服务.

安装

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

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

使用量

点 RXVORTEX_API_URL 在模拟者那里。 设定 RXVORTEX_WEBHOOK_SECRET 在应用程序中,通过同样的 值为 --webhook-secret。 。 。 .

npx mockingbird-rxvortex serve --port 8791 \
  --webhook-url http://127.0.0.1:3000/prescriptions/webhooks/rxvortex \
  --webhook-secret "$RXVORTEX_WEBHOOK_SECRET" \
  --auto-advance "2000:Fill,Shipping,Delivered" \
  --catalog ./preset-catalog.json

--catalog 将自己的预设目录加载到每个命名空间: JSON 数组行,或 {data: [...]} 机构 GET /api/v1/preset-catalog-items 答案,所以一个记录的沙盒 响应负载 。 仅 catalog_id 财务报告和审定财务报表 medication_name 需要这样做. POST /__admin/reset 返回这些行。 过 --unknown-presets accept 以任何好的预设身份代之.

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

// Test setup: a local RxVortex that posts its status webhooks to the app.
const server = await createServer({
  webhooks: { url: "http://127.0.0.1:3000/prescriptions/webhooks/rxvortex", secret: "whsec-test" },
})
const baseUrl = server.url // the app's RXVORTEX_API_URL
const post = (path: string, body: unknown, headers: Record<string, string> = {}) =>
  fetch(`${baseUrl}${path}`, {
    method: "POST",
    headers: { "content-type": "application/json", ...headers },
    body: JSON.stringify(body),
  })

// Application code: the requests it sends to RxVortex.
const { access_token } = (await (
  await post("/api/v1/generate-access-token", { client_id: "acme", client_secret: "s" })
).json()) as { access_token: string }
// …then POST /api/v1/orders with Authorization: Bearer <access_token> and sender_order_id "pay_123"…

// Test control: move that order the way the pharmacy would; each step emits the signed status webhook.
await post("/__admin/orders/pay_123/transition", { to: "Shipping", trackingnumber: "1Z999" })
await post("/__admin/orders/pay_123/transition", { to: "Delivered" })

await server.close()

路线

网络呼号

每个地位变动员额 {event: "order.status_updated", orderReferenceID, order_tracking_id, tracking_id, sender_order_id, rxstatus, orderstatus, shipping_status, delivered_date, trackingnumber, shippingcarrier, shippingservice, shipmenttrackingurl, updated_at} 有页眉 x-rxvortex-webhook-secret: <secret> (方言平等,作为我们的接受者检查). 非-2xx 答案 重新试验(即立即5分、5分、30分、2分). GET /__admin/webhooks 清单, GET /__admin/webhooks/events 载荷, POST /__admin/webhooks/flush 运行等待重试 现在,和 PUT /__admin/webhook-endpoints 每个名称空间接收器.

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}· ; GET /__admin/faults/presets: duplicate_sender_order_id, (中文(简体) ), created_but_500 (创造,然后500;恢复成功), numeric_tracking_id, (中文(简体) ), token_expired, (中文(简体) ), stale_error_with_delivered_date, (中文(简体) ), validation_errors_array, (中文(简体) ), validation_errors_object, (中文(简体) ), validation_errors_empty, (中文(简体) ), server_error, (中文(简体) ), webhook_duplicate, (中文(简体) ), webhook_reorder, (中文(简体) ), webhook_drop。 。 。 .

命名空间

我们的后端 fetch 无法添加信头,所以可以选择三个方式: x-mockingbird-namespace页:1 /__admin/ns/<name> 前缀在 RXVORTEX_API_URL,或客户端代码: PUT /__admin/credentials {"credentials": {"<RXVORTEX_CLIENT_ID>": "<namespace>"}} (手提箱携带) 他们的客户身份被签发.

故意不模拟

• 实际完成时间:除非 autoAdvance 已经设定.
• 患者和处方细节经过验证,从未存储或回放.
• 活目录:默认行被合成到活客户端的字段名中( 否) 沙盒记录存在). 装入已记录行 serve --catalog, (中文(简体) ), PUT /__admin/catalog, (中文(简体) ), 或 catalog 选项.
• 复置并多令发运.

API 密码

部分 嘲笑鸟。 。 。 .