资讯与社区

创建讨论

POSThttps://openapi.longbridge.com/v1/content/topics

鉴权

签名方式:每个请求用 App Key / Secret 签名。请求头如下:

名称类型必填说明
Authorizationstring · header必填OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填请求时间戳,单位秒(Unix 时间)。
X-Api-Signaturestring · 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

⚠️ 以上频率限制规则仅供参考,平台可能随时进行内部调整。

>_ CLI
# 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

请求

请求体

名称类型必填说明
titlestring可选标题。`topic_type` 为 `article` 时必填,`post` 时可省略。
bodystring必填正文。`post` 类型为纯文本,Markdown 不渲染;`article` 类型支持 Markdown。
topic_typestring可选内容类型:`post`(纯文本,默认)或 `article`(Markdown)
tickersarray可选关联标的代码,格式 `{symbol}.{market}`,如 `["AAPL.US", "700.HK"]`,最多 10 个。**注意:** 正文中提到的标的代码(如 `700.HK`、`TSLA.US`)会被平台自动识别并关联,`tickers` 用于补充正文中未显式提及的标的。
hashtagsarray可选讨论标签名称列表,如 `["earnings", "fed"]`,最多 1 个

响应

响应字段

名称类型必填说明
itemobject必填新建讨论详情
└ idstring必填讨论 ID
└ titlestring可选标题
└ descriptionstring可选纯文本摘要(由正文自动截取)
└ bodystring可选完整正文(`article` 类型为 Markdown)
└ topic_typestring可选内容类型,`article` 或 `post`
└ tickersstring[]可选关联标的代码
└ hashtagsstring[]可选讨论标签名称列表
└ imagesobject[]可选附图列表
└ ∟ urlstring可选原始图片 URL
└ ∟ smstring可选小缩略图 URL
└ ∟ lgstring可选大缩略图 URL
└ likes_countint32可选点赞数
└ comments_countint32可选回复数
└ views_countint32可选浏览数
└ shares_countint32可选分享数
└ detail_urlstring可选讨论页面直链
└ authorobject可选作者信息
└ ∟ member_idstring可选作者 member ID
└ ∟ namestring可选作者昵称
└ ∟ avatarstring可选作者头像 URL
└ created_atstring必填创建时间,Unix 时间戳(秒)
└ updated_atstring可选最近更新时间,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"
    }
  }
}

错误码

参见错误码文档。