External Integration
API 对接教学
外部系统可通过 WEMS 投资新闻 API 读取文章、行情、K 线与分析资料。除 /status 外，其余端点需在 HTTP Header 放入 X-Api-Key。
Base URLhttps://news.sun-bd.com/api/public/v1
验证 HeaderX-Api-Key
响应格式JSON envelope
版本v1
快速开始
/status 可不带 key 用于健康检查；正式资料端点需使用运营方提供的 API key。
curl -sS "https://news.sun-bd.com/api/public/v1/status"curl -sS "https://news.sun-bd.com/api/public/v1/catalog" \
-H "X-Api-Key: YOUR_API_KEY"标准响应格式
所有成功与错误响应都使用一致 envelope，方便合作系统进行错误处理、追踪与重试。
{
"success": true,
"data": {},
"error": null,
"timestamp": "2026-05-30T12:00:00Z",
"traceId": null
}端点清单
| Method | Path | 用途 | Key |
|---|---|---|---|
| GET | /status | 健康检查与 API 状态确认 | 否 |
| GET | /catalog | 取得可用端点与查询参数说明 | 是 |
| GET | /articles | 查询已发布文章，支持 page、page_size、category、keyword | 是 |
| GET | /articles/{id} | 取得单篇文章内容、摘要、标签与发布信息 | 是 |
| GET | /market/assets | 取得市场资产清单，可用 category 筛选 | 是 |
| GET | /market/candles | 取得 K 线资料，支持 asset_id、interval、days | 是 |
| GET | /analytics/overview | 取得文章、浏览、分享与推送总览 | 是 |
范例
curl -sS "https://news.sun-bd.com/api/public/v1/articles?page=1&page_size=20&category=market" \
-H "X-Api-Key: YOUR_API_KEY"curl -sS "https://news.sun-bd.com/api/public/v1/market/assets?category=crypto" \
-H "X-Api-Key: YOUR_API_KEY"const response = await fetch("https://news.sun-bd.com/api/public/v1/articles", {
headers: { "X-Api-Key": process.env.WEMS_NEWS_API_KEY }
})
const body = await response.json()错误处理
401：缺少或错误的X-Api-Key。404：指定文章不存在或尚未发布。503：外部 API 未启用或暂时不可用。
会员登录 API
会员登录、登出、刷新 token 与权限不属于本项目 API，请使用集中会员 API 文件。