要生成 Papo（https://papo.global/）的 API 密钥，请访问控制面板并前往 设置 > 开发者（或 API）。在那里，您可以找到固定的公钥，并可以创建命名的密钥；这些密钥仅显示一次，必须存储在安全位置，例如密码管理器或服务器上的环境变量中。
Papo API 使用一对密钥来在集成中识别和验证您的账户，这些集成包括 CRM、ERP、自动化平台（n8n、Zapier）和自有系统。理解它们之间的区别，并知道如何生成和保护它们，是构建可靠自动化的第一步。
| 密钥类型 | 格式 | 功能 | 暴露级别 |
|---|---|---|---|
| 公钥 | pk_live_... |
唯一标识您的 Papo 账户。 | 可以暴露在前端或公共脚本中。 |
| 密钥 | sk_live_... |
验证请求并授权对您账户执行操作。 | 机密 – 绝不应共享或提交到代码版本控制中。 |
如何生成 API 密钥
- 登录 Papo 控制面板并前往 设置。
- 在侧边栏菜单中，找到 开发者 或 API 部分。
- 页面将显示您的 公钥（
pk_live_...）。它是固定的，可以随时复制。 - 要获取 密钥，请点击创建新密钥的按钮。
- 为其设置一个描述性名称（例如：“CRM 集成”、“n8n 自动化”），以便将来管理。
- 密钥（
sk_live_...）将仅显示一次。请立即复制，并将其保存在安全位置。
⚠️ 出于安全考虑，Papo 仅存储密钥的哈希值。如果您丢失原始值，将无法恢复。在这种情况下，请撤销已泄露的密钥并生成新密钥。
如何安全存储密钥
- 切勿将密钥直接放入源代码、Git 仓库或消息中。
- 在服务器上使用环境变量（例如：
PAPO_SECRET_KEY），并在代码中引用它们。 - 将密钥存储在密码管理器中（如 1Password、Bitwarden 或您的云服务提供商保险库），以便日后查阅。
- 如果密钥泄露或怀疑已泄露，请前往同一开发者页面，在列表中找到该密钥并立即撤销。然后创建新密钥并更新您的集成。
这些密钥有什么用途？
这些密钥用于所有需要身份验证的 Papo API 调用。密钥在 Authorization 标头中作为 Bearer token 发送。公钥可以在 X-Papo-Public-Key 标头中作为额外验证发送，但主要身份验证始终依赖于密钥。
有了这些密钥，您可以例如：
- 通过 API 发送 WhatsApp 消息。
- 查询由 Extrator 提取的联系人。
- 从您的系统触发 Papo 的人工智能。
- 将数据与您的 CRM 或 ERP 同步。
常见问题
在哪里可以找到我账户的公钥？
公钥（pk_live_...）显示在 设置 > 开发者（或 API） 页面。它是固定的，可以随时复制。
我可以有多个密钥吗？
可以。您可以生成多个密钥，每个使用不同名称（例如：“生产”、“测试”、“n8n”）。这有助于隔离访问权限，并在不影响其他密钥的情况下撤销特定密钥。
我丢失了密钥。该怎么办？
密钥无法恢复。请前往开发者页面，撤销丢失的密钥并创建新密钥。使用新值更新您的集成。
身份验证需要公钥吗？
并非必须。身份验证由密钥完成。公钥是可选的，用作额外标识符，但不能替代密钥。
如何撤销密钥？
在开发者页面的密钥列表中，找到要停用的密钥，然后点击撤销选项。从那时起，任何使用该密钥的请求都将被拒绝。
我可以在 n8n 或 Zapier 等工具中使用这些密钥吗？
可以。Papo API 密钥与任何支持 Bearer token 身份验证的工具兼容。只需将密钥填入该工具的授权字段即可。
另请阅读
在 Papo 创建免费账户，立即获取 API 密钥以集成您的系统。