用途：Vantage 用于管理血液检测和 DNA 诊断产品，处理订单并把检测结果交付给用户，让医疗提供方、实验室和合作伙伴把诊断检测嵌入自有应用，由 Terra 承担试剂盒供应商对接（无最低起订量）、物流运输、合规和结果标准化为 FHIR 的工作。目前在英国和美国可用，德国、西班牙、法国标注为即将推出；开通为人工审核，需联系 Terra 启用凭据，先沙箱后生产。
主要能力：三级产品目录（产品类型→产品→变体），下单后返回 order_id、recipient_id 和每项 order_item_id；支持 AT_HOME（寄送试剂盒自采样，用 shipping_address）和 GO_TO_LAB（实验室采样，用 requested_lab_address，可用 GET /api/v1/labs?zip_code= 查询附近采样点）；部分供应商要求用户自行激活试剂盒，激活后通过 results.kit_activated webhook 返回 test_taker_id；结果以 FHIR 格式提供预签名下载链接；通过 webhook 推送订单与结果状态变化，使用 HMAC-SHA256 的 X-Terra-Signature 签名，至少一次投递需按 event_id 去重。
使用方式：认证使用 Terra 的 dev-id 与 API key，可用 HTTP Basic（Authorization: Basic base64(DEV_ID:API_KEY)）或 dev-id + x-api-key 头。生产基址 https://vantage.tryterra.co，沙箱 https://vantage-sandbox.tryterra.co，路径均在 /api/v1 下。典型流程：查目录→POST /api/v1/orders 下单→接收 webhook→GET /api/v1/results/{order_item_id}?test_taker_id= 获取结果→POST /api/v1/results/{order_item_id}/acknowledge?test_taker_id= 确认结果。可用 CLI 获取凭据与设置 API 版本：terra environments retrieve-api-key --env <dev-id>、terra vantage api-version retrieve --env <dev-id>；CLI 安装命令为 curl -fsSL https://cli.tryterra.co/install.sh | sh（macOS/Linux）或 irm "https://cli.tryterra.co/install.ps1" | iex（Windows PowerShell）。聊天助手环境可用 Terra API admin MCP server。
限制：结果确认是强制且必须由终端用户显式触发，未确认会导致责任转移给集成方，供应商也可能直接联系患者；预签名结果 URL 15 分钟过期；创建订单建议带 Idempotency-Key，否则无服务端去重；ID 为字符串形式的 64 位雪花值，不可当数字解析；签名时间戳为 Unix 秒；沙箱与生产 webhook URL 独立；simulate 端点在 403 生产不可用。具体版本变更、webhook 载荷与错误码需查阅官方文档。