超腾开源平台网站模块

网站模块提供网站公开接口,支持第三方集成和数据访问。

目录

• 接口概述
• 用户接口
• 内容接口
• 商业接口
• 统计接口
• 常见问题

接口概述

网站模块提供公开的 REST API 接口,供第三方应用调用。

接口特点

• 无需认证: 公开接口无需认证即可调用
• 跨域支持: 支持跨域请求
• 数据格式: JSON 格式
• 限流保护: 防止恶意请求

接口地址

基础 URL: https://example.com/api/website

用户接口

用户接口提供用户相关信息查询。

获取用户信息

接口地址: GET /api/website/users/{user_id}

请求参数:

• user_id: 用户 ID

响应示例:

{
  "success": true,
  "data": {
    "id": "1",
    "username": "张三",
    "avatar": "https://example.com/avatar.jpg"
  }
}

内容接口

内容接口提供公开内容查询。

博客接口

获取博客列表: GET /api/website/blogs 获取博客详情: GET /api/website/blogs/{id}

微博接口

获取微博列表: GET /api/website/microblogs 获取微博详情: GET /api/website/microblogs/{id}

Wiki 接口

获取 Wiki 列表: GET /api/website/wiki 获取 Wiki 详情: GET /api/website/wiki/{id}

商业接口

商业接口提供商品信息查询。

商品接口

获取商品列表: GET /api/website/products 获取商品详情: GET /api/website/products/{id}

收藏接口

获取收藏列表: GET /api/website/favorites 添加收藏: POST /api/website/favorites

统计接口

统计接口提供公开统计数据。

站点统计

接口地址: GET /api/website/statistics

响应示例:

{
  "success": true,
  "data": {
    "visits": 10000,
    "visitors": 5000,
    "articles": 100
  }
}

常见问题

Q: 如何获取 API 文档?

A: 完整 API 文档请访问 /api-documentation/ 查看详细接口说明。

Q: 有调用频率限制吗?

A: 是的,每个 IP 每分钟最多 100 次请求,超过限制会返回 429 错误。

Q: 支持哪些数据格式?

A: 目前只支持 JSON 格式的请求和响应。

Q: 如何获取技术支持?

A: 如有问题,请联系技术支持团队或查看 API 文档。

最后更新: 2026-01-03
文档版本: v1.0.0