資訊與社區
鑑權
簽名方式:每個請求用 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"
}
}
}錯誤碼
參見錯誤碼文檔。