XIUNOX RESTful API 详解：二次开发与 AI 集成的理想选择

爱马仕 Lv2 1小时前

为什么 API 对现代论坛如此重要？

在 2026 年，一个没有完善 API 的论坛系统几乎等于「与世隔绝」。对接 AI 聊天机器人、集成企业微信通知、开发移动端应用、实现与 CMS 单点登录——强大的 API 是这一切的基础。XIUNOX 内置完整的 RESTful API，大大降低二次开发门槛，为 AI 集成铺平了道路。

API 总览

XIUNOX API 遵循 RESTful 规范，JSON 数据交换，Bearer Token 认证。接口位于 /admin/api/v1/ 路径下。

分类	端点	说明
认证	auth/*	登录、注册、Token 管理
帖子	thread/*	CRUD、列表、搜索
回复	post/*	回复管理、列表
用户	user/*	信息、积分、收藏
版块	forum/*	列表、信息、计数
附件	attach/*	图片/文件上传
通知	notify/*	推送、已读管理
搜索	search/*	全文检索
站点	site/*	设置、统计
排行	rank/*	积分榜

API 认证与使用

获取 Token

curl -X POST "https://你的站点.com/admin/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "password": "your_password"}'

# 响应示例
{"code": 0, "data": {
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "expires_in": 7200,
  "user": {"uid": 1, "username": "admin"}
}}

调用 API

# 获取帖子列表
curl -X GET "https://你的站点.com/admin/api/v1/thread/list?fid=1&page=1" \
  -H "Authorization: Bearer 你的access_token"

# 发布新帖
curl -X POST "https://你的站点.com/admin/api/v1/thread/update" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的access_token" \
  -d '{"fid": 1, "subject": "API 测试", "message": "<p>通过 API 发布</p>"}'

# 上传图片
curl -X POST "https://你的站点.com/admin/api/v1/attach" \
  -H "Authorization: Bearer 你的access_token" \
  -F "file=@/tmp/image.png"

AI 集成实战

场景一：AI 自动回复机器人

import requests, time

BASE = "https://你的站点.com/admin/api/v1"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

last_tid = 0
while True:
    resp = requests.get(f"{BASE}/thread/list?orderby=tid_desc&size=1", headers=HEADERS)
    data = resp.json()
    if data["code"] == 0 and data["data"]["list"]:
        tid = list(data["data"]["list"].keys())[0]
        if int(tid) > last_tid:
            thread = data["data"]["list"][tid]
            reply = generate_ai_reply(thread["subject"])
            requests.post(f"{BASE}/post/update", headers=HEADERS,
                json={"tid": tid, "message": f"<p>🤖 {reply}</p>"})
            last_tid = int(tid)
    time.sleep(30)

场景二：内容自动审核与分类

遍历新帖 → 调用 AI 内容审核 → 自动标记违规内容
AI 自动为帖子打标签（tags），提升搜索效果
AI 自动生成帖子摘要，优化首页展示和 SEO

场景三：AI 知识库问答

通过 API 导出论坛帖子内容构建向量数据库，搭建 AI 问答系统。用户提问时，系统自动从历史帖子中检索相关知识并生成回答。特别适合技术社区和客服场景。

API 注意事项

Token 有效期：2 小时，需用 refresh_token 刷新
速率限制：默认 60 次/分钟，超限返回 429
错误码：code=0 成功，非 0 失败（msg 字段有说明）
内容编码：message 支持 HTML，注意 XSS 过滤规则
头像路径：/upload/avatar/{uid前三位}/{uid}.png?t={时间戳}

总结

XIUNOX 的 RESTful API 是其最具战略价值的特性。它不仅让二次开发高效简单，更为论坛的 AI 集成提供了标准化接口。在 AI 赋能一切的时代，拥有 API 完善的论坛系统，意味着你的社区可以随时接入最新的 AI 能力，保持技术领先。

SEO 关键词：RESTful API、论坛API、二次开发、AI集成、论坛机器人、PHP API开发、开源论坛API、自动化发帖

点赞收藏