SteelWe 的数据与账号能力可被外部系统调用：公开读取 API、RSS 订阅、邮箱/JWT 认证、第三方登录。
| 方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
| GET | /api/v1/questions?page=1&size=20 | 问答列表（可按 locale 过滤） | 公开 |
| GET | /api/v1/questions/{id} | 问答详情（含回答） | 公开 |
| GET | /api/v1/knowledge?page=1&size=20 | 知识库列表 | 公开 |
| GET | /api/v1/knowledge/{slug} | 知识详情（含正文） | 公开 |
| GET | /api/v1/standards?q=316L | 牌号标准对照（GB/ASTM/EN/JIS/ISO） | 公开 |
| GET | /api/v1/defects?page=1&size=20 | 加工缺陷图谱 | 公开 |
| GET | /api/v1/orgs?page=1&size=20 | 企业能力档案 | 公开 |
| GET | /api/v1/experts?page=1&size=20 | 认证专家 | 公开 |
| GET | /api/v1/boards | 社区圈子列表 | 公开 |
| GET | /api/v1/posts?sort=hot&size=20 | 社区帖子列表（latest/hot） | 公开 |
| GET | /api/v1/posts/{id} | 帖子详情（含评论） | 公开 |
| GET | /actuator/health | 服务健康检查 | 公开 |
| 方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
| POST | /api/v1/auth/register | 邮箱 + 密码注册 | 公开 |
| POST | /api/v1/auth/login | 邮箱 + 密码登录，返回 JWT | 公开 |
| POST | /api/v1/auth/magic-link | 发送邮箱登录链接 | 公开 |
| POST | /api/v1/auth/magic-link/verify | 用链接 token 换取 JWT | 公开 |
| GET | /api/v1/auth/providers | 可用的第三方登录方式 | 公开 |
| POST | /api/v1/auth/refresh | 刷新 access token | 公开 |
| GET | /api/v1/users/me | 当前用户资料 | 可选 JWT |
| POST | /api/v1/posts | 发帖（需登录） | 可选 JWT |
| POST | /api/v1/posts/{id}/comments | 评论（需登录） | 可选 JWT |
| POST | /api/v1/files/upload | 上传图片（需登录） | 可选 JWT |
# 读取热门帖子
curl 'https://greenboss.com.cn/api/v1/posts?sort=hot&size=5'
# 标准对照查询
curl 'https://greenboss.com.cn/api/v1/standards?q=316L'
# 登录获取 JWT
curl -X POST 'https://greenboss.com.cn/api/v1/auth/login' \
-H 'Content-Type: application/json' \
-d '{"email":"you@company.com","password":"********"}'
# 使用 JWT 发帖
curl -X POST 'https://greenboss.com.cn/api/v1/posts' \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer <accessToken>" \
-d '{"boardSlug":"materials","title":"标题","body":"内容"}'接口持续开放中
问答、知识、标准、缺陷、专家、企业、社区均已提供读取接口；写接口需登录。