# 創建討論

`POST` `/v1/content/topics`

在 [社區](https://longbridge.com/topics) 創建一篇新討論。支持兩種內容類型：

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

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

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

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

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

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

## Parameters

### Request Body

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

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/content/topics' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"title":"<title>","body":"<body>","topic_type":"<topic_type>","tickers":[],"hashtags":[]}'
```

## Response

### Response Properties

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

### Response JSON Example

```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"
    }
  }
}
```
