X Xora API
v1.0 · 更新于 2026-11-19 · 已上线运行

Xora 服务端 API 文档

数码社区(板块 / 帖子 / 评论 / 私信 / 通知 / 应用库 / 设备库)的完整后端接口。 全部业务请求为 POST + application/x-www-form-urlencoded,用 action 字段分派,统一返回 JSON。

接口根地址
https://api.xoar.top
仅此域名对外提供接口,根域已关闭
服务状态
检测中…
实时请求 /healthz
传输与鉴权
HTTPS 已启用 Bearer Token
TLS 1.2/1.3 · Let's Encrypt 自动续期

三步跑通第一个请求

1. 拿一个验证码

向已绑定账号的邮箱发送 6 位登录码,60 秒内不可重复请求。

curl -X POST https://api.xoar.top/api/user/email.php \
  -d 'action=login_account_by_email' \
  -d 'email=xora001@163.com'

2. 校验验证码换 token

成功返回 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'

3. 带上 token 调业务接口

curl -X POST https://api.xoar.top/api/feed.php \
  -d 'action=feed' -d 'feed_type=推荐' -d 'per_page=20' \
  -H 'Authorization: Bearer <token>'

按模块查接口

4 组

登录与鉴权

邮箱验证码登录、图形验证码、账号密码登录/注册、扫码登录

1

首页信息流

推荐 / 关注 / 视频 / 快讯 / 热榜 / 问答,游标分页与屏蔽词

4

话题板块

板块详情、帖子列表、关注板块、评分(1-10 分 + 分项)

7

帖子

详情、点赞、收藏、删除、置顶、关闭评论、发帖(含投票/定时)

4

评论

列表、发表、点赞、删除,支持楼中楼 reply_to

1

搜索

综合 / 帖子 / 话题 / 用户 / 应用,支持限定用户或板块范围

6

用户

资料、内容列表、编辑资料、关注、粉丝列表、黑名单

3

私信

会话列表、历史消息(sequence 翻页)、发送与限制提示

1

通知

点赞 / 回复 / 关注 / 系统,按类型过滤与未读标记

4

应用库

榜单(好评/最新/热门)、详情、上传 APK、版本更新检查

4

设备库

我的设备、添加、修改、删除,展示品牌型号与评分星级

12

Web 页面

协议、隐私、举报、绑定手机、登录设备、黑名单、注销、等级进度

对接前先看一眼

通用约定

项值
方法POST(上传接口为 multipart)
Content-Typeapplication/x-www-form-urlencoded; charset=UTF-8
鉴权Authorization: Bearer <token>,兼容表单 token / sgin
分页page + per_page(默认 20,上限 100)
图片返回完整 URL,客户端不需要拼接

常见错误码

code含义
0成功
401token 失效,清本地态跳登录
403被限制(私信/评论/黑名单)
429请求过频
1002 / 1004账号不存在 / 内容不存在
1005无权限(非楼主)

查看完整错误码表 →

联调账号

账号邮箱密码说明
舟行客(10001)xora001@163.com123456主测试号,已有设备 / 通知 / 私信
数码老王(20001)laowang@example.com123456内容较多的作者号
极客小林(20002)xiaolin@example.com123456—
摄影阿May(20003)may@example.com123456—
音频控老陈(20004)laochen@example.com123456—

演示数据包含 5 个板块、16 条帖子、评论、关注关系、评分、通知、私信、5 个应用、3 台设备。

小提示

HTTP 与 HTTPS 都可用。接口 POST 在 80 端口直通、不跳转(避免丢失表单体);网页 GET 会自动 301 到 HTTPS。
证书覆盖两个域名。api.xoar.top 与 xoar.top 共用同一张 Let's Encrypt 证书,浏览器不会提示不安全。
验证码有频控。同一邮箱 60 秒内只能发一次,验证码 10 分钟有效、一次性使用;返回 429 时请倒计时后再试。