7B2主题REST API接口文档-开发必备！

B2主题美化开发必备：WordPress网站7B2主题REST API接口文档，详细内容如下：

基础信息

• 命名空间: b2/v1
• 认证方式: JWT Token (内置JWT认证)
• 请求方法: 主要为POST，部分为GET
• 基础URL: /wp-json/b2/v1/{接口名称}

用户登录与注册

核心接口

微信相关

绑定与邀请

用户信息管理

个人信息

收货地址

社交关系

收藏与签到

其他功能

私信系统

财务与积分

文章内容管理

文章列表

多媒体内容

文章操作

下载功能

评论系统

商城功能

商品管理

购物车

订单管理

支付系统

圈子社区系统

圈子管理

话题管理

问答系统

其他功能

文件上传

其他功能

链接管理

资讯系统

问答系统

分销系统

举报与安全

使用示例

基础请求格式

// 获取用户信息
fetch('/wp-json/b2/v1/getUserInfo', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + jwt_token
},
body: JSON.stringify({})
})
.then(response => response.json())
.then(data => console.log(data));

分页请求示例

// 获取文章列表（带分页）
fetch('/wp-json/b2/v1/getPostList', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
paged: 1,
posts_per_page: 10,
category: '分类ID'
})
})
.then(response => response.json())
.then(data => console.log(data));

文件上传示例

// 上传图片
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('type', 'image');
fetch('/wp-json/b2/v1/fileUpload', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => console.log(data));

用户注册示例

// 用户注册
fetch('/wp-json/b2/v1/regeister', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
username: 'testuser',
password: 'password123',
email: 'test@example.com',
code: '123456'
})
})
.then(response => response.json())
.then(data => {
if (data.success) {
console.log('注册成功');
} else {
console.log('注册失败:', data.message);
}
});

注意事项

1. 认证要求

• 大部分接口需要JWT认证，需要在请求头中添加 Authorization: Bearer {token}
• 获取token的方式：用户登录后系统会返回JWT token

2. 参数验证

• 所有接口都有完整的参数验证
• 参数错误会返回详细的错误信息
• 参数类型需要严格按照文档要求

3. 权限控制

• 不同用户角色有不同的API访问权限
• 管理员、普通用户、游客的权限不同
• 部分接口需要特定的用户权限才能访问

4. 安全机制

• 内置频率限制，防止恶意请求
• 验证码验证机制
• 敏感操作需要二次确认

5. 错误处理

• 统一使用WP_REST_Response和WP_Error返回结果
• 成功响应格式：{success: true, data: {...}}
• 错误响应格式：{success: false, message: '错误信息'}

6. 分页参数

• paged: 页码，从1开始
• posts_per_page: 每页数量，默认10

7. 文件上传限制

• 支持图片、文档等文件类型
• 有文件大小限制
• 需要指定文件类型参数

总结

B2主题的REST API设计非常完善，涵盖了社区、商城、内容管理、用户系统等各个方面，总共包含超过150个API接口。这些接口为开发者提供了完整的二次开发能力，可以基于这些API构建各种复杂的Web应用和移动应用。

接口设计遵循RESTful原则，使用标准的HTTP方法和状态码，返回格式统一规范，便于前端开发人员使用。