数码社区(板块 / 帖子 / 评论 / 私信 / 通知 / 应用库 / 设备库)的完整后端接口。
全部业务请求为 POST + application/x-www-form-urlencoded,用 action 字段分派,统一返回 JSON。
向已绑定账号的邮箱发送 6 位登录码,60 秒内不可重复请求。
curl -X POST https://api.xoar.top/api/user/email.php \
-d 'action=login_account_by_email' \
-d 'email=xora001@163.com'
成功返回 token、user_id、sgin,token 有效期 90 天。
curl -X POST https://api.xoar.top/api/user/email.php \
-d 'action=verify_login_email' \
-d 'email=xora001@163.com' -d 'code=123456'
curl -X POST https://api.xoar.top/api/feed.php \
-d 'action=feed' -d 'feed_type=推荐' -d 'per_page=20' \
-H 'Authorization: Bearer <token>'
邮箱验证码登录、图形验证码、账号密码登录/注册、扫码登录
1推荐 / 关注 / 视频 / 快讯 / 热榜 / 问答,游标分页与屏蔽词
4板块详情、帖子列表、关注板块、评分(1-10 分 + 分项)
7详情、点赞、收藏、删除、置顶、关闭评论、发帖(含投票/定时)
4列表、发表、点赞、删除,支持楼中楼 reply_to
综合 / 帖子 / 话题 / 用户 / 应用,支持限定用户或板块范围
6资料、内容列表、编辑资料、关注、粉丝列表、黑名单
3会话列表、历史消息(sequence 翻页)、发送与限制提示
1点赞 / 回复 / 关注 / 系统,按类型过滤与未读标记
4榜单(好评/最新/热门)、详情、上传 APK、版本更新检查
4我的设备、添加、修改、删除,展示品牌型号与评分星级
12协议、隐私、举报、绑定手机、登录设备、黑名单、注销、等级进度
| 项 | 值 |
|---|---|
| 方法 | POST(上传接口为 multipart) |
| Content-Type | application/x-www-form-urlencoded; charset=UTF-8 |
| 鉴权 | Authorization: Bearer <token>,兼容表单 token / sgin |
| 分页 | page + per_page(默认 20,上限 100) |
| 图片 | 返回完整 URL,客户端不需要拼接 |
| code | 含义 |
|---|---|
| 0 | 成功 |
| 401 | token 失效,清本地态跳登录 |
| 403 | 被限制(私信/评论/黑名单) |
| 429 | 请求过频 |
| 1002 / 1004 | 账号不存在 / 内容不存在 |
| 1005 | 无权限(非楼主) |
| 账号 | 邮箱 | 密码 | 说明 |
|---|---|---|---|
| 舟行客(10001) | xora001@163.com | 123456 | 主测试号,已有设备 / 通知 / 私信 |
| 数码老王(20001) | laowang@example.com | 123456 | 内容较多的作者号 |
| 极客小林(20002) | xiaolin@example.com | 123456 | — |
| 摄影阿May(20003) | may@example.com | 123456 | — |
| 音频控老陈(20004) | laochen@example.com | 123456 | — |
演示数据包含 5 个板块、16 条帖子、评论、关注关系、评分、通知、私信、5 个应用、3 台设备。
POST 在 80 端口直通、不跳转(避免丢失表单体);网页 GET 会自动 301 到 HTTPS。
api.xoar.top 与 xoar.top 共用同一张 Let's Encrypt 证书,浏览器不会提示不安全。
429 时请倒计时后再试。