---
title: "Cliniko API 密钥：在哪里找到，以及如何创建｜Hanah"
description: "在 Cliniko 中，打开 My info（我的信息），然后选择 Manage API keys（管理 API 密钥）和 Add an API key（添加 API 密钥）。以下是每一步，以及粘贴密钥后 Hanah 会用它做什么。"
source: https://hanah.health/zh/blog/cliniko-api-key-setup/
---

1.  [首页](https://hanah.health/zh/)
2.  [博客](https://hanah.health/zh/blog/)
3.  设置 Cliniko API 密钥

产品更新

# 设置 Cliniko API 密钥

作者：[Ahmed](https://hanah.health/zh/blog/authors/ahmed/) · 阅读约 6 分钟  
发布于 2026年7月26日 · 更新于 2026年10月15日

## 要点

-   在 Cliniko 的 My info（我的信息）→ Manage API keys（管理 API 密钥）中创建密钥，然后粘贴到 Hanah 的 Cliniko 连接设置中。
-   API 连接会把您的 Cliniko 日程带入 Hanah，并支持将完成的病历归档回病历档案。
-   浏览器扩展在 Cliniko 页面上增加录音和起草功能，无需 API 密钥即可使用。
-   API 连接和浏览器扩展服务于工作流程的不同环节；请测试您需要的组合。

Hanah 是 [Cliniko 官方连接应用](https://www.cliniko.com/connected-apps/hanah-health/)。将 Hanah 与 [Cliniko](https://www.cliniko.com/) 结合使用有两种方式，而且可以叠加使用。

-   **API 密钥**：只需粘贴一次，Hanah 就能读取您的预约，并将完成的病历归档回正确的病历档案。
-   **浏览器集成**：一个扩展程序，把 Hanah 放到您已打开的 Cliniko 页面上，让您无需离开当前患者页面就能录音和起草。无需密钥。

本文先介绍密钥，因为它需要一步复制粘贴。然后我们会添加扩展，看看它在 Cliniko 中如何运行。如果您更想看而不是读，下面的演示视频完整展示了整个流程。

 

从头到尾将 Hanah 连接到 Cliniko。

## 第 1 步：在 Cliniko 中创建密钥

在 Cliniko 中，从左侧菜单底部打开 **My info**（我的信息），滚动到 **API keys**（API 密钥），选择 **Manage API keys**（管理 API 密钥）→ **Add an API key**（添加 API 密钥）。也可以直接前往：`https://your-practice.cliniko.com/user/api-keys/new`。

给它起一个您以后认得出的名字。“Hanah”就可以。

![Cliniko 的 New API key 页面，名称字段填写为 Hanah，下方是 Create API key 按钮。](https://hanah.health/assets/cliniko-key-new.png)

Cliniko 自己的说明值得一读：每个应用使用一个密钥，并像对待密码一样对待密钥。

点击 **Create API key**（创建 API 密钥）。Cliniko 只会显示这个密钥_一次_：现在就复制，在下一步粘贴到 Hanah 中，之后无需在其他任何地方保留副本。如果丢失了也没关系：归档这个密钥，再创建一个新的即可。

创建之前，有两点值得了解。密钥拥有与_您本人_相同的 Cliniko 数据访问权限，因此密钥是按个人而非按诊所发放的：每位临床医生都用自己的账户登录并创建自己的密钥。另外，由于这个密钥是为单一应用命名的，以后您可以把它归档，而不影响您连接的其他任何应用。

## 第 2 步：粘贴到 Hanah 中

在 Hanah 中，从左侧导航打开**「集成」**。您会看到两个部分：浏览器集成（即第 3 步）和 API 集成。

![Hanah 的「集成」页面，显示带有 Cliniko 和 Halaxy 卡片的「浏览器集成」部分，以及带有标记为「已连接」的 Cliniko 卡片的「API 集成」部分。](https://hanah.health/assets/cliniko-key-integrations.png)

Hanah 中的「集成」页面。浏览器集成和 API 连接相互独立，您可以只用其中一个，也可以两个都用。（安装按钮会显示您当前使用的浏览器名称。）

点击**「API 集成」**下的 Cliniko 卡片，把密钥粘贴到**「API 密钥」**字段中。您输入时，Hanah 会向 Cliniko 验证，并显示该密钥所属的从业者，让您在保存之前就能确认它连接到了正确的账户。

![Hanah 的 Cliniko 连接对话框，包含临床医生、API 密钥和诊所 Cliniko URL 三个字段。](https://hanah.health/assets/cliniko-key-dialog.png)

连接对话框。诊所管理员会在顶部看到一个临床医生选择器，可以代同事连接其密钥。

第二个字段 **Cliniko URL** 不属于密钥的一部分：粘贴您 Cliniko 账户中的任意地址（`https://your-practice.au5.cliniko.com`），Hanah 会用它把患者引导到您的预约页面。Cliniko 的 API 不提供这个地址，所以我们需要您填写。

保存后，卡片会显示**「已连接」**。设置就此完成。

## 连接实际上做了什么

-   **日程同步过来。**预约和患者会出现在 Hanah 中，您无需重新输入姓名，就能为正确的患者开始就诊。
-   **病历回到正确的病历档案。**完成的病历会与其来源的 Cliniko 患者和预约相匹配。
-   **不会自动归档。**每份病历在临床医生审阅并确认之前都只是草稿。

在安全方面：密钥存储在服务器端，从不发送到您的浏览器。它的权限范围限于签发它的临床医生，因此病历会归属于正确的从业者。您可以随时在 Cliniko 中归档该密钥来撤销它：它会立即失效，您连接的其他任何应用都不受影响。

## 第 3 步：在 Cliniko 中查看运行效果

API 密钥连接两个系统。浏览器集成则让 Hanah 在您工作时就出现在眼前。

在同一个「集成」页面添加：**「浏览器集成」**下的 Cliniko 卡片会在 Chrome 网上应用店中打开 [Hanah 扩展](https://chromewebstore.google.com/detail/hanah/fofjdnhjkbdkecpiakbcaiflejapbpep)。安装后登录一次 Hanah，然后在 Cliniko 中打开任意患者。

![Cliniko 的新建治疗记录页面。Hanah 草稿标签和「就诊」按钮位于 Cliniko 自带的模板和预约选择器旁边，右侧打开的 Hanah 面板显示「录音」按钮和本次就诊的背景信息。](https://hanah.health/assets/cliniko-note-pill.png)

Cliniko 自己的病历表单，Hanah 固定在模板选择器旁边，录音面板在右侧打开。这里没有任何 Hanah 界面，这是您的诊所管理系统，只是 Hanah 嵌入其中。

会出现两样东西，都在 Cliniko 自己的页面上：

-   **右下角的「就诊」按钮。**在您已打开的患者页面上直接为诊疗录音。转录稿会在一个小面板中逐步生成，您可以看，也可以不管它。
-   **病历表单上的草稿标签。**打开一份新的治疗记录，Hanah 就出现在 Cliniko 的模板选择器旁边。选择就诊、生成、审阅草稿，它就会填入病历自身的各个部分：即您的模板定义的部分，而不是一整块通用文本。

扩展在您的浏览器中运行，就在您已经打开、并且本来就有权查看的页面上。它不需要 API 密钥，也不接触 Cliniko 的服务器，所以即使您还没完成第 1 步和第 2 步，它也能工作；它也因此能在完全不提供 API 的诊所管理系统上使用。

## 您需要哪一种？

大多数诊所两者都需要，它们分工不同：

|  | 浏览器集成 | API 密钥 |
| --- | --- | --- |
| 设置 | 安装扩展并登录 | 创建密钥，粘贴一次 |
| 在患者页面上录音 | 是 | — |
| 填写诊所管理系统的病历模板 | 是 | — |
| 在 Hanah 中查看 Cliniko 日程 | — | 是 |
| 从 Hanah 将病历归档到病历档案 | — | 是 |

如果您只在 Cliniko 中工作，单用扩展就已经很完整。如果您还希望在 Hanah 中看到当天的日程，并从 Hanah 归档病历，那就再加上密钥。

在某一步卡住了，或者您使用的系统我们还没有列出？[预约演示](https://hanah.health/zh/#demo)，我们会和您一起完成设置。

## 常见问题

**使用浏览器扩展需要 API 密钥吗？**

不需要。扩展无需密钥即可支持在 Cliniko 页面上录音和起草。API 连接则支持 Hanah 内另外的日程和归档流程。

**在哪里创建 Cliniko 密钥？**

在 Cliniko 中，打开 My info（我的信息），然后选择 Manage API keys（管理 API 密钥）和 Add an API key（添加 API 密钥）。把生成的密钥粘贴到 Hanah 的 Cliniko 连接设置中。

**为什么要同时使用 API 和扩展？**

扩展让录音和起草就在患者页面旁边进行。API 连接把日程带入 Hanah，并支持从 Hanah 归档完成的病历。

## 本文引用的来源

-   [Cliniko 官方连接应用](https://www.cliniko.com/connected-apps/hanah-health/) —— cliniko.com
-   [Cliniko](https://www.cliniko.com/) —— cliniko.com
-   [Hanah 扩展](https://chromewebstore.google.com/detail/hanah/fofjdnhjkbdkecpiakbcaiflejapbpep) —— chromewebstore.google.com

## 关于作者

[Ahmed](https://hanah.health/zh/blog/authors/ahmed/) · Hanah 联合创始人兼 CEO

Ahmed 是 Hanah 的联合创始人兼 CEO。他的背景横跨游戏开发、体育数据分析、金融科技和 AI，曾任职于 Electronic Arts、Catapult Sports 和 Commonwealth Bank，经营过一家独立游戏工作室，并担任治理、风险与合规公司 sixclicks 的 AI 负责人。他将在游戏中设计参与和留存机制的经验，用于打造反馈闭环，帮助患者持续参与自身诊疗，朝着积极的健康结果努力。[查看文章](https://hanah.health/zh/blog/authors/ahmed/)。

**更新说明：**新增了结构化摘要和发布元数据。本次更新不改变文中所述的来源核查或基准测试日期。

[我们如何撰写、引用来源和审核文章](https://hanah.health/zh/blog/editorial-policy/)

## 相关阅读

-   [了解病情的患者才会积极参与](https://hanah.health/zh/blog/inline-health-literacy/)
    
    一份准确但患者看不懂的病历，只完成了一半。内嵌健康素养说明会把每份就诊总结中的专业术语变成可点按的通俗解释，同时不削弱临床病历的内容，因为理解自身诊疗的患者，才会坚持下去。
    
-   [为什么 AI 病历助手不应止步于病历](https://hanah.health/zh/blog/scribe-that-stays/)
    
    大多数 AI 病历助手止步于病历。我们认为，更有价值的工作是诊疗结束后发生的一切，而 AI 病历助手也应该承担这些工作。
    
-   [新功能：文档生成支持使用自有模板](https://hanah.health/zh/blog/byo-template-docgen/)
    
    上传您现有的 PDF 或 Word 表格，Hanah 会直接根据诊疗内容填写：保险表格、转诊信、带您自己信头的信函，供您审阅。
    

在您自己的诊所中体验 Hanah。

[预约演示](https://hanah.health/zh/#demo)