无限类型SDK
为Afffinity API,为Node.js 20+,Bun,AWS Lambda等获取运行时间的服务器端客户端打出. 它搭载一个ES模块和一个共同JS的建造,所以 import 财务报告和审定财务报表 require() 两者都行 它针对API版本 2026-11-01 送进去 Affinity-Version 每一个请求.
安装
bun add @affinity-health/sdk
Npm 时,使用 npm install @affinity-health/sdk。 。 。 .
使用
在服务器上保留 API 密钥 。 从不将它们放入浏览器捆绑,移动应用程序或公共环境变量.
import { AffinityClient } from "@affinity-health/sdk";
const affinity = new AffinityClient({ token: process.env.AFFINITY_API_KEY! });
const account = await affinity.account.get();
if (account.mode !== "test") throw new Error("Use a Test key for this example");
for await (const medication of await affinity.medications.list())
console.log(medication.name, medication.pharmacy.name);
密钥设置了组织和测试或活模式. 测试订单到测试药店.
- 写作需要
idempotencyKey。 。 。 . 在第一次请求前用被审查的订单保存,再利用它进行再试. 客户端的自动回盘(2个默认,为408个,429个和5xx)再用. - 列出每一页的斜体.
for await阅读下页;page.data是一页. - 错误已输入 .
Affinity.UnprocessableEntityError携带issues每个拒绝字段的名称。 每个错误都会延伸AffinityError与statusCode, (中文(简体) ),body财务报告和审定财务报表requestId。 。 。 . - 网友验证.
verifyAffinityWebhook检查Affinity-Signature(原始内容存档于2018-09-21) (中文(中国大陆) ). official website.
读取 SDK 指南 命令、公正无私、放任、错误和网络攻击 API 参考 对于每一种方法。 这个 快速启动 读取 测试数据 EMR 实例 发送经临床医生审查的命令,并接收其网页.
构建和验证
费恩 生成 src/generated 从 spec/affinity.openapi.json,Afffinity API合同;它在当地运行于多克,没有Fern账户. Webhook 校验在 src/webhook-events.ts 由手书写.
bun install --frozen-lockfile
bun run generate # regenerate after the contract changes (needs Docker)
bun run check # build, regenerate-and-compare, types, tests, package and examples
AFFINITY_API_KEY=sk_test_... bun run smoke # every operation against a real API, Test mode only
bun run smoke 对照合同检查每个答复。 它创建了"测试"练习和"测试"命令并取消该命令. 设定 AFFINITY_BASE_URL 呼叫另一个API,以及 AFFINITY_SMOKE_WEBHOOK_URL 以包含 webhook 端点.