晚夜深秋

Appearance

Return to top
On this page

API 参考

WanYesea插件提供了一系列REST API接口，用于小程序端与WordPress后端的数据交互。所有API端点均以/wp-json/wanyesea/v1/为前缀。

基础信息

  • 基础URL: https://yourdomain.com/wp-json/wanyesea/v1/
  • 请求方法: GET/POST (根据具体接口要求)
  • 认证方式: 部分接口需要用户认证，通过Cookie或Token实现

主要API接口

小程序相关接口

获取关于页面信息

  • 端点: /wechat/about
  • 方法: GET
  • 参数: 无
  • 响应示例:
json
{
  "logo": "https://yourdomain.com/wp-content/uploads/logo.png",
  "title": "关于我们",
  "content": "<p>详细介绍内容...</p>"
}

获取首页数据

  • 端点: /wechat/index
  • 方法: GET
  • 参数: 无
  • 响应示例:
json
{
  "banners": [
    {"image": "https://yourdomain.com/wp-content/uploads/banner1.jpg", "link": "/page1"}
  ],
  "notice": "最新公告内容",
  "pop_notice": {
    "content": "紧急通知内容",
    "redirect": true,
    "path": "/notice"
  }
}

用户相关接口

获取用户元数据

  • 端点: /user/meta
  • 方法: GET
  • 参数: user_id (用户ID，必需)
  • 响应示例:
json
{
  "nickname": "用户名",
  "avatar": "https://yourdomain.com/wp-content/uploads/avatar.jpg",
  "other_data": {}
}

获取用户VIP信息

  • 端点: /user/meta/vip
  • 方法: GET
  • 参数: id (用户ID，必需)
  • 响应示例:
json
{
  "vip_level": 2,
  "vip_exp_date": "2024-12-31"
}

壁纸相关接口

获取壁纸列表

  • 端点: /wallpaper
  • 方法: GET
  • 参数: page (页码), per_page (每页数量)
  • 响应示例:
json
{
  "total": 50,
  "page": 1,
  "per_page": 10,
  "data": [
    {
      "id": "wallpaper123",
      "image": "https://yourdomain.com/wp-content/uploads/wallpaper1.jpg",
      "category": "nature"
    }
  ]
}

功能相关接口

获取功能列表

  • 端点: /function
  • 方法: GET
  • 参数: 无
  • 响应示例:
json
{
  "functions": [
    {
      "id": "func123",
      "title": "功能标题",
      "description": "功能描述",
      "icon": "https://yourdomain.com/wp-content/uploads/icon1.png"
    }
  ]
}

错误处理

API请求失败时，将返回标准的WordPress错误响应，例如:

json
{
  "code": "no_data",
  "message": "No about data found",
  "data": {
    "status": 404
  }
}