# api\_overview

## API介绍

附身智能 API 服务，为快速搭建基于 AI 模型的各类问答智能体提供基础能力。

### 准备工作

在调用 API 前，确保你已从附身智能运营平台建立应用，并通授权方式获取了访问令牌。

#### 获取访问密钥

联系附身智能运营人员，注册 <https://xxxx.com/apps> 运营平台。\
登陆 <https://xxxx.com> 可在“我的”获取 **AccessKey ID** 和 **AccessKey Secret**。

参考图：

#### 获取访问令牌

调用 API 时，你需要在 Header 中通过 Authorization 参数指定访问令牌（Access token），服务端会根据访问令牌验证调用方的操作权限。调用 API 之前，你需要先获得访问令牌。\
详细说明可参考[获取授权](#/zh-cn/chat/authToken/getToken)方式概述。

### 其他

#### 获取厂商ID

**vendorId**

#### 获取APP ID

**appId**

#### 手动创建BOT ID

**botId**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.ai.yontoys.com/api_overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
