> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# 简介

> 触发更新、嵌入 AI 助手等

Mintlify 的 REST API 让你可以以编程方式与文档交互、触发更新，并嵌入 AI 驱动的聊天体验。

<div id="endpoints">
  ## 端点
</div>

* [触发更新](/zh/api-reference/update/trigger): 按需触发你的网站更新。
* [获取更新状态](/zh/api-reference/update/status): 获取一次更新的状态以及你文档的其他详细信息。
* [创建代理任务](/zh/api-reference/agent/create-agent-job): 创建代理任务以自动编辑你的文档。
* [获取代理任务](/zh/api-reference/agent/get-agent-job): 获取特定代理任务的详细信息和状态。
* [获取所有代理任务](/zh/api-reference/agent/get-all-jobs): 获取某个 domain 的所有代理任务。
* [生成 AI 助手消息](/zh/api-reference/assistant/create-assistant-message): 将基于你的文档训练的 AI 助手嵌入到任意应用中。
* [搜索文档](/zh/api-reference/assistant/search): 在你的文档中进行搜索。

<div id="authentication">
  ## 认证
</div>

在控制台的 [API keys 页面](https://dashboard.mintlify.com/settings/organization/api-keys)生成 API key。每个 API key 都属于一个组织，你可以在同一组织内的多个部署中使用这些 API key。

每个组织每小时最多可创建 10 个 API key。

<div id="admin-api-key">
  ### 管理员 API key
</div>

使用管理员 API key 对发送到 [触发更新](/zh/api-reference/update/trigger)、[获取更新状态](/zh/api-reference/update/status) 以及所有代理端点的请求进行身份验证。

管理员 API key 以 `mint_` 前缀开头。请妥善保管你的管理员 API key。

<div id="assistant-api-key">
  ### Assistant API key
</div>

使用 assistant API key 对发往 [生成助手消息](/zh/api-reference/assistant/create-assistant-message) 和 [搜索文档](/zh/api-reference/assistant/search) 端点的请求进行认证。

assistant API key 以 `mint_dsc_` 前缀开头。

assistant API 的 **key** 是应当保密的服务端令牌。

assistant API 的 **token** 是可在前端代码中引用的公共令牌。

<Note>
  使用 assistant API token 进行的调用可能会产生费用：可能会消耗你的 AI 助手额度，或产生超额费用。
</Note>
