---
slug: create-topic
title: 創建討論
sidebar_position: 4
language_tabs: false
toc_footers: []
includes: []
search: true
highlight_theme: ''
headingLevel: 2
---

創建一篇新討論。支持兩種內容類型：

| 類型 | `title` | `body` 格式 | 說明 |
|------|---------|-------------|------|
| `post`（默認） | 可選 | 純文本 | Markdown 語法（如 `**加粗**`、`# 標題`）**不會渲染**，將作為字面字符顯示，類似發推文。 |
| `article` | **必填** | Markdown | 服務端將 Markdown 轉為 HTML 展示，支持標題、表格、加粗、代碼塊等。 |

僅限 **Longbridge 開戶且持有資產** 的用戶才允許通過 Longbridge Developers 的 API 或 CLI 發布社區討論和回覆。否則返回 `403`。

<TipContainer type="tip">
正文中提到的標的代碼（如 `700.HK`、`TSLA.US`）會被平台自動識別並關聯為相關標的。`tickers` 字段用於補充正文中未顯式提及的標的。

> ⚠️ 請勿濫用此功能關聯與內容無關的標的，否則後台內容運營可能會限制發布，甚至有可能禁言。
</TipContainer>

**頻率限制：** 同一用戶每分鐘最多創建 3 篇，24 小時內最多 10 篇，超出返回 `429`。

> ⚠️ 以上頻率限制規則僅供參考，平台可能隨時進行內部調整。

<CliCommand>
# 發佈 Tesla 相關話題
longbridge topic create --body "Tesla Q1 財報分析" --tickers TSLA.US
# 發佈 Apple 相關話題
longbridge topic create --body "Apple WWDC 前瞻" --tickers AAPL.US
</CliCommand>


## SDK

