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

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

状态模拟器 关卡外部 API (% 1)/externalapi对于测试套房:客户端登录, 形式定义GetForm)和保存的形式回合(SavePatientForm,表格提交 队列的调用、病人搜索和插入(账户回填)、状态、空位和 任用。 后端需要 careTalk 键在后端, 因此模拟器让一个堆起后端运行 没有β环境的CareTalk路径.

• 行动范围: 支助
• 供应商不公布具体内容:合同openapi.yaml由手写自 消费者的zod计划和接口(caretalk.types.ts, (中文(简体) ), caretalk-forms.type.ts) (中文(简体) ).

安装

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

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

使用量

点 CARETALK_API_URL 在模拟器上(后端验证为 仅限 https放松点 用于回路或使用 TLS 的模拟器前. getFormData 硬码 https://api.caretalkbeta.com (接缝) G-Y1级) (中文(简体) ). CARETALK_USERNAME, (中文(简体) ), CARETALK_PASSWORD 财务报告和审定财务报表 CARETALK_API_KEY 除非 --api-user 编号 : --api-key 钉住他们.

npx mockingbird-caretalk serve --port 8823 --api-user "$CARETALK_USERNAME:$CARETALK_PASSWORD" --api-key "$CARETALK_API_KEY"

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

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

// Application code: log in, then read a form with the token.
const login = await fetch(`${baseUrl}/externalapi/Auth/client-login`, {
  method: "POST",
  headers: { "content-type": "application/json" },
  // Any credentials log in unless --api-user pins them.
  body: JSON.stringify({ userName: "acme-api", password: crypto.randomUUID() }),
})
const { token } = (await login.json()) as { token: string }
const forms = await fetch(`${baseUrl}/externalapi/Forms/GetForm/health-history`, {
  headers: { authorization: `Bearer ${token}` },
})
const [form] = (await forms.json()) as { fullFormDto: { id: number } }[]

// Test control: after the app's form-submission queue runs, assert what reached CareTalk.
const saved = await fetch(`${baseUrl}/__admin/form-submissions`)
const { submissions } = (await saved.json()) as { submissions: unknown[] }
await server.close()

路线

未校正或已过期的电话是空的 401 与 WWW-Authenticate: Bearer (我们的客户端) 登录一次并重试。 校验错误为 ASP.NET 问题详情 {type, title, status, errors, traceId}。 。 。 .

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}: login_failure, (中文(简体) ), invalid_credentials, (中文(简体) ), token_expired (每项业务适用计数), server_error, (中文(简体) ), gateway_html, (中文(简体) ), form_not_found, (中文(简体) ), patient_not_found, (中文(简体) ), save_rejected, (中文(简体) ), connection_drop, (中文(简体) ), slow。 。 。 .

命名空间

x-mockingbird-namespace页:1 /__admin/ns/<name> 前缀在 CARETALK_API_URL符号 携带他们被发给的API用户,所以 PUT /__admin/credentials {"credentials": {"<CARETALK_USERNAME>": "<ns>", "<CARETALK_API_KEY>": "<ns>"}} 运行两种认证样式.

故意不模拟

• CareTalk在表格背后的临床工作流程(审查,工作人员创建的表格回合), 资格档案、保健大猩猩检索、药物和诊断.
• 真正的医生日历:槽被合成;时区被固定到山上.
• 活形式目录: DEFAULT_FORMS 以 CareTalk 形状合成(活平相) 脚本种子模拟器 从β环境的形态代替.

API 密码

部分 嘲笑鸟。 。 。 .