Showdoc是一款在线文档编辑和分享工具，它提供了丰富的功能，包括API接口调用。在最新版本的Showdoc中，Runapi是一个非常重要的功能，它可以帮助我们快速地测试和调试API接口。本文将详细介绍如何使用Showdoc的Runapi功能。
一、准备工作
在使用Showdoc的Runapi功能之前，我们需要先完成以下准备工作：
- 注册并登录Showdoc账号。
- 创建一个API项目。
- 编写API接口文档。
- 编写API接口代码。
二、创建API项目
在Showdoc中，我们可以通过以下步骤创建一个API项目：
- 登录Showdoc账号，点击左侧导航栏中的“项目管理”按钮。
- 点击右上角的“新建项目”按钮，输入项目名称、项目描述等信息，然后点击“创建”按钮。
- 在项目列表中，找到刚刚创建的项目，点击进入项目详情页面。
- 在项目详情页面中，点击“添加接口”按钮，输入接口名称、接口路径等信息，然后点击“保存”按钮。
- 在接口列表中，找到刚刚创建的接口，点击进入接口详情页面。
- 在接口详情页面中，点击“编辑”按钮，编写接口文档和接口代码。
三、编写API接口文档
在Showdoc中，我们可以使用Markdown语法编写API接口文档。以下是一个简单的API接口文档示例：
# 用户管理接口
## 获取用户列表
### 请求URL
`GET /users`
### 请求参数
| 参数名 | 类型 | 必填 | 描述 |
| :----: | :--: | :--: | :---: |
| page | int | 否 | 分页参数，默认为1 |
| limit | int | 否 | 每页显示数量，默认为10 |
### 返回结果
| 字段名 | 类型 | 描述 |
| :----: | :--: | :---: |
| id | int | 用户ID |
| name | string | 用户名 |
| email | string | 邮箱地址 |
| created_at | date | 创建时间 |
四、编写API接口代码
在Showdoc中，我们可以使用多种编程语言编写API接口代码。以下是一个简单的PHP API接口代码示例：
<?php
header('Content-Type: application/json');
header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: GET,POST,PUT,DELETE');
header('Access-Control-Allow-Headers: Content-Type,Authorization');
// 获取请求参数
$page = isset($_GET['page']) ? $_GET['page'] : 1;
$limit = isset($_GET['limit']) ? $_GET['limit'] : 10;
// 连接数据库
$conn = new PDO('mysql:host=localhost;dbname=test', 'root', 'password');
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 查询数据
$sql = "SELECT * FROM users LIMIT {$limit} OFFSET {$page * $limit}";
$result = $conn->query($sql);
$data = $result->fetchAll(PDO::FETCH_ASSOC);
// 返回结果
echo json_encode($data, JSON_UNESCAPED_UNICODE);
?>
五、使用Runapi功能测试API接口
在Showdoc中，我们可以通过以下步骤使用Runapi功能测试API接口：
- 在接口详情页面中，找到“Runapi”按钮，点击进入Runapi页面。
- Runapi页面中，我们可以看到一个输入框和一个“运行”按钮。在输入框中，我们输入API接口的请求参数。例如，对于上面的用户管理接口，我们可以输入如下请求参数：
page=1&limit=10。注意，请求参数之间用&符号分隔。 - 输入完请求参数后，点击“运行”按钮，Showdoc会自动发送请求到API接口，并将返回结果展示在下方的“返回结果”区域。我们可以查看返回结果中的字段名、类型和描述，以及返回的数据内容。如果返回结果中有错误信息，我们可以在“错误信息”区域查看详细的错误信息。此外，我们还可以将返回结果复制到剪贴板，以便在其他应用中使用。
- 如果需要修改请求参数或者重新运行API接口，我们可以清空输入框中的内容，然后重新输入请求参数并点击“运行”按钮。