| 語言 | 鏈接 |
|---|---|
| Python | [longbridge.openapi.content._content_context](https://longbridge.github.io/openapi/python/reference_all/#longbridge.openapi.content._content_context) |
| Rust | [longbridge::<SDKLinks module="content" klass="ContentContext" method="create_topic" />::content#_content_context](https://longbridge.github.io/openapi/rust/longbridge/<SDKLinks module="content" klass="ContentContext" method="create_topic" />/struct.content.html#method._content_context) |
| Go | [content.create_topic](https://pkg.go.dev/github.com/longbridge/openapi-go/<SDKLinks module="content" klass="ContentContext" method="create_topic" />#content.create_topic) |
| Node.js | [content#ContentContext](https://longbridge.github.io/openapi/nodejs/classes/content.html#contentcontext) |
| Java | [content.getContentContext](https://longbridge.github.io/openapi/java/com/longbridge/<SDKLinks module="content" klass="ContentContext" method="create_topic" />/content.html#getContentContext) |
| C++ | [longbridge::<SDKLinks module="content" klass="ContentContext" method="create_topic" />::content::_content_context](https://longbridge.github.io/openapi/cpp/classlongbridge_1_1<SDKLinks module="content" klass="ContentContext" method="create_topic" />_1_1_content.html) |

## Request

<table className="http-basic">
<tbody>
<tr><td className="http-basic-key">HTTP Method</td><td>POST</td></tr>
<tr><td className="http-basic-key">HTTP URL</td><td>/v1/content/topics</td></tr>
</tbody>
</table>

### Request Body

| Name        | Type     | Required              | Description                                                                                           |
| ----------- | -------- | --------------------- | ----------------------------------------------------------------------------------------------------- |
| title       | string   | 是（article 類型必填） | 標題。`topic_type` 為 `article` 時必填，`post` 時可省略。                                              |
| body        | string   | YES                   | 正文。`post` 類型為純文本，Markdown 不渲染；`article` 類型支持 Markdown。                              |
| topic_type  | string   | NO                    | 內容類型：`post`（純文本，默認）或 `article`（Markdown）                                               |
| tickers     | string[] | NO                    | 關聯標的代碼，格式 `{symbol}.{market}`，如 `["AAPL.US", "700.HK"]`，最多 10 個。**注意：** 正文中提到的標的代碼（如 `700.HK`、`TSLA.US`）會被平台自動識別並關聯，`tickers` 用於補充正文中未顯式提及的標的。 |
| hashtags    | string[] | NO                    | 討論標籤名稱列表，如 `["earnings", "fed"]`，最多 1 個                                                  |

### Request Example

<Tabs groupId="request-example">
  <TabItem value="cli" label="CLI" default>

```bash
# 短帖 — 純文本（默認），Markdown 不渲染
longbridge topic create --body "今天看好 700.HK"

# 短帖 + 關聯標的
longbridge topic create --body "NVDA GTC 看點" --tickers NVDA.US,700.HK

# 長文 — 支持 Markdown，必須填寫標題
longbridge topic create --title "我的分析" --body "**看好** 700.HK，因為..." --type article

# 長文 — 從 Markdown 文件讀取正文
longbridge topic create --title "Q4 財報前瞻" --body "$(cat analysis.md)" --type article

# JSON 輸出
longbridge topic create --body "測試帖" --format json
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
from longbridge.openapi import ContentContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = ContentContext(config)

# 短帖（純文本）
resp = ctx.create_topic(
    title="",
    body="今天看好 700.HK",
    topic_type="post",
    tickers=["700.HK"],
)
print(resp)

# 長文（Markdown，標題必填）
resp = ctx.create_topic(
    title="我的分析",
    body="**看好** 700.HK，因為...",
    topic_type="article",
    tickers=["700.HK"],
    license=1,
)
print(resp)
```

  </TabItem>
  <TabItem value="python-async" label="Python (async)">

```python
import asyncio
from longbridge.openapi import AsyncContentContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncContentContext.create(config)

    resp = await ctx.create_topic(
        title="我的分析",
        body="**看好** 700.HK，因為...",
        topic_type="article",
        tickers=["700.HK"],
    )
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())
```

  </TabItem>
  <TabItem value="nodejs" label="Node.js">

```javascript
const { Config, ContentContext, OAuth } = require('longbridge')

async function main() {
  const oauth = await OAuth.build("your-client-id", (_, url) => { console.log("Open this URL to authorize: " + url) })
  const config = Config.fromOAuth(oauth)
  const ctx = ContentContext.new(config)

  // 長文（Markdown，標題必填）
  const resp = await ctx.createTopic({
    title: "我的分析",
    body: "**看好** 700.HK，因為...",
    topicType: "article",
    tickers: ["700.HK"],
  })
  console.log(resp)
}
main().catch(console.error)
```

  </TabItem>
  <TabItem value="java" label="Java">

```java
import com.longbridge.*;
import com.longbridge.content.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             ContentContext ctx = ContentContext.create(config)) {
            // 長文（Markdown，標題必填）
            CreateTopicOptions opts = new CreateTopicOptions("我的分析", "**看好** 700.HK，因為...")
                .setTopicType("article")
                .setTickers(new String[]{"700.HK"})
                .setLicense(1);
            OwnedTopic resp = ctx.createTopic(opts).get();
            System.out.println(resp);
        }
    }
}
```

  </TabItem>
  <TabItem value="rust" label="Rust">

```rust
use std::sync::Arc;
use longbridge::{oauth::OAuthBuilder, content::{ContentContext, CreateTopicOptions}, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open this URL to authorize: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = ContentContext::new(config);

    // 長文（Markdown，標題必填）
    let opts = CreateTopicOptions {
        title: "我的分析".to_string(),
        body: "**看好** 700.HK，因為...".to_string(),
        topic_type: Some("article".to_string()),
        tickers: Some(vec!["700.HK".to_string()]),
        hashtags: None,
        license: Some(1),
    };
    let resp = ctx.create_topic(opts).await?;
    println!("{:?}", resp);
    Ok(())
}
```

  </TabItem>
  <TabItem value="cpp" label="C++">

```cpp
#include <iostream>
#include <longbridge.hpp>

#ifdef WIN32
#include <windows.h>
#endif

using namespace longbridge;
using namespace longbridge::content;

static void
run(const OAuth& oauth)
{
    Config config = Config::from_oauth(oauth);
    ContentContext ctx = ContentContext::create(config);

    // 長文（Markdown，標題必填）
    CreateTopicOptions opts;
    opts.title = "我的分析";
    opts.body = "**看好** 700.HK，因為...";
    opts.topic_type = "article";
    opts.tickers = {"700.HK"};

    ctx.create_topic(opts, [](auto res) {
        if (!res) { std::cout << "failed: " << *res.status().message() << std::endl; return; }
        std::cout << "created topic: " << res->id << std::endl;
    });
}

int main(int argc, char const* argv[]) {
#ifdef WIN32
    SetConsoleOutputCP(CP_UTF8);
#endif

    const std::string client_id = "your-client-id";
    OAuthBuilder(client_id).build(
    [](const std::string& url) {
        std::cout << "Open this URL to authorize: " << url << std::endl;
    },
    [](auto res) {
        if (!res) {
            std::cout << "authorization failed: " << *res.status().message() << std::endl;
            return;
        }
        run(*res);
    });

    std::cin.get();
    return 0;
}
```

  </TabItem>
  <TabItem value="go" label="Go">

```go
package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longbridge/openapi-go/config"
	"github.com/longbridge/openapi-go/oauth"
	"github.com/longbridge/openapi-go/content"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	ctx, err := content.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	// 長文（Markdown，標題必填）
	opts := content.CreateTopicOptions{
		Title:     "我的分析",
		Body:      "**看好** 700.HK，因為...",
		TopicType: "article",
		Tickers:   []string{"700.HK"},
	}
	resp, err := ctx.CreateTopic(context.Background(), opts)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("created topic: %s\n", resp.ID)
}
```

  </TabItem>
</Tabs>

## Response

### Response Headers

- Content-Type: application/json

### Response Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "item": {
      "id": "39304657",
      "title": "我對蘋果的看法",
      "topic_type": "article",
      "tickers": ["AAPL.US"],
      "hashtags": ["earnings"],
      "created_at": "1742000000"
    }
  }
}
```

### Response Status

| Status | Description | Schema                                                |
| ------ | ----------- | ----------------------------------------------------- |
| 200    | 返回成功    | [create_topic_response](#schemacreate_topic_response) |
| 403    | 權限不足    | 用戶未開戶或無資產                                    |
| 429    | 頻率超限    | 超過每分鐘或每日創建上限，請稍後重試                  |
| 500    | 內部錯誤    | None                                                  |

## Schemas

### create_topic_response

<a id="schemacreate_topic_response"></a>

| Name                | Type     | Required | Description                            |
| ------------------- | -------- | -------- | -------------------------------------- |
| item                | object   | true     | 新建討論詳情                           |
| ∟ id                | string   | true     | 討論 ID                                |
| ∟ title             | string   | false    | 標題                                   |
| ∟ description       | string   | false    | 純文本摘要（由正文自動截取）           |
| ∟ body              | string   | false    | 完整正文（`article` 類型為 Markdown）  |
| ∟ topic_type        | string   | false    | 內容類型，`article` 或 `post`          |
| ∟ tickers           | string[] | false    | 關聯標的代碼                           |
| ∟ hashtags          | string[] | false    | 討論標籤名稱列表                       |
| ∟ images            | object[] | false    | 附圖列表                               |
| ∟∟ url              | string   | false    | 原始圖片 URL                           |
| ∟∟ sm               | string   | false    | 小縮略圖 URL                           |
| ∟∟ lg               | string   | false    | 大縮略圖 URL                           |
| ∟ likes_count       | int32    | false    | 點讚數                                 |
| ∟ comments_count    | int32    | false    | 回覆數                                 |
| ∟ views_count       | int32    | false    | 瀏覽數                                 |
| ∟ shares_count      | int32    | false    | 分享數                                 |
| ∟ detail_url        | string   | false    | 討論頁面直鏈                           |
| ∟ author            | object   | false    | 作者信息                               |
| ∟∟ member_id        | string   | false    | 作者 member ID                         |
| ∟∟ name             | string   | false    | 作者暱稱                               |
| ∟∟ avatar           | string   | false    | 作者頭像 URL                           |
| ∟ created_at        | string   | true     | 創建時間，Unix 時間戳（秒）            |
| ∟ updated_at        | string   | false    | 最近更新時間，Unix 時間戳（秒）        |