---
document_id: agent.paths.api
schema_version: 2
parent_document_id:
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# API documentation / API 开发文档

## Start integrating / 开始集成

第一次接入，从[快速开始](https://docs.asklear.cn/api/quickstart)完成一个有效请求；已知道目标能力，直接进入[API 参考](https://docs.asklear.cn/api/reference)。

For a first integration, complete a request with the [quickstart](https://docs.asklear.cn/en/api/quickstart). If you know the capability, open the [API reference](https://docs.asklear.cn/en/api/reference).

AI 帮你写程序也走这条路径。让它读取目标接口与相关调用规则，不必先学习 MCP 工具流程。

An AI writing integration code should use this path too: read the endpoint and relevant calling rules, without first learning the MCP workflow.

## Read what you need / 按需要读取

[鉴权](https://docs.asklear.cn/api/authentication)：API Key 与程序 OAuth；[调用规则](https://docs.asklear.cn/api/calling)：分页、异步、幂等和费用；[错误处理](https://docs.asklear.cn/api/errors)：根据服务端错误决定下一步。

[Authentication](https://docs.asklear.cn/en/api/authentication): API keys and programmatic OAuth. [Calling rules](https://docs.asklear.cn/en/api/calling): pagination, asynchronous work, idempotency and charges. [Errors](https://docs.asklear.cn/en/api/errors): follow server-provided recovery actions.

偏好命令行时读取 [CLI 接入](https://docs.asklear.cn/api/cli)。若要让已连接的 Agent 直接完成业务问题，请进入 [Agent 使用指南](https://docs.asklear.cn/agent)。

For command-line use, read the [CLI guide](https://docs.asklear.cn/en/api/cli). To have a connected Agent perform a business task, use the [Agent guide](https://docs.asklear.cn/en/agent).
