资讯与社区
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
在 社区 创建一篇新讨论。支持两种内容类型:
| 类型 | title |
body 格式 |
说明 |
|---|---|---|---|
post(默认) |
可选 | 纯文本 | Markdown 语法(如 **加粗**、# 标题)不会渲染,将作为字面字符显示,类似发推文。 |
article |
必填 | Markdown | 服务端将 Markdown 转为 HTML 展示,支持标题、表格、加粗、代码块等。 |
仅限 Longbridge 开户且持有资产 的用户才允许通过 Longbridge Developers 的 API 或 CLI 发布社区讨论和回复。否则返回 403。
Tip
正文中提到的标的代码(如 700.HK、TSLA.US)会被平台自动识别并关联为相关标的。tickers 字段用于补充正文中未显式提及的标的。
⚠️ 请勿滥用此功能关联与内容无关的标的,否则后台内容运营可能会限制发布,甚至有可能禁言。
频率限制: 同一用户每分钟最多创建 3 篇,24 小时内最多 10 篇,超出返回 429。
Warning
⚠️ 以上频率限制规则仅供参考,平台可能随时进行内部调整。
# publish a topic for Tesla
longbridge topic create --body "Tesla Q1 earnings analysis" --tickers TSLA.US
# publish a topic for Apple
longbridge topic create --body "Apple WWDC preview" --tickers AAPL.US
请求
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 可选 | 标题。`topic_type` 为 `article` 时必填,`post` 时可省略。 |
body | string | 必填 | 正文。`post` 类型为纯文本,Markdown 不渲染;`article` 类型支持 Markdown。 |
topic_type | string | 可选 | 内容类型:`post`(纯文本,默认)或 `article`(Markdown) |
tickers | array | 可选 | 关联标的代码,格式 `{symbol}.{market}`,如 `["AAPL.US", "700.HK"]`,最多 10 个。**注意:** 正文中提到的标的代码(如 `700.HK`、`TSLA.US`)会被平台自动识别并关联,`tickers` 用于补充正文中未显式提及的标的。 |
hashtags | array | 可选 | 讨论标签名称列表,如 `["earnings", "fed"]`,最多 1 个 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
item | object | 必填 | 新建讨论详情 |
└ id | string | 必填 | 讨论 ID |
└ title | string | 可选 | 标题 |
└ description | string | 可选 | 纯文本摘要(由正文自动截取) |
└ body | string | 可选 | 完整正文(`article` 类型为 Markdown) |
└ topic_type | string | 可选 | 内容类型,`article` 或 `post` |
└ tickers | string[] | 可选 | 关联标的代码 |
└ hashtags | string[] | 可选 | 讨论标签名称列表 |
└ images | object[] | 可选 | 附图列表 |
└ ∟ url | string | 可选 | 原始图片 URL |
└ ∟ sm | string | 可选 | 小缩略图 URL |
└ ∟ lg | string | 可选 | 大缩略图 URL |
└ likes_count | int32 | 可选 | 点赞数 |
└ comments_count | int32 | 可选 | 回复数 |
└ views_count | int32 | 可选 | 浏览数 |
└ shares_count | int32 | 可选 | 分享数 |
└ detail_url | string | 可选 | 讨论页面直链 |
└ author | object | 可选 | 作者信息 |
└ ∟ member_id | string | 可选 | 作者 member ID |
└ ∟ name | string | 可选 | 作者昵称 |
└ ∟ avatar | string | 可选 | 作者头像 URL |
└ created_at | string | 必填 | 创建时间,Unix 时间戳(秒) |
└ updated_at | string | 可选 | 最近更新时间,Unix 时间戳(秒) |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"item": {
"id": "39304657",
"title": "My View on AAPL",
"topic_type": "article",
"tickers": [
"AAPL.US"
],
"hashtags": [
"earnings"
],
"created_at": "1742000000"
}
}
}错误码
参见错误码文档。