API

每个工作区都有一个公共 API 密钥，用于从您自己的后端对 Docsbook 的 REST API 进行身份验证。今天，API 提供了一项功能：将您工作区的 AI 文档聊天导出为一个普通的 REST 端点——与您发布的文档网站上的 AI 聊天小部件相同的基础答案引擎，因此您可以在此基础上构建自己的支持机器人、Slack 集成或 CLI。

获取您的 API 密钥#

打开 集成 — 可以通过您在 /chat 输入中的头像下拉菜单，或在管理面板中的个人资料下拉菜单访问。从那里您可以查看（隐藏或显示）、复制或重置您的密钥。

每个工作区有一个有效密钥。重置会立即撤销旧密钥 — 没有密钥历史记录，因此在重置之前请更新任何调用者。

身份验证#

每个请求都使用 Bearer 令牌进行身份验证——您工作区的 API 密钥。

Authorization: Bearer dbk_<your_api_key>

请保管好您的密钥——它授予对您工作区的 AI 聊天的完全访问权限，费用将计入您账户的 AI 预算（与 docs-chat 小部件使用的预算相同；没有单独的仅 API 配额）。

curl -X POST https://docsbook.io/api/v1/chat \
  -H "Authorization: Bearer dbk_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"question": "How do I set a custom domain?"}'

{
  "answer": "You can set a custom domain from the Branding tab...",
  "refs": [{ "pagePath": "design/domains", "title": "Custom Domains", "heading": "Setup" }],
  "follow_up_questions": ["What SSL certificate is used?", "Can I use a subdomain?"]
}